mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2024-12-26 19:16:11 +00:00
Code Issues 27 Releases Wiki Activity
13,251 Commits 28 Branches 426 Tags 667 MiB
3f65f751a0
Commit Graph

261 Commits

Author SHA1 Message Date
Jacob Kaplan-Moss
47e3cc74d9 Slight fixes to related fields reference to avoid conflicting target names 
with the queryset docs.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@13272 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-05-17 16:32:37 +00:00
Russell Keith-Magee
b160e1c172 Fixed #12997 -- Corrected the module markup for QuerySet methods. Thanks to timo for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13235 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-05-11 14:12:08 +00:00
Russell Keith-Magee
b34edc76eb Fixed #12678 -- Corrected a few references to Queryset into QuerySet. Thanks to ChrisMorgan for the report, and timo for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13211 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-05-10 13:14:19 +00:00
Russell Keith-Magee
819f43f499 Fixed #12229 -- Added documentation of the FieldFile methods that are exposed by FileField and ImageField. Thanks to Gabriel Hurley for the draft patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13202 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-05-10 12:29:04 +00:00
Russell Keith-Magee
55d65d3351 Fixed #12997 -- Added markup for methods in the queryset docs. Thanks to Ramiro Morales for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13162 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-05-09 05:48:45 +00:00
Russell Keith-Magee
4a15dc4509 Fixed #13100 -- Clarified the model validation rules around full_clean(). Thanks to ptone for the draft text. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13160 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-05-09 05:47:35 +00:00
Russell Keith-Magee
ccf5bb1883 Fixed #13282 -- Clarified documentation around week_day filtering in querysets. Thanks to wangchun, Ramiro Morales and timo. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13155 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-05-09 04:50:00 +00:00
Russell Keith-Magee
e7e46d1f4b Fixed #13455 -- Clarified the interaction of values() and extra(). Thanks to Rupe for the report and draft text. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13145 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-05-09 04:24:21 +00:00
Luke Plant
97b9c7582b Fixed #13099 - incorrect SQL for exclude() example 
Thanks to istruble for the report.



git-svn-id: http://code.djangoproject.com/svn/django/trunk@12936 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-04-06 14:35:36 +00:00
Justin Bronn
d58020fce8 Fixed fieldlookup docs cross-reference directive, and added it to the queryset reference. Refs #12930. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12808 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-03-20 05:04:31 +00:00
Malcolm Tredinnick
1eee40234b Fixed #11711 -- clarified that ValuesQuerySets are not lists per se. 
It rarely hurts to think of the returned result from a values() or
values_list() call as a list, but it's really an iterable and sometimes
the difference matters.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@12743 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-03-10 03:41:41 +00:00
Karen Tracey
f2bc4dd0a9 Fixed #12024: Changed admin code to avoid raising an exception when a field listed 
in raw_id_fields has limit_choices_to specified as a Q object. 

Tweaked a test to trigger the condition and verify the fix. 

Finally, documented that limit_choices_to specified as a Q object has no effect 
on the choices available for fields listed in raw_id_fields, and removed another 
incorrect note that claimed limit_choices_to had no effect on inlines in the admin.



git-svn-id: http://code.djangoproject.com/svn/django/trunk@12728 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-03-08 18:32:24 +00:00
Joseph Kocherhans
16fe73d918 Fixed #7190. Boolean fields now return bool values instead of 1 or 0. Thanks, Alex Gaynor. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12578 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-02-24 17:36:18 +00:00
Russell Keith-Magee
d792737770 Fixed #12538 -- Added a note that pickles aren't stable during version updates. Thanks to snow0x2d0 for the suggestion. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12560 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-02-24 13:56:19 +00:00
Russell Keith-Magee
a555df4c06 Fixed #12837 -- Clarified the naming strategy for m2m intermediate tables. Thanks to Ramiro Morales for the report and patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12516 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-02-23 13:21:07 +00:00
Jannis Leidel
579e8573c8 Fixed #12620 - Refer to better fieldname in defer docs. Thanks, dwillis. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12462 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-02-21 23:39:08 +00:00
Russell Keith-Magee
58cd220f51 Fixed #7270 -- Added the ability to follow reverse OneToOneFields in select_related(). Thanks to George Vilches, Ben Davis, and Alex Gaynor for their work on various stages of this patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12307 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-27 13:30:29 +00:00
Luke Plant
2e9518bb39 Created a 'DB optimization' topic, with cross-refs to relevant sections. 
Also fixed #10291, which was related, and cleaned up some inconsistent doc labels.



git-svn-id: http://code.djangoproject.com/svn/django/trunk@12229 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-16 03:13:16 +00:00
Jannis Leidel
f56f6e9405 Fixed #9326 - Use decorator syntax in get_absolute_url example. Thanks, timo. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12222 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-12 23:37:07 +00:00
Joseph Kocherhans
c4ad3dede1 Fixed #12586. Corrected a typo in the validation docs. Thanks, phyfus. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12209 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-12 14:04:04 +00:00
Joseph Kocherhans
2f9853b2dc Fixed #12512. Changed ModelForm to stop performing model validation on fields that are not part of the form. Thanks, Honza Kral and Ivan Sagalaev. 
This reverts some admin and test changes from [12098] and also fixes #12507, #12520, #12552 and #12553.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@12206 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-12 02:29:45 +00:00
Adrian Holovaty
cc25361b17 Fixed #12271 -- Fixed typo in URLField docs. Thanks, adam@andyet.net 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12184 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-10 18:42:30 +00:00
Adrian Holovaty
ddd6f28cac Fixed #10947 -- Fixed error in __in documentation. Thanks, julianb and timo 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12163 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-10 17:25:44 +00:00
Adrian Holovaty
665ac8779b Fixed #10862 -- Clarified confusing documentation about ImageField height/width. Thanks, mw and timo 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12162 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-10 17:23:59 +00:00
Adrian Holovaty
df9adbafb7 Fixed #12512 -- Fixed typo in docs/ref/models/fields.txt. Thanks, bward1 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12128 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-09 19:09:46 +00:00
Adrian Holovaty
e21d3af940 Fixed #12555 -- Fixed typo in docs/ref/models/querysets.txt. Thanks, y_feldblum 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12126 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-09 19:08:03 +00:00
Adrian Holovaty
d8b7772fca Made some edits to the validation part of docs/ref/models/instances.txt 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12124 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-09 18:07:28 +00:00
Russell Keith-Magee
0e0b18229f Corrected the chronograph on my time machine. `using` argument was added in v1.2, not v1.1. Thanks to Ramiro Morales for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12120 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-08 00:43:14 +00:00
Russell Keith-Magee
96848352f9 Added using to the list of documented arguments for save() on a model; updated the docs to suggest using `*args, **kwargs` when implementing model save methods. Thanks to Jeff Croft for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12118 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-08 00:17:33 +00:00
Joseph Kocherhans
4d6c66d4d8 Added a note that full_validate will not be called automatically by model.save(). 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12103 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-05 06:35:33 +00:00
Joseph Kocherhans
cd7da17132 Added a section to the docs for discussing validators and updated a few links to point to it. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12101 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-05 06:18:41 +00:00
Joseph Kocherhans
471596fc1a Merged soc2009/model-validation to trunk. Thanks, Honza! 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12098 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-01-05 03:56:19 +00:00
Gary Wilson Jr
adb74a8f2e Fixed several broken and redirecting URLs in the documentation (fixes #12219, refs #12427). 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11994 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-12-26 06:37:26 +00:00
Gary Wilson Jr
c6fa4936b3 Fixed #9465 -- Simplified API Reference documentation titles for easier lookup and made first-level heading styles consistent. Thanks, adamnelson. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11990 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-12-26 03:44:21 +00:00
Gary Wilson Jr
39122c841f Fixed #12205 -- Corrected malformed reference links in the 1.1 and 1.1-alpha release notes, and corrected position of field lookup reference label. Thanks velmont and timo. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11988 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-12-26 00:55:06 +00:00
Luke Plant
a5af81f93f Improved documentation of when QuerySet.exists() and .count() are a genuine optimization. 
Also fixed a typo.



git-svn-id: http://code.djangoproject.com/svn/django/trunk@11960 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-12-22 17:32:30 +00:00
Russell Keith-Magee
ff60c5f9de Fixed #1142 -- Added multiple database support. 
This monster of a patch is the result of Alex Gaynor's 2009 Google Summer of Code project.
Congratulations to Alex for a job well done.

Big thanks also go to:
 * Justin Bronn for keeping GIS in line with the changes,
 * Karen Tracey and Jani Tiainen for their help testing Oracle support
 * Brett Hoerner, Jon Loyens, and Craig Kimmerer for their feedback.
 * Malcolm Treddinick for his guidance during the GSoC submission process.
 * Simon Willison for driving the original design process
 * Cal Henderson for complaining about ponies he wanted.

... and everyone else too numerous to mention that helped to bring this feature into fruition.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@11952 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-12-22 15:18:51 +00:00
Karen Tracey
5bd63663a9 Fixed #399: Added big integer field. Thanks to Tomáš Kopeček for persistently maintaining a patch for this. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11887 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-12-17 15:10:38 +00:00
Russell Keith-Magee
c8514b570b Fixed #12204 -- Corrected the use of :djadmin: links in the testing docs, plus updated a lot of old-style markup in the django-admin docs. Thanks to Art_S for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11734 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-11-12 13:58:32 +00:00
Jacob Kaplan-Moss
b79702b2de Fixed #11402: added a QuerySet.exists() method. Thanks, Alex Gaynor. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11646 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-10-24 00:28:39 +00:00
Luke Plant
055efb2530 Fixed #9674 - documented app_label. 
Thanks to andymckay for the report and jpaulett for the patch.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@11596 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-09-28 21:58:21 +00:00
James Bennett
4a2a0b0e21 Fixed #11931: Removed mention of nonexistent get_sql() method for arguments to limit_choices_to. Since the correct reference involves undocumented ORM internals, this simply removes the reference entirely in favor of publicly-documented use of Q objects. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11591 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-09-23 23:40:12 +00:00
Russell Keith-Magee
423b5c1e14 Fixed #6047 -- Minor correction to the documentation regarding regex field lookups. Thanks to Richard D. Worth for the suggestion, and Steve Holden for the text. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11541 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-09-12 23:36:00 +00:00
Russell Keith-Magee
9aef7dd9e7 Fixed #11592 -- Corrected the grammar in the queryset docs. Thanks to Shannon Bradshaw for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11539 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-09-12 22:59:41 +00:00
Russell Keith-Magee
b2f72fc040 Fixed #11527 -- Added unit tests and documentation for the use of F() expressions in single object updates. Thanks to Zachary Voase for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11322 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-07-24 13:38:36 +00:00
Russell Keith-Magee
6f25903a89 Fixed #11235 -- Added a missing clause from some sample SQL in the queryset docs. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11239 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-07-15 13:56:50 +00:00
Russell Keith-Magee
bbd7b64e76 Fixed #11354 -- Remove stray whitespace in queryset docs. Thanks to flebel for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11094 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-06-24 14:01:36 +00:00
Russell Keith-Magee
992ded1ad1 Fixed #9919 -- Added note on the need to mark transactions as dirty when using raw SQL. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@11022 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-06-17 13:47:39 +00:00
Russell Keith-Magee
6c36d4c4f8 Fixed #10981 -- Clarified documentation regarding lazy cross-application relationships. Thanks to Ramiro for the suggestion. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10971 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-06-10 12:45:29 +00:00
Jacob Kaplan-Moss
c00e8d2064 Added a QuerySet.ordered property to check if a queryset is already ordered. Refs #10163. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10623 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-04-22 22:16:19 +00:00
Russell Keith-Magee
83623d45c7 Fixed #10776 -- Added metadata targets for the contrib.admin docs, and used one of those targets to clarify the SlugField docs. Thanks to ernop for the suggestion, and timo for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10564 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-04-16 12:46:58 +00:00
Russell Keith-Magee
163bf995a5 Fixed #10812 -- Corrected typo in aggregation docs. Thanks to uzi for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10562 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-04-16 12:45:35 +00:00
Jacob Kaplan-Moss
c0ad626dca Fixed #10647: intermediary tables between two umanaged models are no longer created. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10455 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-04-09 15:03:31 +00:00
Jacob Kaplan-Moss
c6c25adf6d Fixed a whole bunch of small docs typos, errors, and ommissions. 
Fixes #8358, #8396, #8724, #9043, #9128, #9247, #9267, #9267, #9375, #9409, #9414, #9416, #9446, #9454, #9464, #9503, #9518, #9533, #9657, #9658, #9683, #9733, #9771, #9835, #9836, #9837, #9897, #9906, #9912, #9945, #9986, #9992, #10055, #10084, #10091, #10145, #10245, #10257, #10309, #10358, #10359, #10424, #10426, #10508, #10531, #10551, #10635, #10637, #10656, #10658, #10690, #10699, #19528.

Thanks to all the respective authors of those tickets.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@10371 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-04-03 18:30:54 +00:00
Jacob Kaplan-Moss
516051bfd2 A whole lotta documentation fixes: Fixes #8704, #8826, #8980, #9243, #9343, #9529, 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10303 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-31 23:34:03 +00:00
Gary Wilson Jr
b4f5655c86 Fixed #10553 -- Corrected several uses of URLconf in documentation and comments, according to the Django style guide. Based on patch from rduffield. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10256 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-31 16:07:07 +00:00
Gary Wilson Jr
7372ea159a Fixed #10389, #10501, #10502, #10540, #10562, #10563, #10564, #10565, #10568, #10569, #10614, #10617, #10619 -- Fixed several typos as well as a couple minor issues in the docs, patches from timo, nih, bthomas, rduffield, UloPe, and sebleier@gmail.com. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10242 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-31 07:01:01 +00:00
Gary Wilson Jr
ef933f1643 Fixed a few class references in the model field docs. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10207 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-30 19:54:27 +00:00
Gary Wilson Jr
78cbc3acfa Fixed #10076 -- Documented invalid arguments for FileField, based on patch from timo. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10204 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-30 19:31:50 +00:00
Gary Wilson Jr
8ed6b2b1d1 Fixed #9853 -- Added information to the model date/time fields to note the Python objects used to represent them. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10198 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-30 18:30:44 +00:00
Malcolm Tredinnick
6fa30faa79 Fixed #10574 -- Documented interaction between annotations and order_by. 
In the future, I'd like to fix this properly, but the current behavior
has the advantage of being consistent across the board (and changing it
everywhere is backwards-incompatible with documented functionality).

git-svn-id: http://code.djangoproject.com/svn/django/trunk@10172 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-25 09:05:38 +00:00
Russell Keith-Magee
cce822c0f5 Fixed #10329 -- Added link target for get_FOO_display, get_next_by_FOO, and get_previous_by_FOO. Thanks to rctay for the report, and timo for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10152 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-24 11:46:18 +00:00
Jacob Kaplan-Moss
4246c832b6 Added 1.1 beta release notes. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10130 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-23 23:25:03 +00:00
Gary Wilson Jr
10923b42b3 Corrected syntax typos in a couple of versionadded directives. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10112 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-21 15:28:51 +00:00
Malcolm Tredinnick
4eadcf45d4 Added some further clarification to the docs for Meta.managed. 
Not sure if any of these are noticed as omissions yet; it's too new.
Primarily trying to head off questions in the future.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@10107 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-20 23:15:27 +00:00
Malcolm Tredinnick
729c974e64 Fixed #10546 -- Fixed a docs typo noticed by carljm. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10093 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-19 22:46:49 +00:00
Malcolm Tredinnick
29050ef999 Fixed #5420 -- Added support for delayed loading of model fields. 
In extreme cases, some fields are expensive to load from the database
(e.g. GIS fields requiring conversion, or large text fields). This
commit adds defer() and only() methods to querysets that allow the
caller to specify which fields should not be loaded unless they are
accessed.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@10090 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-19 09:06:04 +00:00
Malcolm Tredinnick
96d5d434fa Added some documentation explaining "managed=False" vs. "proxy=True". 
These features look similar, but they're not identical. They can't be merged
into one (without requiring at least two Meta parameters anyway), so we've made
them have APIs that match their natural use-cases most easily.

Anyway, the documentation explains both the details and gives some simple to
follow rules.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@10089 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-19 09:04:19 +00:00
Malcolm Tredinnick
61a2708c41 Fixed #10356 -- Added pure-Python inheritance for models (a.k.a proxy models). 
Large portions of this are needed for #5420, so I implemented it fully.
Thanks to Ryan Kelly for an initial patch to get this started.

Refs #5420.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@10083 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-18 09:47:08 +00:00
Malcolm Tredinnick
b4dd4d4bb7 Fixed #3163 -- Add a "Meta.managed" option to models. 
This allows a model to be defined which is not subject to database table
creation and removal. Useful for models that sit over existing tables or
database views.

Thanks to Alexander Myodov, Wolfgang Kriesing and Ryan Kelly for the bulk of
this patch.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@10008 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-09 03:35:02 +00:00
Malcolm Tredinnick
98710a5a28 Made a couple of cross-references in the model fields documentaiton consistent. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@10007 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-09 03:33:54 +00:00
Ian Kelly
ad6ce1e6f9 Clarified documentation regarding Oracle's treatment of nulls and empty strings. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9976 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-03-05 20:21:22 +00:00
Russell Keith-Magee
0c2a5ebe97 Fixed #9347 -- Added an entry in the field reference for the verbose_name option. Thanks to marcoberi for the suggestion, and timo for the eventual patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9865 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-02-22 06:10:29 +00:00
Russell Keith-Magee
a50a188a62 Fixed #9939 -- Corrected minor error in model fields documentation. Thanks to seemant for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9864 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-02-22 06:09:54 +00:00
Russell Keith-Magee
e83f81de8c Clarified some documentation on the use of the aggregate() query modifier, following suggestions on IRC. Thanks to Tai Lee for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9844 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-02-17 10:17:29 +00:00
Karen Tracey
addd3df3bd Fixed #7672 -- Added a 'week_day' lookup type. Many thanks to Ross Poulton for the proposal and implementation on all built-in database backends.. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9818 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-02-08 05:08:06 +00:00
Malcolm Tredinnick
d579e716fe Fixed #9997 -- Fixed use of ValuesQuerySets as rvalues in filters. 
Previous behaviour was pretty stupid. Let's never speak of it again. New
behaviour both works and is documented.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@9759 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-01-16 10:59:43 +00:00
Russell Keith-Magee
1a87e01f21 Corrected some ReST problems with the aggregation docs. Thanks to James Bennett for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9743 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-01-15 12:13:17 +00:00
Russell Keith-Magee
cc4e4d9aee Fixed #3566 -- Added support for aggregation to the ORM. See the documentation for details on usage. 
Many thanks to:
 * Nicolas Lara, who worked on this feature during the 2008 Google Summer of Code.
 * Alex Gaynor for his help debugging and fixing a number of issues.
 * Justin Bronn for his help integrating with contrib.gis.
 * Karen Tracey for her help with cross-platform testing.
 * Ian Kelly for his help testing and fixing Oracle support.
 * Malcolm Tredinnick for his invaluable review notes.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@9742 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-01-15 11:06:34 +00:00
Malcolm Tredinnick
3b489b7742 Documented that case-insensitive matching is not supported for non-ASCII 
strings in SQLite. Refs #9905.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@9705 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-01-06 03:34:47 +00:00
Malcolm Tredinnick
f747b61c20 Nested query support. 
This extends previous functionality that allowed passing Query objects as the
rvals to filters. You can now pass QuerySets, which requires less poking at
opaque attributes. See the documentation of the "__in" lookup type for the
details.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@9701 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2009-01-05 11:47:48 +00:00
Malcolm Tredinnick
b58a260c56 Fixed #9431 -- Added extra validation for VARCHAR-based fields on MySQL. 
max_length > 255 and unique=True is not permitted. Based on a patch from
adamnelson.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@9650 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-12-16 06:43:18 +00:00
Malcolm Tredinnick
644ad9073f Fixed #9477 -- Removed and edited a bunch of references to "development 
version". Some were replaced with versionadded or versionchanged directives.
Other, more minor ones, were removed altogether.

Based on a patch from James Bennett.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@9454 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-11-15 05:51:25 +00:00
Karen Tracey
c483583023 Fixed #9497 - Doc typos. Many thanks ramiro. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9330 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-11-02 20:43:20 +00:00
Malcolm Tredinnick
032b7bc45e Fixed #9420 -- Fixed an exception type in the documentation of Queryset.get(). 
Based on a suggestion from daveyjoe.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@9257 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-10-24 07:15:52 +00:00
Malcolm Tredinnick
9900c87161 Fixed #9390 -- Restored some documentation about select_related() that was 
accidentally lost in the docs refactor.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@9256 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-10-24 07:15:07 +00:00
Malcolm Tredinnick
e0a09b7dac Fixed a couple of markup errors in the documentation. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9164 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-10-06 08:28:18 +00:00
James Bennett
73c0db8e42 Fixed #9255: Removed now-obsolete warning about the old semantics of __exact=None vs. __isnull=True 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9105 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-30 22:29:58 +00:00
Malcolm Tredinnick
4eb26b1659 Restored documentation about pickling QuerySets (and how to only pickle the 
details for the query, rather than the results) from r7499.

These were accidentally nuked in the docs refactor. We know who the offenders
were. They will be made to sit in the corner on the naughty mat for a while.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@9090 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-28 03:08:30 +00:00
Russell Keith-Magee
54f962c0bf Fixed #8967: Added documentation for the 'through' option on a many-to-many field in the fields reference documentation. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9083 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-22 11:07:35 +00:00
Simon Willison
f17f2bfd1f Re-added docs for QuerySet reverse() and all() methods, refs #9000 - thanks ramiro 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@9005 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-11 00:24:02 +00:00
Adrian Holovaty
1aa8449fb7 Fixed #9003 -- Fixed awkward wording in querysets.txt 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8996 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-10 03:57:52 +00:00
Jacob Kaplan-Moss
7c2e2d2b5e Added a note about queryset.query being opaque. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8955 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-03 21:47:57 +00:00
Jacob Kaplan-Moss
7b0b992a87 Fixed #8849: added some more "new in 1.0" flags. Thanks, ramiro. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8947 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-03 20:55:04 +00:00
Simon Willison
cd5a00b4e4 Fixed #8838 - two typos in model field docs. Thanks, arien 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8927 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-03 15:35:58 +00:00
Malcolm Tredinnick
fd1d986bb1 Fixed #8802 -- Documented MySQL's usage of 1/0 instead of True/False for model 
BooleanFields.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@8910 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-03 06:14:13 +00:00
Jacob Kaplan-Moss
bc768e2b47 A bunch of cleanups to file documentation. Along the way some references to the old file methods were removed - thanks, varikin. 
Fixes #8642.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@8862 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-02 17:33:51 +00:00
Jacob Kaplan-Moss
64a9469127 Fixed #8753: converted "new in ..." callouts to proper Sphinx "versionadded/versionchanged" directives. Thanks to Marc Fargas for all the heavy lifting here. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8843 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-02 03:40:42 +00:00
James Bennett
c7a10b677d Fixed #8786: Moved phone number field docs to localflavor 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8830 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-02 00:26:28 +00:00
Jacob Kaplan-Moss
3a18002bbd Fixed #8210 and #8664: moved USStateField and PhoneNumberField to django.contrib.localflavor.us. This is a backwards-incompatible change, albeit a minor one; just add an aditional import and go on your way. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8819 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-01 22:15:35 +00:00
James Bennett
b085ccce6c Fixed #8730: Incorporated (with minor changes) additions/enhancements to one-to-one docs 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8787 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-09-01 09:32:41 +00:00
James Bennett
78ca7a6c07 Fixed #8533: restored model inheritance docs, and updated one-to-one docs to match 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8757 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-08-31 10:13:32 +00:00
James Bennett
f2c80f93d9 Fixed #8658: Added cross-references to signals docs from Model.save() docs 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8755 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-08-31 09:03:18 +00:00
James Bennett
6ba55eee30 Fixed #8679: use full signature of Model.save() in docs and remove no-longer-used 'raw' argument 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8754 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-08-31 08:55:08 +00:00
Malcolm Tredinnick
2dba41056f Revived a bunch of missing documentation that got lost in the docs-refactor. 
This describes values_list(), the new cross-model order_by() syntax and the
effects of distinct(), values() and order_by() on each other.

Fixed #8634.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@8694 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-08-29 05:04:26 +00:00
Malcolm Tredinnick
d22ee35ee9 Fixed #8662 -- Fixed the documentation of Model.save() to match the real 
signature so that people overriding it will use the right signature.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@8689 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-08-29 01:44:15 +00:00
Malcolm Tredinnick
c181734fa1 Changed create() and get_or_create() to force an insert (not update an existing value). 
Backwards incompatible if you are using manually-specific primary key values
and relying on the previously documented behaviour that the new values would
always exist in the database (i.e. it would update the existing entry).

Fixed #8419.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@8670 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-08-28 17:18:05 +00:00
Russell Keith-Magee
5c43a0a43f Fixed #8406: Corrected some expected output to use repr format. Thanks to arien for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8658 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-08-28 13:40:20 +00:00
Gary Wilson Jr
c2ba59fc1d Removed oldforms, validators, and related code: 
* Removed `Manipulator`, `AutomaticManipulator`, and related classes.
 * Removed oldforms specific bits from model fields:
   * Removed `validator_list` and `core` arguments from constructors.
   * Removed the methods:
     * `get_manipulator_field_names`
     * `get_manipulator_field_objs`
     * `get_manipulator_fields`
     * `get_manipulator_new_data`
     * `prepare_field_objs_and_params`
     * `get_follow`
   * Renamed `flatten_data` method to `value_to_string` for better alignment with its use by the serialization framework, which was the only remaining code using `flatten_data`.
 * Removed oldforms methods from `django.db.models.Options` class: `get_followed_related_objects`, `get_data_holders`, `get_follow`, and `has_field_type`.
 * Removed oldforms-admin specific options from `django.db.models.fields.related` classes: `num_in_admin`, `min_num_in_admin`, `max_num_in_admin`, `num_extra_on_change`, and `edit_inline`.
 * Serialization framework
   * `Serializer.get_string_value` now calls the model fields' renamed `value_to_string` methods.
   * Removed a special-casing of `models.DateTimeField` in `core.serializers.base.Serializer.get_string_value` that's handled by `django.db.models.fields.DateTimeField.value_to_string`.
 * Removed `django.core.validators`:
   * Moved `ValidationError` exception to `django.core.exceptions`.
   * For the couple places that were using validators, brought over the necessary code to maintain the same functionality.
 * Introduced a SlugField form field for validation and to compliment the SlugField model field (refs #8040).
 * Removed an oldforms-style model creation hack (refs #2160).

git-svn-id: http://code.djangoproject.com/svn/django/trunk@8616 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-08-27 07:19:44 +00:00
Malcolm Tredinnick
f2b389b354 Added documentation to explain the gains and losses when using utf8_bin 
collation in MySQL. This should help people to make a reasonably informed
decision. Usually, leaving the MySQL collation alone will be the best solution,
but if you must change it, this gives a start to the information you need and
pointers to the appropriate place in the MySQL docs.

There's a small chance I also got all the necessary Sphinx markup correct, too
(it builds without errors, but I may have missed some chances for glory and
linkage).

Fixed #2335, #8506.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@8568 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-08-26 01:59:25 +00:00
Jacob Kaplan-Moss
97cb07c3a1 Massive reorganization of the docs. See the new docs online at http://docs.djangoproject.com/. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@8506 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2008-08-23 22:25:40 +00:00