Commit 862de0b2 authored by Tim Graham's avatar Tim Graham
Browse files

Fixed #25356 -- Removed default_app_config from startapp template. 

Also discouraged its use outside the intended use case.
parent 29d52583

django/conf/app_template/__init__.py

+0 −1
Original line number Diff line number Diff line 
default_app_config = '{{ app_name }}.apps.{{ camel_case_app_name }}Config'

docs/intro/tutorial02.txt

+3 −3
Original line number Diff line number Diff line
@@ -199,14 +199,14 @@ But first we need to tell our project that the ``polls`` app is installed. 
    Django installation.



Edit the :file:`mysite/settings.py` file again, and change the

:setting:`INSTALLED_APPS` setting to include the string ``'polls'``. So it'll

look like this:

:setting:`INSTALLED_APPS` setting to include the string

``'polls.apps.PollsConfig'``. It'll look like this:



.. snippet::

    :filename: mysite/settings.py



    INSTALLED_APPS = [

        'polls',

        'polls.apps.PollsConfig',

        'django.contrib.admin',

        'django.contrib.auth',

        'django.contrib.contenttypes',

docs/ref/applications.txt

+3 −1
Original line number Diff line number Diff line
@@ -81,7 +81,9 @@ subclass by default as follows:: 
That will cause ``RockNRollConfig`` to be used when :setting:`INSTALLED_APPS`

just contains ``'rock_n_roll'``. This allows you to make use of

:class:`~django.apps.AppConfig` features without requiring your users to

update their :setting:`INSTALLED_APPS` setting.

update their :setting:`INSTALLED_APPS` setting. Besides this use case, it's

best to avoid using ``default_app_config`` and instead specify the app config

class in :setting:`INSTALLED_APPS` as described next.



Of course, you can also tell your users to put

``'rock_n_roll.apps.RockNRollConfig'`` in their :setting:`INSTALLED_APPS`

docs/ref/settings.txt

+1 −1
Original line number Diff line number Diff line
@@ -1523,7 +1523,7 @@ Default: ``[]`` (Empty list) 
A list of strings designating all applications that are enabled in this

Django installation. Each string should be a dotted Python path to:



* an application configuration class, or

* an application configuration class (preferred), or

* a package containing an application.



:doc:`Learn more about application configurations </ref/applications>`.

docs/releases/1.9.txt

+1 −2
Original line number Diff line number Diff line
@@ -409,8 +409,7 @@ Management Commands 
* The :djadmin:`createcachetable` command now has a ``--dry-run`` flag to

  print out the SQL rather than execute it.



* The :djadmin:`startapp` command creates an ``apps.py`` file and adds

  ``default_app_config`` in ``__init__.py``.

* The :djadmin:`startapp` command creates an ``apps.py`` file.



* When using the PostgreSQL backend, the :djadmin:`dbshell` command can connect

  to the database using the password from your settings file (instead of