Browse files

Added a man page for Also install it correctly as pa…

…rt of the

auto-generated rpm. Thanks to Marc Fargas and Paul Bissex for writing the man
page. Refs #3341.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
malcolmt committed Jun 10, 2007
1 parent ca6e4f3 commit b91226027e0719b2763c06965d9889387717691e
Showing with 167 additions and 0 deletions.
  1. +162 −0 docs/man/django-admin.1
  2. +5 −0 scripts/
@@ -0,0 +1,162 @@
+.TH "" "1" "June 2007" "Django Project" ""
+django\ \- Utility script for the Django web framework
+.B django\
+.I <action>
+.B [options]
+This utility script provides commands for creation and maintenance of Django
+projects and apps.
+With the exception of
+.BI startproject,
+all commands listed below can also be performed with the
+script found at the top level of each Django project directory.
+.BI "adminindex [" "appname ..." "]"
+Prints the admin\-index template snippet for the given app name(s).
+.BI "createcachetable [" "tablename" "]"
+Creates the table needed to use the SQL cache backend
+.B dbshell
+Runs the command\-line client for the current
+.B diffsettings
+Displays differences between the current
+and Django's default settings. Settings that don't appear in the defaults are
+followed by "###".
+.B inspectdb
+Introspects the database tables in the database specified in and outputs a Django
+model module.
+.BI "install [" "appname ..." "]"
+.B sqlall
+for the given app(s) in the current database.
+.BI "reset [" "appname ..." "]"
+.B sqlreset
+for the given app(s) in the current database.
+.BI "runfcgi [" "KEY=val" "] [" "KEY=val" "] " "..."
+Runs this project as a FastCGI application. Requires flup. Use
+.B runfcgi help
+for help on the KEY=val pairs.
+.BI "runserver [" "\-\-noreload" "] [" "\-\-adminmedia=ADMIN_MEDIA_PATH" "] [" "port|ipaddr:port" "]"
+Starts a lightweight Web server for development.
+.BI "shell [" "\-\-plain" "]"
+Runs a Python interactive interpreter. Tries to use IPython, if it's available.
+.BI \-\-plain
+option forces the use of the standard Python interpreter even when IPython is
+.BI "sql [" "appname ..." "]"
+Prints the CREATE TABLE SQL statements for the given app name(s).
+.BI "sqlall [" "appname ..." "]"
+Prints the CREATE TABLE, initial\-data and CREATE INDEX SQL statements for the
+given model module name(s).
+.BI "sqlclear [" "appname ..." "]"
+Prints the DROP TABLE SQL statements for the given app name(s).
+.BI "sqlindexes [" "appname ..." "]"
+Prints the CREATE INDEX SQL statements for the given model module name(s).
+.BI "sqlinitialdata [" "appname ..." "]"
+Prints the initial INSERT SQL statements for the given app name(s).
+.BI "sqlreset [" "appname ..." "]"
+Prints the DROP TABLE SQL, then the CREATE TABLE SQL, for the given app
+.BI "sqlsequencereset [" "appname ..." "]"
+Prints the SQL statements for resetting PostgreSQL sequences for the
+given app name(s).
+.BI "startapp [" "appname" "]"
+Creates a Django app directory structure for the given app name in
+the current directory.
+.BI "startproject [" "projectname" "]"
+Creates a Django project directory structure for the given project name
+in the current directory.
+.BI syncdb
+Creates the database tables for all apps in INSTALLED_APPS whose tables
+haven't already been created.
+.BI "test [" "\-\-verbosity" "] [" "appname ..." "]"
+Runs the test suite for the specified applications, or the entire project if
+no apps are specified
+.BI validate
+Validates all installed models.
+.I \-\-version
+Show program's version number and exit.
+.I \-h, \-\-help
+Show this help message and exit.
+.I \-\-settings=SETTINGS
+Python path to settings module, e.g. "myproject.settings.main". If
+this isn't provided, the DJANGO_SETTINGS_MODULE environment variable
+will be used.
+.I \-\-pythonpath=PYTHONPATH
+Lets you manually add a directory the Python path,
+e.g. "/home/djangoprojects/myproject".
+.I \-\-plain
+Use plain Python, not IPython, for the "shell" command.
+.I \-\-noinput
+Do not prompt the user for input.
+.I \-\-noreload
+Disable the development server's auto\-reloader.
+.I \-\-verbosity=VERBOSITY
+Verbosity level: 0=minimal output, 1=normal output, 2=all output.
+.I \-\-adminmedia=ADMIN_MEDIA_PATH
+Specifies the directory from which to serve admin media when using the development server.
+In the absence of the
+.BI \-\-settings
+option, this environment variable defines the settings module to be read.
+It should be in Python-import form, e.g. "myproject.settings".
+Full descriptions of all these options, with examples, as well as documentation
+for the rest of the Django framework, can be found on the Django site:
+or in the distributed documentation.
+Originally developed at World Online in Lawrence, Kansas, USA. Refer to the
+AUTHORS file in the Django distribution for contributors.
+New BSD license. For the full license text refer to the LICENSE file in the
+Django distribution.
@@ -21,3 +21,8 @@ done
# Make sure we match foo.pyo and foo.pyc along with (but only once each)
sed -e "/\.py[co]$/d" -e "s/\.py$/.py*/" DIRS FILES >INSTALLED_FILES
+mkdir -p ${RPM_BUILD_ROOT}/%{_mandir}/man1/
+cp docs/man/* ${RPM_BUILD_ROOT}/%{_mandir}/man1/
+%doc %{_mandir}/man1/*"

0 comments on commit b912260

Please sign in to comment.