Commit 21ea58b8 authored by Ramiro Morales's avatar Ramiro Morales
Browse files

Enhanced docs and docctrings added in 869c9ba3.

Thanks Claude for the suggestion.
parent 2edef932
Loading
Loading
Loading
Loading
+5 −4
Original line number Diff line number Diff line
@@ -151,10 +151,11 @@ class BaseCommand(object):
        Default value is ``False``.

        Make sure you know what you are doing if you decide to change the value
        of this option in your custom command because many of them create
        database content that is locale-sensitive (like permissions) and that
        content shouldn't contain any translations so making the locale differ
        from the de facto default 'en-us' can cause unintended effects.
        of this option in your custom command if it creates database content
        that is locale-sensitive and such content shouldn't contain any
        translations (like it happens e.g. with django.contrim.auth
        permissions) as making the locale differ from the de facto default
        'en-us' might cause unintended effects.

        This option can't be False when the can_import_settings option is set
        to False too because attempting to set the locale needs access to
+7 −7
Original line number Diff line number Diff line
@@ -118,7 +118,7 @@ Management commands and locales
===============================

By default, the :meth:`BaseCommand.execute` method sets the hardcoded 'en-us'
locale because most of the commands shipped with Django perform several tasks
locale because some commands shipped with Django perform several tasks
(for example, user-facing content rendering and database population) that
require a system-neutral string language (for which we use 'en-us').

@@ -237,11 +237,11 @@ All attributes can be set in your derived class and can be used in
  Default value is ``False``.

  Make sure you know what you are doing if you decide to change the value of
  this option in your custom command because many of them create database
  content that is locale-sensitive (like permissions) and that content
  shouldn't contain any translations so making the locale differ from the de
  facto default 'en-us' can cause unintended effects. See the `Management
  commands and locales`_ section above for further details.
  this option in your custom command if it creates database content that
  is locale-sensitive and such content shouldn't contain any translations (like
  it happens e.g. with django.contrim.auth permissions) as making the locale
  differ from the de facto default 'en-us' might cause unintended effects. See
  the `Management commands and locales`_ section above for further details.

  This option can't be ``False`` when the
  :data:`~BaseCommand.can_import_settings` option is set to ``False`` too
+7 −6
Original line number Diff line number Diff line
@@ -39,13 +39,14 @@ Minor features
  <lazy-plural-translations>` can be provided at translation time rather than
  at definition time.

* For custom managemente commands: Validation of the presence of valid settings
  in managements commands that ask for it by using the
* For custom management commands: Verification of the presence of valid
  settings in commands that ask for it by using the
  :attr:`~django.core.management.BaseCommand.can_import_settings` internal
  option is now performed independently from handling of the locale that should
  active during the execution of the command. The latter can now be influenced
  by the new :attr:`~django.core.management.BaseCommand.leave_locale_alone`
  internal option. See :ref:`management-commands-and-locales` for more details.
  option is now performed independently from handling of the locale that
  should be active during the execution of the command. The latter can now be
  influenced by the new
  :attr:`~django.core.management.BaseCommand.leave_locale_alone` internal
  option. See :ref:`management-commands-and-locales` for more details.

Backwards incompatible changes in 1.6
=====================================