Commit f8297f63 authored by Andrew Godwin's avatar Andrew Godwin
Browse files

More migration docs, and conversion of all easy syncdb references

parent 06103c8e

docs/howto/legacy-databases.txt

+2 −2
Original line number Diff line number Diff line
@@ -81,10 +81,10 @@ access to your precious data on a model by model basis. 
Install the core Django tables

==============================



Next, run the :djadmin:`syncdb` command to install any extra needed database

Next, run the :djadmin:`migrate` command to install any extra needed database

records such as admin permissions and content types::



    python manage.py syncdb

    python manage.py migrate



Test and tweak

==============

docs/internals/contributing/writing-documentation.txt

+2 −2
Original line number Diff line number Diff line
@@ -165,9 +165,9 @@ __ http://sphinx.pocoo.org/markup/desc.html 


* ``django-admin`` commands::



        .. django-admin:: syncdb

        .. django-admin:: migrate



  To link, use ``:djadmin:`syncdb```.

  To link, use ``:djadmin:`migrate```.



* ``django-admin`` command-line options::

docs/intro/overview.txt

+4 −3
Original line number Diff line number Diff line
@@ -53,10 +53,11 @@ automatically: 


.. code-block:: bash



    manage.py syncdb

    manage.py migrate



The :djadmin:`syncdb` command looks at all your available models and creates

tables in your database for whichever tables don't already exist.

The :djadmin:`migrate` command looks at all your available models and creates

tables in your database for whichever tables don't already exist, as well as

optionally providing :doc:`much richer schema control </topics/migrations>`.



Enjoy the free API

==================

docs/intro/reusable-apps.txt

+1 −1
Original line number Diff line number Diff line
@@ -155,7 +155,7 @@ this. For a small app like polls, this process isn't too difficult. 


          url(r'^polls/', include('polls.urls')),



    3. Run `python manage.py syncdb` to create the polls models.

    3. Run `python manage.py migrate` to create the polls models.



    4. Start the development server and visit http://127.0.0.1:8000/admin/

       to create a poll (you'll need the Admin app enabled).

docs/man/django-admin.1

+4 −5
Original line number Diff line number Diff line
@@ -45,8 +45,7 @@ Outputs to standard output all data in the database associated with the named 
application(s).

.TP

.BI flush

Returns the database to the state it was in immediately after syncdb was

executed.

Removes all data from the database and then re-installs any initial data.

.TP

.B inspectdb

Introspects the database tables in the database specified in settings.py and outputs a Django
@@ -114,9 +113,9 @@ the current directory or the optional destination. 
Creates a Django project directory structure for the given project name

in the current directory or the optional destination.

.TP

.BI syncdb

Creates the database tables for all apps in INSTALLED_APPS whose tables

haven't already been created.

.BI migrate

Runs migrations for apps containing migrations, and just creates missing tables

for apps without migrations.

.TP

.BI "test [" "\-\-verbosity" "] [" "\-\-failfast" "] [" "appname ..." "]"

Runs the test suite for the specified applications, or the entire project if