Update man page to add setup operations

doc/plinth.xml

@@ -40,6 +40,14 @@
       <arg><option>--server_dir</option><arg choice="req">SERVER_DIR</arg></arg>
       <arg><option>--debug</option></arg>
       <arg><option>--diagnose</option></arg>
+      <arg>
+        <option>--setup</option>
+        <arg choice="opt" rep="repeat">application</arg>
+      </arg>
+      <arg>
+        <option>--setup-no-repeat</option>
+        <arg choice="opt" rep="repeat">application</arg>
+      </arg>
     </cmdsynopsis>
   </refsynopsisdiv>
 
@@ -71,9 +79,9 @@
     <title>Options</title>
     <variablelist>
       <varlistentry>
-	<term><option>--server_dir SERVER_DIR</option></term>
+        <term><option>--server_dir SERVER_DIR</option></term>
-	<listitem>
+        <listitem>
-	  <para>
+          <para>
             This the URL fragment under which Plinth will provide its
             services.  By default the value from
             <filename>plinth.config</filename> is used.  Plinth is
@@ -85,30 +93,63 @@
             available, <filename>plinth.config</filename> from current
             directory is used.  In source directory, this has the
             default value of <filename>/</filename>.
-	  </para>
+          </para>
-	</listitem>
+        </listitem>
       </varlistentry>
       <varlistentry>
-	<term><option>--debug</option></term>
+        <term><option>--debug</option></term>
-	<listitem>
+        <listitem>
-	  <para>
+          <para>
-	    Enable debug mode.  Turn off Django security features.
+            Enable debug mode.  Turn off Django security features.
-	    Print extra debug messages.  Monitor source files for
+            Print extra debug messages.  Monitor source files for
-	    changes and restart Plinth on modifications.  Turn on
+            changes and restart Plinth on modifications.  Turn on
-	    Django debug mode to show details on error pages.  Die if
+            Django debug mode to show details on error pages.  Die if
-	    there is an error during module initialization.
+            there is an error during module initialization.
-	  </para>
+          </para>
-	</listitem>
+        </listitem>
       </varlistentry>
       <varlistentry>
-	<term><option>--diagnose</option></term>
+        <term><option>--diagnose</option></term>
-	<listitem>
+        <listitem>
-	  <para>
+          <para>
             If provided, Plinth loads modules, performs initialization
             but does start the web server.  Instead it runs diagnostic
             tests on each module and exits.
-	  </para>
+          </para>
-	</listitem>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--setup</option></term>
+        <listitem>
+          <para>
+            Perform application setup operations and exit.  Setting up
+            an application involves installing packages required for
+            that application and performing pre and post install
+            configuration setups.  If no application is provided,
+            setup all applications which describe themselves as
+            essential.  If a list of applications is provided, setup
+            only those applications.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--setup-no-install</option></term>
+        <listitem>
+          <para>
+            Same as <option>--setup</option> but no new Debian
+            packages are installed during setup.  When a package needs
+            to be installed, a check is done to make sure the package
+            is already installed.  If the package is already
+            installed, no upgrade is performed and setup skips this
+            step and proceeds to next operation.  If the package is
+            not installed an error is raised and setup process halts.
+            This is option is useful for running setup during post
+            installation script of a Debian package.  Essential
+            packages are added as dependencies for the Debian package
+            and then setup process is executed from post install
+            script of the Debian package.
+          </para>
+        </listitem>
       </varlistentry>
     </variablelist>
   </refsect1>
@@ -145,7 +186,7 @@
         under and set it to /plinth.
       </para>
     </example>
-</refsect1>
+  </refsect1>
 
   <refsect1>
     <title>Bugs</title>
@@ -160,8 +201,8 @@
     <title>Author</title>
     <para>
       <author>
-	<firstname>Plinth Developers</firstname>
+        <firstname>Plinth Developers</firstname>
-	<contrib>Original author</contrib>
+        <contrib>Original author</contrib>
       </author>
     </para>
   </refsect1>