Changes between Version 37 and Version 38 of TracAdmin

Timestamp:

Jun 12, 2010, 4:32:06 PM (14 years ago)

Author:

Christian Boos

Comment:

#initenv reword the section

TracAdmin

@@ -18 +18 @@
 }}}
 
-=== Creating an Environment === #initenv
+`trac-admin` only accept two command line options, `--version` and `--help`. The former give you the Trac admin version number (e.g. 0.12) and the second a very succinct list of commands (`help` and `initenv`).
 
-The `initenv` also supports an extra `--inherit` option, which can be used to specify the `[inherit] file` option at environment creation time so that only the options ''not'' already specified in the global configuration file will be written in the conf/trac.ini file of the newly created environment.
+
+=== `trac-admin <targetdir> initenv` === #initenv
+
+This subcommand is very important as it's the one used to create a TracEnvironment in the specified `<targetdir>`. That directory must not exists prior to the call.
+
+It supports an extra `--inherit` option, which can be used to specify a global configuration file which can be used share settings between several environments. You can also inherit from a shared configuration afterwards, by setting the `[inherit] file` option in the `conf/trac.ini` file in your newly created environment, but the advantage of specifying the inherited configuration file at environment creation time is that only the options ''not'' already specified in the global configuration file will be written in the created environment's `conf/trac.ini` file.
 See TracIni#GlobalConfiguration.