more structure in starting section

diff --git a/doc/source/user-manual.sgml b/doc/source/user-manual.sgml
index e92a15f..f2a3e81 100644 (file)
--- a/doc/source/user-manual.sgml
+++ b/doc/source/user-manual.sgml
@@ -25,7 +25,7 @@
                 This file belongs into
                 ijbswa.sourceforge.net:/home/groups/i/ij/ijbswa/htdocs/
                 
- $Id: user-manual.sgml,v 1.97 2002/04/27 21:04:42 hal9 Exp $
+ $Id: user-manual.sgml,v 1.98 2002/04/28 05:43:59 hal9 Exp $
 
  Written by and Copyright (C) 2001 the SourceForge
  Privoxy team. http://www.privoxy.org/
@@ -46,7 +46,7 @@
 <artheader>
 <title>Privoxy User Manual</title>
 
-<pubdate>$Id: user-manual.sgml,v 1.97 2002/04/27 21:04:42 hal9 Exp $</pubdate>
+<pubdate>$Id: user-manual.sgml,v 1.98 2002/04/28 05:43:59 hal9 Exp $</pubdate>
 
 <authorgroup>
  <author>
@@ -421,11 +421,11 @@ automatically start Privoxy in the boot process.
 <sect1 id="startup">
 <title>Starting <application>Privoxy</application></title>
 <para>
- Before launching <application>Privoxy</application> for the first time, you 
- will want to configure your browser(s) to use <application>Privoxy</application>
- as a HTTP and HTTPS proxy. The default is localhost for the proxy address,
- and port 8118 (earlier versions used port 8000). This is the one
- configuration step that must be done! 
+ Before launching <application>Privoxy</application> for the first time, you
+ will want to configure your browser(s) to use
+ <application>Privoxy</application> as a HTTP and HTTPS proxy. The default is
+ localhost for the proxy address, and port 8118 (earlier versions used port
+ 8000). This is the one configuration step that must be done!
 </para>
  
 <para> 
@@ -445,45 +445,94 @@ automatically start Privoxy in the boot process.
  <application>Privoxy</application>!
 </para>
 
-
 <para>
  <application>Privoxy</application> is typically started by specifying the
- main configuration file to be used on the command line. Example Unix startup
- command:
+ main configuration file to be used on the command line. If no configuration
+ file is specified on the command line, <application>Privoxy</application>
+ will look for a file named <filename>config</filename> in the current
+ directory. Except on Win32 where it will try <filename>config.txt</filename>.
 </para>
 
+<sect2 id="start-redhatdebian">
+<title>RedHat and Debian</title>
+<para>
+We use a script. Note that RedHat does not start Privoxy upon booting per
+default. It will use the file <filename>/etc/privoxy/config</filename> as its
+main configuration file. FIXME: Debian??
+</para>
 <para>
  <screen>
- # /usr/sbin/privoxy /etc/privoxy/config
+ # /etc/rc.d/init.d/privoxy start
 </screen>
 </para>
+</sect2>
 
+<sect2 id="start-suse">
+<title>SuSE</title>
+<para>
+We use a script. It will use the file <filename>/etc/privoxy/config</filename>
+as its main configuration file. Note that SuSE starts Privoxy upon booting
+your PC.
+</para>
 <para>
- See <link linkend="cmdoptions">below</link> for other command line options.
+ <screen>
+ # rcprivoxy start
+</screen>
 </para>
+</sect2>
 
+<sect2 id="start-windows">
+<title>Windows</title>
 <para>
- An init script is provided for SuSE and Red Hat.
+Click on the Privoxy Icon to start Privoxy. If no configuration file is
+ specified on the command line, <application>Privoxy</application> will look
+ for a file named <filename>config.txt</filename>. Note that Windows will
+ automatically start Privoxy upon booting you PC.
 </para>
+</sect2>
 
+<sect2 id="start-unices">
+<title>Solaris, NetBSD, FreeBSD, HP-UX and others</title>
+<para>
+Example Unix startup command:
+</para>
 <para>
- For for SuSE: <command>rcprivoxy start</command>
+ <screen>
+ # /usr/sbin/privoxy /etc/privoxy/config
+</screen>
 </para>
+</sect2>
+
+<sect2 id="start-os2">
+<title>OS/2</title>
+<para>
+FIXME.
+</para>
+</sect2>
 
+<sect2 id="start-macosx">
+<title>MAX OSX</title>
 <para>
- For Red Hat and Debian: <command>/etc/rc.d/init.d/privoxy start</command>
+FIXME.
 </para>
+</sect2>
 
 
+<sect2 id="start-amigaos">
+<title>AmigaOS</title>
 <para>
- If no configuration file is specified on the command line,
- <application>Privoxy</application> will look for a file named
- <filename>config</filename> in the current directory. Except on Win32 where
- it will try <filename>config.txt</filename>. If no file is specified on the
- command line and no default configuration file can be found, 
- <application>Privoxy</application> will fail to start.
+FIXME.
 </para>
+</sect2>
 
+<!--
+
+<para>
+ See the section <link linkend="cmdoptions">Command line options</link> for
+ furher info.
+</para>
+
+must find a better place for this paragraph
 
 <para>
  The included default configuration files should give a reasonable starting
@@ -574,6 +623,8 @@ automatically start Privoxy in the boot process.
  Developers</quote></ulink> below. 
 </para>
 
+-->
+
 <!--   ~~~~~       New section      ~~~~~     -->
 <sect2 id="cmdoptions">
 <title>Command Line Options</title>
@@ -5730,6 +5781,10 @@ Requests</title>
  Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
  $Log: user-manual.sgml,v $
+ Revision 1.98  2002/04/28 05:43:59  hal9
+ This is the break up of configuration.html into multiple files. This
+ will probably break links elsewhere :(
+
  Revision 1.97  2002/04/27 21:04:42  hal9
  -Rewrite of Actions File example.
  -Add section for user-manual directive in config.