mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2024-12-27 03:25:58 +00:00
Code Issues 27 Releases Wiki Activity
26,469 Commits 28 Branches 426 Tags 668 MiB
217f4456d8
Commit Graph

324 Commits

Author SHA1 Message Date
Aymeric Augustin
7ee7599ab3 Removed versionadded/changed annotations dating back to 1.4. 2012-12-29 21:59:08 +01:00
Tim Graham
b3a8c9dab8 Fixed broken links, round 3. refs #19516 2012-12-26 19:07:22 -05:00
Tim Graham
9c5a6adf33 Fixed more broken links. refs #19516 2012-12-25 04:44:09 -05:00
Tim Graham
71a3162a70 Documented behavior of get_or_create when multiple objects are returned. 
Thanks Matt Lauber for the patch.
 2012-11-22 10:36:18 -05:00
Anton Danilchenko
76859e6eab Update docs/ref/models/querysets.txt 
Fix typo: replace "can can" to "can"
 2012-11-18 18:46:39 +02:00
Preston Holmes
965cc0b1ff Deprecated depth kwarg on select_related. 
This is the start of a deprecation path for the depth kwarg on
select_related. Removing this will allow us to update select_related so
it chains properly and have an API similar to prefetch_related.

Thanks to Marc Tamlyn for spearheading and initial patch.

refs #16855
 2012-11-02 22:03:33 -07:00
Tim Graham
2f722d9728 Fixed #13869 - Warned that QuerySet.iterator() doesn't affect DB driver caching; thanks jtiai for the suggestion. 2012-10-20 15:22:34 -04:00
Tim Graham
6d46c740d8 Fixed #17435 - Clarified that QuerySet.update returns the number of rows matched 2012-10-06 07:03:20 -04:00
Preston Holmes
ab696e3a21 Merge pull request #425 from Osmose/queryset_doc_typo 
Fixed typo in queryset docs under update method.
 2012-10-05 09:08:35 -07:00
Michael Kelly
074e65b04a Fixed typo in queryset docs under update method. 2012-10-05 11:32:28 -04:00
Anssi Kääriäinen
1cd6e04cd4 Fixed #18676 -- Allow fast-path deletion of objects 
Objects can be fast-path deleted if there are no signals, and there are
no further cascades. If fast-path is taken, the objects do not need to
be loaded into memory before deletion.

Thanks to Jeremy Dunck, Simon Charette and Alex Gaynor for reviewing
the patch.
 2012-09-28 18:16:08 +03:00
Tim Graham
837425b425 Fixed #18934 - Removed versionadded/changed annotations for Django 1.3 2012-09-20 19:06:55 -04:00
Preston Holmes
8d75b1176f Clearer wording for defer docs 2012-09-15 14:24:01 -07:00
Tim Graham
3bdb65dc59 Updated print statements to work with py3; thanks Claude Paroz noting this. 2012-09-08 15:15:10 -04:00
Tim Graham
d823bb790d Fixed #17156 -- Added documentation examples for exists() 
Thanks mrmagooey for the draft patch.
 2012-09-08 11:19:49 -04:00
Aymeric Augustin
e69348b4e7 Avoided mixing dates and datetimes in the examples. 
Refs #16023.
 2012-09-08 11:00:04 -04:00
Tim Graham
e5983af7c1 Fixed #18904 - Typo in MySQL link; thanks Johie Anderson for the report. 2012-09-05 17:50:17 -04:00
Andrei Antoukh
99321e30ce Fixed #18306 -- Made deferred models issue update_fields on save 
Deferred models now automatically update only the fields which are
loaded from the db (with .only() or .defer()). In addition, any field
set manually after the load is updated on save.
 2012-08-12 22:39:27 +03:00
Anssi Kääriäinen
29132ebdef Fixed #17788 -- Added batch_size argument to qs.bulk_create() 
The qs.bulk_create() method did not work with large batches together
with SQLite3. This commit adds a way to split the bulk into smaller
batches. The default batch size is unlimited except for SQLite3 where
the batch size is limited to 999 SQL parameters per batch.

Thanks to everybody who participated in the discussions at Trac.
 2012-07-17 15:24:41 +03:00
Aymeric Augustin
bbc590697a Removed Django 1.0-specific sections. 2012-07-07 16:44:55 +02:00
Anssi Kääriäinen
b6c356b7bb Fixed #17485 -- Made defer work with select_related 
This commit tackles a couple of issues. First, in certain cases there
were some mixups if field.attname or field.name should be deferred.
Field.attname is now always used.

Another issue tackled is a case where field is both deferred by
.only(), and selected by select_related. This case is now an error.

A lot of thanks to koniiiik (Michal Petrucha) for the patch, and
to Andrei Antoukh for review.
 2012-06-26 18:08:42 +03:00
Aymeric Augustin
c28e700c7e Removed references to changes made in 1.2. 
Thanks Florian Apolloner for the patch.
 2012-06-07 15:02:35 +02:00
Claude Paroz
596cb9c7e2 Replaced print statement by print function (forward compatibility syntax). 2012-04-30 20:45:03 +02:00
Julien Phalip
93d1fdb130 Fixed #17877 -- Ensured that extra WHERE clauses get correctly ANDed when they contain OR operations. Thanks to Marek Brzóska for the report, to eleather for the test case and to Adrien Lemaire for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17880 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2012-04-09 00:43:08 +00:00
Adrian Holovaty
dd246a62c7 Edited some docs and docstrings until [17685] 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17686 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2012-03-12 20:05:48 +00:00
Aymeric Augustin
cfd0cd1bc9 Documented a limit of the SQLite backend, in relation with the bulk_create function. Refs #17788. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17653 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2012-03-04 17:34:22 +00:00
Luke Plant
de9942a667 Fixed #17668 - prefetch_related does not work in in_bulk 
Thanks to gurets for the report, and akaariai for the initial patch.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@17600 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2012-02-28 19:34:04 +00:00
Aymeric Augustin
5b560ec0c0 Fixed a few typos in the aggregation functions reference. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17569 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2012-02-21 18:28:35 +00:00
Aymeric Augustin
f0d4676750 Fixed #10139 -- Clarified that slicing an evaluated QuerySet returns a list, not a QuerySet. Thanks ori for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17383 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2012-01-21 15:32:52 +00:00
Ramiro Morales
33f839b252 Moved misplaced documentation warning note about internal QuerySet query atribute. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17342 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2012-01-06 17:15:15 +00:00
Adrian Holovaty
d3ef13044e Edited doc changes from [17244] 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17302 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-12-30 18:01:34 +00:00
Ramiro Morales
287565779d Added support for modifying the effect of `DISTINCT` clauses so they 
only consider some fields (PostgreSQL only).

For this, the ``distinct()`` QuerySet method now accepts an optional
list of model fields names and generates ``DISTINCT ON`` clauses on
these cases. Thanks Jeffrey Gelens and Anssi Kääriäinen for their work.

Fixes #6422.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@17244 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-12-22 20:42:40 +00:00
Luke Plant
e954a03871 Added warning about the performance of large IN clauses in prefetch_related docs 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@17147 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-11-24 17:18:56 +00:00
Aymeric Augustin
9b1cb755a2 Added support for time zones. Thanks Luke Plant for the review. Fixed #2626. 
For more information on this project, see this thread:
http://groups.google.com/group/django-developers/browse_thread/thread/cf0423bbb85b1bbf



git-svn-id: http://code.djangoproject.com/svn/django/trunk@17106 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-11-18 13:01:06 +00:00
Gabriel Hurley
a71bd3e0c9 Corrected a reST formatting problem in the queryset reference docs. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16958 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-10-11 18:23:08 +00:00
Luke Plant
c61987d75a Removed use of non-standard indentation rules in docs, and the custom transform that supported them. 
Doc writers should be aware that we are now back to normal ReST rules
regarding blockquotes.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16955 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-10-10 17:32:33 +00:00
Luke Plant
af244e47cc Fixed a bunch of ReST errors that resulted in interpretation as block quotations 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16954 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-10-10 15:32:01 +00:00
Luke Plant
ac6361a3a6 Fixed some ReST errors in docs. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16945 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-10-08 18:07:30 +00:00
Luke Plant
052a011ee6 Fixed #17003 - prefetch_related should support foreign keys/one-to-one 
Support for `GenericForeignKey` is also included.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16939 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-10-07 16:05:53 +00:00
Luke Plant
662eea116f Fixed #16937 - added QuerySet.prefetch_related to prefetch many related objects. 
Many thanks to akaariai for lots of review and feedback, bug finding,
additional unit tests and performance testing.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16930 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-10-05 23:14:52 +00:00
Jannis Leidel
2eadc418af Fixed doc references to django.db.models.query.QuerySet and converted some tabs that were introduced in r16699 to spaces. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16915 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-09-30 10:28:39 +00:00
Jannis Leidel
2a2381a682 Added versionadded directive for the bulk_create Queryset method introduced in r16739. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16885 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-09-22 15:04:34 +00:00
Alex Gaynor
7deb25b8dd Fixed #7596. Added Model.objects.bulk_create, and make use of it in several places. This provides a performance benefit when inserting multiple objects. THanks to Russ for the review, and Simon Meers for the MySQl implementation. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16739 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-09-09 19:22:28 +00:00
Ramiro Morales
932b1b8d6d Converted links to external topics so they use intersphinx extension markup. 
This allows to make these links more resilent to changes in the target URLs.
Thanks Jannis for the report and Aymeric Augustin for the patch.

Fixes #16586.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16720 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-09-04 21:17:30 +00:00
Malcolm Tredinnick
4c8f2dca21 Extensive copy-editing and cross-referencing in the queryset API docs. 
Been meaning to do this for a long time. Mostly, this is a lot of
additions of cross references. Within a particular section about foo() I
didn't cross-link foo() calls to itself, but everything else was
cross-linked to its main documentation.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16699 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-08-27 02:56:18 +00:00
Julien Phalip
17ceb9b98a Fixed #16712 -- Fixed a small typo in the QuerySet API docs. Thanks to Rupe and Aymeric Augustin for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16698 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-08-26 23:37:07 +00:00
Malcolm Tredinnick
a4a250a296 Corrected explanation of values() and extra() interaction in querysets. 
Fixes #15546, refs #13455. The original documentation patch
inadvertently muddied the waters in one aspect and this commit tidies
that up.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16697 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-08-26 21:13:01 +00:00
Malcolm Tredinnick
4d21511961 Clarify the documentation around SQLite and case-sensitive string matching. 
This was still causing some confusion, so I rewrote the section in the
database notes to encompass both substring matching and non-ASCII
case-insensitive equality checks, as well as putting in a stronger
callout on the "contains" filter.

Refs #16569.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16694 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-08-26 08:42:38 +00:00
Malcolm Tredinnick
70e59aeaf8 Be very clear about when it's appropriate to use defer() and only(). 
I've been seeing a bit of over-reliance on defer() and only() in code
around the place and it's generally better modelled with normalised data
or shadow (unmanaged) models. This commit makes this position clearer.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16692 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-08-26 06:19:30 +00:00
Timo Graham
953fed1e30 Fixed #16580 - Typo in docs/ref/models/querysets.txt 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16582 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-08-06 18:49:58 +00:00
Karen Tracey
901ea8a68d s/get/filter in new example of how to use queryset update method: update won't work on a model instance. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16518 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-07-06 00:21:32 +00:00
Adrian Holovaty
471a841147 Added another bit to the update() queryset docs about avoiding race conditions 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16517 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-07-05 20:16:08 +00:00
Adrian Holovaty
8b34a01017 Improved update() docs in querysets.txt 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16516 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-07-05 20:09:00 +00:00
Simon Meers
5ecb88c146 Fixed #16014 -- numerous documentation typos -- thanks psmith. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16220 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-05-13 04:33:42 +00:00
Jacob Kaplan-Moss
8f0f73c7b8 Fixed #2705: added a select_for_update() clause to querysets. 
A number of people worked on this patch over the years -- Hawkeye, Colin Grady,
KBS, sakyamuni, anih, jdemoor, and Issak Kelly. Thanks to them all, and
apologies if I missed anyone.

Special thanks to Dan Fairs for picking it up again at the end and seeing this
through to commit.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16058 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-04-20 20:42:07 +00:00
Gabriel Hurley
409435440a Fixed #15558 -- Improved QuerySet reference docs and cleaned up numerous reST/sphinx problems. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15776 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-03-08 19:51:19 +00:00
Gabriel Hurley
319de16ff0 Fixed #15233 -- reST/Sphinx markup corrections in numerous areas, mostly centering around bad crossref targets. Thanks to Aryeh Leib Taurog for the draft patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15549 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-02-16 01:56:53 +00:00
Timo Graham
07ef43082d Fixed #15002 - Fix title casing to conform to style guidelines. thanks adamv. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15135 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2011-01-03 13:29:17 +00:00
Timo Graham
2ea93f9327 Fixed #14000 - remove versionadded/changed tags for Django 1.0 and 1.1 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15055 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-12-26 00:37:14 +00:00
Timo Graham
00f36e0ebf Fixed #9033 - Add bullets to QuerySet extra() arguments. thanks julien for the suggestion and dwillis for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14816 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-12-04 20:41:35 +00:00
Timo Graham
b31a956d57 Fixed #14758 - Remove entire method signatures from QuerySet headings - thanks adamv for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14737 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-11-28 18:15:40 +00:00
Carl Meyer
9b432cb67b Fixed #5768 -- Added support for ManyToManyFields and reverse relations in values() and values_list(). Thanks to mrmachine for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14655 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-11-21 02:28:25 +00:00
Carl Meyer
616b30227d Fixed #7539, #13067 -- Added on_delete argument to ForeignKey to control cascade behavior. Also refactored deletion for efficiency and code clarity. Many thanks to Johannes Dollinger and Michael Glassford for extensive work on the patch, and to Alex Gaynor, Russell Keith-Magee, and Jacob Kaplan-Moss for review. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14507 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-11-09 16:46:42 +00:00
Carl Meyer
3ba3294c6b Fixed #14599 -- Added documentation for QuerySet.delete() in the QuerySet API reference. Thanks to abeld for the report. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14505 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-11-09 16:33:48 +00:00
Gabriel Hurley
6400026feb Fixed #14004 -- Adds documentation for QuerySet.update() method. Thanks to dwillis and timo for the majority of the wording. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14074 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-10-09 10:00:13 +00:00
Russell Keith-Magee
a904e55859 Fixed #11509 -- Modified usage of "Web" to match our style guide in various documentation, comments and code. Thanks to timo and Simon Meers for the work on the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@14069 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-10-09 08:12:50 +00:00
Luke Plant
2422fbfc93 Fixed #13414 - QuerySet API ref wrong sql equivalent in __year lookup example 
Thanks to idle for report and patch



git-svn-id: http://code.djangoproject.com/svn/django/trunk@13692 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-09-07 20:43:19 +00:00
Luke Plant
c00f35ae0d Fixed #14185 - improved example SQL for 'select' example. 
Thanks to Trindaz for the suggestion.

Also fixed some references to 'lede' which is no longer part of the
example Blog model.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@13652 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-08-28 11:23:54 +00:00
Russell Keith-Magee
a323fd3c5e Fixed #14112 -- Various Markup fixes for the docs. Thanks to ramiro for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13628 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-08-23 08:07:35 +00:00
Jacob Kaplan-Moss
728effcfbd Fixed #14141: docs now use the :doc: construct for links between documents. 
Thanks, Ramiro Morales.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@13608 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-08-19 19:27:44 +00:00
Russell Keith-Magee
2dc2ed87e5 Fixed #11800 -- Updated Sphinx metadata in queryset docs. Thanks to timo for the patch. 
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13548 bcc190cf-cafb-0310-a4f2-bffc1f526a37
 2010-08-07 14:26:07 +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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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