[myserver-commit] [2833] Move the index in a separate node and use the right texinfo tag for file names .

[Giuseppe Scrivano]

Revision: 2833
          http://svn.sv.gnu.org/viewvc/?view=rev&root=myserver&revision=2833
Author:   gscrivano
Date:     2008-09-21 20:49:18 +0000 (Sun, 21 Sep 2008)

Log Message:
-----------
Move the index in a separate node and use the right texinfo tag for file names.

Modified Paths:
--------------
    trunk/myserver/documentation/basic_configuration.texi
    trunk/myserver/documentation/mime_types.texi
    trunk/myserver/documentation/myserver.texi
    trunk/myserver/documentation/process_security.texi
    trunk/myserver/documentation/ssl_certificates.texi
    trunk/myserver/documentation/virtual_hosts.texi

Modified: trunk/myserver/documentation/basic_configuration.texi
===================================================================
--- trunk/myserver/documentation/basic_configuration.texi       2008-09-21 
19:52:04 UTC (rev 2832)
+++ trunk/myserver/documentation/basic_configuration.texi       2008-09-21 
20:49:18 UTC (rev 2833)
@@ -1,5 +1,5 @@
 @c -*-texinfo-*-
-In the myserver.xml file you can set the default page for your
+In the @file{myserver.xml} file you can set the default page for your
 websites hosted on MyServer.
 
 Similar lines already exist in your configuration file:
@@ -37,8 +37,8 @@
 @end example
 
 You can change the layout of the directory browsing page. The line
-below, in myserver.xml, points to the CSS file used to configure the
-layout for the browsing directory pages:
+below, in @file{myserver.xml}, points to the CSS file used to
+configure the layout for the browsing directory pages:
 
 @example
 <BROWSEFOLDER_CSS>system/folderstyle.css</BROWSEFOLDER_CSS>
@@ -47,7 +47,7 @@
 CGI Scripts can get the Server Administrator E-mail and show them to
 the user (through the SERVER_ADMIN environment variable). So, it can
 be important you define this address properly, by setting the value in
-the line below, in myserver.xml:
+the line below, in @file{myserver.xml}:
 
 @example
 <SERVER_ADMIN>administrator@@localhost</SERVER_ADMIN>
@@ -56,7 +56,7 @@
 MyServer offers the feature to follow symlinks on Unix-like Operating
 systems (e.g.: Linux, *BSD, GNU/HURD, Solaris, etc.).
 You can add the symlink following feature for all hosts in the
-myserver.xml file.
address@hidden file.
 
 @example
 <FOLLOW_LINKS>YES</FOLLOW_LINKS>

Modified: trunk/myserver/documentation/mime_types.texi
===================================================================
--- trunk/myserver/documentation/mime_types.texi        2008-09-21 19:52:04 UTC 
(rev 2832)
+++ trunk/myserver/documentation/mime_types.texi        2008-09-21 20:49:18 UTC 
(rev 2833)
@@ -1,6 +1,6 @@
 @c -*-texinfo-*-
 You can modify the MIME types used by MyServer by modifying the file
-"MIMEtypes.xml". The following is an example of the .xml file: 
address@hidden The following is an example of this file: 
 
 @example
 <MIMETYPES>
@@ -48,9 +48,9 @@
 above, the data would be sent gzipped to the user. It means Gzip works
 as a filter in MyServer. you can define Gzip to automatically run for
 every file based in its size, setting the @code{<GZIP_THRESHOLD>}, in
-myserver.xml file. For obvious reasons, data will be sent gzipped only
-if the client supports gzip - otherwise he'd receive a lot of weird
-characters instead of the site requested.
address@hidden file. For obvious reasons, data will be sent
+gzipped only if the client supports gzip - otherwise he'd receive a
+lot of weird characters instead of the site requested.
 
 In general, filters can also be applied to dynamic data - like CGI,
 ISAPI, FastCGI - but they need to be filters that don't modify the

Modified: trunk/myserver/documentation/myserver.texi
===================================================================
--- trunk/myserver/documentation/myserver.texi  2008-09-21 19:52:04 UTC (rev 
2832)
+++ trunk/myserver/documentation/myserver.texi  2008-09-21 20:49:18 UTC (rev 
2833)
@@ -13,7 +13,7 @@
 Copyright @copyright{} 2008 Free Software Foundation, Inc.
 @end titlepage
 
address@hidden Top, Copying, (dir), (dir)
address@hidden Top, Copying,,
 
 This is the manual for the GNU MyServer web server.
 
@@ -28,9 +28,9 @@
 * MIME types:: MIME types configuration.
 * Process security:: Process security.
 * SSL certificates:: Show how to use SSL certificates.
+* Table of contents:: Table of contents.
 @end menu
 
-
 @node Copying, GNU Free Documentation License, Top, Top
 @appendix GNU GENERAL PUBLIC LICENSE
 @include gpl.texi
@@ -69,7 +69,8 @@
 @cindex SSL certificates
 @include ssl_certificates.texi
 
-
address@hidden Table of contents, , Top, Top
address@hidden Table of contents
 @printindex cp
 @contents
 @bye

Modified: trunk/myserver/documentation/process_security.texi
===================================================================
--- trunk/myserver/documentation/process_security.texi  2008-09-21 19:52:04 UTC 
(rev 2832)
+++ trunk/myserver/documentation/process_security.texi  2008-09-21 20:49:18 UTC 
(rev 2833)
@@ -4,7 +4,7 @@
 root user can bind ports < 1024).
 
 To specify a different process user id (PID), you must specify it in
-the myserver.xml file as:
+the @file{myserver.xml} file as:
 
 @example
 <PROCESS_USER_ID>PID</PROCESS_USER_ID>

Modified: trunk/myserver/documentation/ssl_certificates.texi
===================================================================
--- trunk/myserver/documentation/ssl_certificates.texi  2008-09-21 19:52:04 UTC 
(rev 2832)
+++ trunk/myserver/documentation/ssl_certificates.texi  2008-09-21 20:49:18 UTC 
(rev 2833)
@@ -8,14 +8,13 @@
 key is used both for encryption and decryption.  These algorithms are
 not used by servers with a potentially large number of clients because
 the data captured can be decrypted by any client that know the key and
-because the key needs to be distribute in a safe manner(for example
-using a floppy disk) and not distributing it on a large network like
-Internet.  The asymmetric algorithms work in a different way, the data
-encrypted with a key can be decrypted only with the other key and
-vice-versa.  Anyone know the public key but only the owner knows the
-private one.  In this way the key owner do not have to distribute the
-key only to know clients but he can distributes it to a large scale
-network.
+because the key needs to be distribute in a safe manner not
+distributing it on a large network like Internet.
+The asymmetric algorithms work in a different way, the data encrypted
+with a key can be decrypted only with the other key and vice-versa.
+Anyone know the public key but only the owner knows the private one.
+In this way the key owner do not have to distribute the key only to
+know clients but he can distributes it to a large scale network.
 
 @section How create SSL certificates with OpenSSL
 A certificate is needed to certify your identity through a
@@ -23,6 +22,7 @@
 register it to third party CA, it is called self-signed certificate.
 You can find all the necessary tools to create certificates in  the
 library OpenSSL at: www.openssl.org.
+
 After OpenSSL is installed correctly, type the following commands:
 
 @example
@@ -37,7 +37,7 @@
 directory.
 
 To configure a HTTPS host that will use the created certificate, add
-the following lines in the virtualhosts.xml file:
+the following lines in the @file{virtualhosts.xml} file:
 
 @example
 <VHOST>

Modified: trunk/myserver/documentation/virtual_hosts.texi
===================================================================
--- trunk/myserver/documentation/virtual_hosts.texi     2008-09-21 19:52:04 UTC 
(rev 2832)
+++ trunk/myserver/documentation/virtual_hosts.texi     2008-09-21 20:49:18 UTC 
(rev 2833)
@@ -2,9 +2,8 @@
 In theory, virtual hosts allow users to lodge an infinite number of
 sites on a single machine. For example http://mypc.net is different
 from http://sub.mypc.net. To define virtual hosts in myServer open the
-file virtualhosts.xml in a text editor (such as notepad in Windows or
-GNU Emacs in GNU/Linux). A sample virtual hosts configuration file
-looks like:
+file @file{virtualhosts.xml} in a text editor. A sample virtual hosts
+configuration file looks like:
 
 @example
 <VHOSTS>
@@ -50,11 +49,11 @@
 it is the errors log file used by the virtual host.
 @item <ALLOW_CGI>
 This option would deny the access to CGI in this
-virtual host. This line can exist in myserver.xml too, as a global
-configuration, but if it is included in virtualhosts.xml, this is the
-one that will be considered. @code{ALLOW_CGI} can also appear as
address@hidden, @code{ALLOW_ISAPI}, @code{ALLOW_MSCGI},
address@hidden, @code{ALLOW_SEND_LINK},
+virtual host. This line can exist in @file{myserver.xml} too, as a global
+configuration, but if it is included in the @file{virtualhosts.xml}
+file, this is the one that will be considered. @code{ALLOW_CGI} can
+also appear as @code{ALLOW_FASTCGI}, @code{ALLOW_ISAPI},
address@hidden, @code{ALLOW_WINCGI}, @code{ALLOW_SEND_LINK},
 @code{ALLOW_EXTERNAL_COMMANDS}, @code{ALLOW_SEND_FILE}, each of them
 denying/allowing the proper HTTP data handler to be used.
 @end itemize
@@ -91,10 +90,9 @@
 imposed using security file.
 
 MyServer gives you the option to enable the HTTP TRACE command for
-each virtual host. All you need to do is edit the security.xml file of
-the root of your virtual host (not a subdirectory in it! if the file
-doesn't exist, you may create a new one, in the format described in
-the Security section of this documentation), and add the parameter
+each virtual host. All you need to do is edit the @file{security.xml}
+file of the root of your virtual host (not a subdirectory!  If the
+file doesn't exist, you may create a new one), and add the parameter:
 
 @example
 <HTTP TRACE="ON" />