diff --git a/docs/faq/models.txt b/docs/faq/models.txt
index d34a26a82e..4a83aa9f2c 100644
--- a/docs/faq/models.txt
+++ b/docs/faq/models.txt
@@ -40,18 +40,15 @@ Yes. See :doc:`Integrating with a legacy database `.
If I make changes to a model, how do I update the database?
-----------------------------------------------------------
-If you don't mind clearing data, your project's ``manage.py`` utility has an
-option to reset the SQL for a particular application::
-
- manage.py reset appname
-
-This drops any tables associated with ``appname`` and recreates them.
+If you don't mind clearing data, your project's ``manage.py`` utility has a
+:djadmin:`flush` option to reset the database to the state it was in
+immediately after :djadmin:`syncdb` was executed.
If you do care about deleting data, you'll have to execute the ``ALTER TABLE``
statements manually in your database.
There are `external projects which handle schema updates
-`_, of which the current
+`_, of which the current
defacto standard is `south `_.
Do Django models support multiple-column primary keys?
diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
index 360c0ae4d3..8fea699c1b 100644
--- a/docs/ref/django-admin.txt
+++ b/docs/ref/django-admin.txt
@@ -224,8 +224,8 @@ flush
.. django-admin:: flush
-Returns the database to the state it was in immediately after syncdb was
-executed. This means that all data will be removed from the database, any
+Returns the database to the state it was in immediately after :djadmin:`syncdb`
+was executed. This means that all data will be removed from the database, any
post-synchronization handlers will be re-executed, and the ``initial_data``
fixture will be re-installed.