Changes between Version 7 and Version 8 of TracAdmin

Timestamp:

01/17/08 22:31:17 (18 years ago)

Author:

trac (IP: 127.0.0.1)

Comment:

--

TracAdmin

@@ -2 +2 @@
 [[TracGuideToc]]
 
-Trac is distributed with a powerful configuration tool. This tool can be used 
-to configure and customize your Trac-installation to better fit your needs.
+Trac is distributed with a powerful command-line configuration tool. This tool can be used  to configure and customize your Trac-installation to better fit your needs.
+
+Some of those operations can also be performed via the web interface thanks to the optional [http://trac.edgewall.org/wiki/WebAdmin WebAdmin] plugin, distributed separately for now.
 
 == Usage ==
 
+You can get a comprehensive list of the available options, commands and sub-commands by invoking `trac-admin` with the `help` command:
+{{{
+trac-admin help
+}}}
 
+Unless you're executing the `help`, `about` or `version` sub-commands, you'll need to specify the path to the TracEnvironment that you want to administer as the first argument, for example:
+{{{
+trac-admin /path/to/projenv wiki list
+}}}
 
 == Interactive Mode ==
 
-When passed the database filename as only argument, '''trac-admin''' starts in interactive mode.
-Commands can then be executed on the selected database using the prompt, which offers tab-completion
-(on non-Windows environments) and automatic repetition of the last command issued.
+When passing the environment path as the only argument, `trac-admin` starts in interactive mode.
+Commands can then be executed on the selected environment using the prompt, which offers tab-completion
+(on non-Windows environments, and when the Python `readline` module is available) and automatic repetition of the last command issued.
 
-== A Note on Configuration ==
-For configuration of the Trac environment, Trac 0.7 introduced a new storage format, including a separate config file used for settings. See TracIni for details.
+Once you're in interactive mode, you can also get help on specific commands or subsets of commands:
 
+For example, to get an explanation of the `resync` command, run:
+{{{
+> help resync
+}}}
+
+To get help on a all the Wiki-related commands, run:
+{{{
+> help wiki
+}}}
 
 ----
-See Also: TracGuide, TracBackup, TracPermissions. TracEnvironment, TracIni
+See also: TracGuide, TracBackup, TracPermissions, TracEnvironment, TracIni