web commit by http://getopenid.com/ptecza: * Bug still not fixed

[git.ikiwiki.info.git] / doc / usage.mdwn

diff --git a/doc/usage.mdwn b/doc/usage.mdwn
index 9e260adc29ceeec7a06a8ce957b1bb2c506e598b..9980cca037d25a73ec38bff97ed3f3334ca108e1 100644 (file)
--- a/doc/usage.mdwn
+++ b/doc/usage.mdwn
@@ -56,10 +56,12 @@ These options control the mode that ikiwiki is operating in.
   In setup mode, ikiwiki reads the config file, which is really a perl
   program that can call ikiwiki internal functions.
 
   In setup mode, ikiwiki reads the config file, which is really a perl
   program that can call ikiwiki internal functions.
 

+  [[ikiwiki.setup]] is an example of such a config file.
+

   The default action when --setup is specified is to automatically generate
   wrappers for a wiki based on data in a config file, and rebuild the wiki.
   The default action when --setup is specified is to automatically generate
   wrappers for a wiki based on data in a config file, and rebuild the wiki.

-
-  [[ikiwiki.setup]] is an example of such a config file.
+  If you only want to build any changed pages, you can use --refresh with
+  --setup.

 
 * --wrappers
 
 
 * --wrappers
 


@@ -99,9 +101,10 @@ configuration options of their own.
 
 * --templatedir
 
 
 * --templatedir
 

-  Specify the directory that the page [[templates]] are stored in.
-  Default is `/usr/share/ikiwiki/templates`, or another location as
-  configured at build time.
+  Specify the directory that the page [[templates]] are stored in. Default
+  is `/usr/share/ikiwiki/templates`, or another location as configured at
+  build time. If the templatedir is changed, missing templates will still
+  be searched for in the default location as a fallback.

 
 * --underlaydir
 
 
 * --underlaydir
 


@@ -138,7 +141,7 @@ configuration options of their own.
   the web will be committed. Also, the [[RecentChanges]] link will be placed
   on pages.
 
   the web will be committed. Also, the [[RecentChanges]] link will be placed
   on pages.
 

-  svn is enabled by default.
+  No revision control is enabled by default.

 
 * --svnrepo /svn/wiki
 
 
 * --svnrepo /svn/wiki
 


@@ -228,6 +231,12 @@ configuration options of their own.
   Enables or disables "Discussion" links from being added to the header of
   every page. The links are enabled by default.
 
   Enables or disables "Discussion" links from being added to the header of
   every page. The links are enabled by default.
 

+* --userdir subdir
+
+  Optionally, allows links to users of the wiki to link to pages inside a
+  subdirectory of the wiki. The default is to link to pages in the toplevel
+  directory of the wiki.
+

 * --timeformat format
 
   Specify how to display the time or date. The format string is passed to the
 * --timeformat format
 
   Specify how to display the time or date. The format string is passed to the


@@ -235,7 +244,7 @@ configuration options of their own.
 
 * --verbose, --no-verbose
 
 
 * --verbose, --no-verbose
 

-  Be vebose about what is being done.
+  Be verbose about what is being done.

 
 * --syslog, --no-syslog
 
 
 * --syslog, --no-syslog