summaryrefslogtreecommitdiff
path: root/docs/topics/db/managers.txt
AgeCommit message (Collapse)Author
2025-08-25Refs #36485 -- Rewrapped docs to 79 columns line length.David Smith
Lines in the docs files were manually adjusted to conform to the 79 columns limit per line (plus newline), improving readability and consistency across the content.
2025-04-27Fixed #36335 -- Fixed typo in docs/topics/db/managers.txt.dbogar89
2024-02-01Fixed typo in docs/topics/db/managers.txt.Ebram Shehata
2023-08-30 Fixed #31262 -- Added support for mappings on model fields and ↵Nick Pope
ChoiceField's choices.
2023-03-01Fixed #34140 -- Reformatted code blocks in docs with blacken-docs.django-bot
2023-02-10Refs #34140 -- Applied rst code-block to non-Python examples.Carlton Gibson
Thanks to J.V. Zammit, Paolo Melchiorre, and Mariusz Felisiak for reviews.
2021-01-28Modernized custom manager exampleAdam Johnson
Since this example was added 15 years ago in a8ccdd0fcd631e8e928ef20547e1fe3e313dc607, the ORM has gained the ability to do the `COUNT(*)` related query, so do it with the ORM to avoid misleading users that raw SQL is only supported from manager methods.
2020-05-04Refs #30573 -- Rephrased "Of Course" and "Obvious(ly)" in documentation and ↵Adam Johnson
comments.
2020-03-10Fixed #27865 -- Adjusted docs example to avoid confusion with ↵Adam Radwon
models.BaseManager.
2020-03-06Fixed #31342 -- Clarified docs about using base managers for related objects.Carlton Gibson
2020-01-06Removed "Don't do that" from docs and error messages.Adam Johnson
It's slightly aggressive and doesn't explain itself.
2019-09-06Fixed #30573 -- Rephrased documentation to avoid words that minimise the ↵Tobias Kunze
involved difficulty. This patch does not remove all occurrences of the words in question. Rather, I went through all of the occurrences of the words listed below, and judged if they a) suggested the reader had some kind of knowledge/experience, and b) if they added anything of value (including tone of voice, etc). I left most of the words alone. I looked at the following words: - simply/simple - easy/easier/easiest - obvious - just - merely - straightforward - ridiculous Thanks to Carlton Gibson for guidance on how to approach this issue, and to Tim Bell for providing the idea. But the enormous lion's share of thanks go to Adam Johnson for his patient and helpful review.
2019-05-15Changed tuple choices to list in docs.Jon Dufresne
2018-04-11Fixed typo in docs/topics/db/managers.txt.Luoxzhg
2017-01-25Refs #23919 -- Replaced super(ClassName, self) with super() in docs.chillaranand
2017-01-17Removed versionadded/changed annotations for 1.10.Tim Graham
2017-01-11Fixed typo in docs/topics/db/managers.txt.M Somerville
2016-09-07Fixed #27172 -- Closed database cursor explicitly in two doc examplesChris Jerdonek
2016-08-16Fixed #19222 -- Documented that default managers aren't used for related ↵Tim Graham
queries.
2016-06-20Fixed typo in docs/topics/db/managers.txtTim Graham
2016-05-17Fixed #10506, #13793, #14891, #25201 -- Introduced new APIs to specify ↵Loïc Bistuer
models' default and base managers. This deprecates use_for_related_fields. Old API: class CustomManager(models.Model): use_for_related_fields = True class Model(models.Model): custom_manager = CustomManager() New API: class Model(models.Model): custom_manager = CustomManager() class Meta: base_manager_name = 'custom_manager' Refs #20932, #25897. Thanks Carl Meyer for the guidance throughout this work. Thanks Tim Graham for writing the docs.
2016-05-17Fixed #20932, #25897 -- Streamlined manager inheritance.Loïc Bistuer
2016-02-01Fixed #26124 -- Added missing code formatting to docs headers.rowanv
2015-11-27Fixed a typo in the managers docs.James Beith
2015-08-11Fixed #25205 -- Removed doc references to deprecated GeoManager class.Brendan Hayward
2015-07-27Fixed #21127 -- Started deprecation toward requiring on_delete for ↵Flavio Curella
ForeignKey/OneToOneField
2015-02-01Removed versionadded/changed notes for 1.7.Tim Graham
2014-10-06Fixed #23597 -- Clarified the manager that ↵Ismail Badawi
{Single,Multiple}ObjectMixin.model uses.
2014-09-29Fixed typo in docs/topics/db/managers.txtGreg Brown
2014-07-02Removed non-existent reference to args/kwargs in manager docs.Éric Araujo
2014-03-24Removed versionadded/changed annotations for 1.6.Tim Graham
2014-02-05Fixed gendered examples in the docs.Loic Bistuer
2013-12-04Fixing manager documentation inaccuracyFrank Wiles
2013-08-15Fixed some ReST errors regarding backticksTim Graham
2013-08-06Fixed #20852 - Fixed incorrectly generated left quotes in docs.Dominic Rodger
Sphinx generates left single quotes for apostrophes after code markup, when right single quotes are required. The easiest way to fix this is just by inserting the unicode character for a right single quote. Instances of the problem were found by looking for ">‘" in the generated HTML.
2013-07-26Fixed #20625 -- Chainable Manager/QuerySet methods.Loic Bistuer
Additionally this patch solves the orthogonal problem that specialized `QuerySet` like `ValuesQuerySet` didn't inherit from the current `QuerySet` type. This wasn't an issue until now because we didn't officially support custom `QuerySet` but it became necessary with the introduction of this new feature. Thanks aaugustin, akaariai, carljm, charettes, mjtamlyn, shaib and timgraham for the reviews.
2013-05-18Add missing imports and models to the examples in the the model layer ↵Marc Egli
documentation
2013-04-20Adapted uses of versionchanged/versionadded to the new form.Juan Catalano
Refs #20104.
2013-03-31Fixed #20168 - Generalized a PostgreSQL specific database query in the docs.Tim Graham
Thanks Russ for the suggestion.
2013-03-30Fixed #20150 -- Fixed an error in manager doc exampleNimesh Ghelani
2013-03-22Added missing markup to docs.Tim Graham
2013-03-08Fixed #15363 -- Renamed and normalized to `get_queryset` the methods that ↵Loic Bistuer
return a QuerySet.
2012-12-15Fixed #19384 -- Documented the behavior of custom managers on abstract models.Russell Keith-Magee
This documents the behavior introduced by cc337a74, which is BACKWARDS INCOMPATIBLE for any attempt to invoke a method on a manager using the abstract class as the calling class (e.g., AbstractBase.objects.do_something()) Thanks to mhsparks for the report.
2011-10-14Fixed many more ReST indentation errors, somehow accidentally missed from ↵Luke Plant
[16955] git-svn-id: http://code.djangoproject.com/svn/django/trunk@16983 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-06-04Fixed #16145 - typo in manager docs; thanks leereilly.Timo Graham
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16324 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-01-16Fixed #15062 -- Documented the fact that managers must be able to be shallow ↵Russell Keith-Magee
copied. Thanks to Ian Clelland for the report, and Łukasz Rekucki for the help diagnosing the problem. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15220 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2011-01-03Fixed #15002 - Fix title casing to conform to style guidelines. thanks adamv.Timo Graham
git-svn-id: http://code.djangoproject.com/svn/django/trunk@15135 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-08-19Fixed #14141: docs now use the :doc: construct for links between documents.Jacob Kaplan-Moss
Thanks, Ramiro Morales. git-svn-id: http://code.djangoproject.com/svn/django/trunk@13608 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-08-04Fixed #13746: made the dumdata help message a bit clearer. Thanks, PaulM.Jacob Kaplan-Moss
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13469 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2010-04-06Fixed #13035 - Incorrect documentation regarding admin and default managersLuke Plant
Thanks to rasca for report and gabrielhurley for patch git-svn-id: http://code.djangoproject.com/svn/django/trunk@12930 bcc190cf-cafb-0310-a4f2-bffc1f526a37