Changeset 3413 for pykota/trunk/docs/repykota.sgml

Timestamp:

09/27/08 22:02:37 (16 years ago)

Author:

jerome

Message:

Removed unnecessary spaces at EOL.

Files:

• pykota/trunk/docs/repykota.sgml (modified) (9 diffs)

pykota/trunk/docs/repykota.sgml

@@ -4 +4 @@
   <title id="repykota">Create print quota usage reports with repykota</title>
   <para>Last modified on $Date$</para>
-  
+
   <para>
     To account for print usage is good, however there must be a way to easily
@@ -10 +10 @@
     reports describing current usage for every user on every printer.
   </para>
-  
+
   <sect1>
     <title>Command line based Print Quota reports</title>
-    
+
     <para>
       PyKota features a quota report generator, named <command>repykota</command>,
       with which you can print the current state of the quota database.
     </para>
-    
+
     <para>
       <command>repykota</command> behaves differently when it is launched by a
       <application>PyKota</application> administrator, compared to when it is launched by a normal user.
-    </para>  
-    
+    </para>
+
     <para>
-      In the first case, the print quota report will contain current account balance, 
+      In the first case, the print quota report will contain current account balance,
       soft and hard limits, number of pages printed since last reset, total number
       of pages printed, total paid, for possibly all users or all groups, depending
       on command line options.
     </para>
-    
+
     <para>
       In the second case, i.e. when <command>repykota</command> is launched by
-      a normal user, the user will only be allowed to see informations about himself or 
+      a normal user, the user will only be allowed to see informations about himself or
       the groups he his a member of.
     </para>
-  
+
     <para>
       Any user can limit the report to only one or more printers, by specifying the
-      <literal>-P</literal> or <literal>--printer</literal> command line option, 
+      <literal>-P</literal> or <literal>--printer</literal> command line option,
       followed by one or more printer name or wildcard. If more than one printer name
       or wildcard is used, they must be separated by commas.
     </para>
-    
+
     <para>
       Launching <command>repykota</command> with no arguments will generate
       a complete print quota report, depending on what you are allowed to see.
     </para>
-    
+
     <para>
       Use the <literal>--help</literal> command line argument to learn what are
       the different command line options available.
     </para>
-    
+
     <sect2>
       <title>Reference</title>
@@ -66 +66 @@
             <arg>-P <replaceable>printername</replaceable></arg>
             <arg>--printer <replaceable>printername</replaceable></arg>
-          </group>  
+          </group>
           <group choice="opt">
             <arg><replaceable>name1</replaceable></arg>
@@ -72 +72 @@
             <arg><replaceable>...</replaceable></arg>
             <arg><replaceable>nameN</replaceable></arg>
-          </group>  
+          </group>
         </cmdsynopsis>
       </para>
     </sect2>
   </sect1>
-  
+
   <sect1>
     <title>Web based Print Quota reports</title>
-    
+
     <para>
       <application>PyKota</application> also features a CGI script to remotely access
@@ -88 +88 @@
       correctly.
     </para>
-    
+
     <para>
       You may also want to copy the <acronym>CSS</acronym> stylesheets which are present in the
@@ -95 +95 @@
       a nicer web interface.
     </para>
-    
+
     <para>
       You can find <command>printquota.cgi</command> in the <filename>pykota/cgi-bin</filename>
       directory. Here's how to install it, provided that your web server's <filename>cgi-bin</filename>
       directory is <filename>/usr/lib/cgi-bin</filename> :
-<screen>      
+<screen>
 port50-2:/home/jerome/pykota$ cp cgi-bin/printquota.cgi /usr/lib/cgi-bin
 port50-2:/home/jerome/pykota$ chmod 755 /usr/lib/cgi-bin/printquota.cgi
@@ -112 +112 @@
           must ensure that this user <emphasis>is not</emphasis> allowed to read <filename>~pykota/pykotadmin.conf</filename>
         </para>
-      </note>  
+      </note>
     </para>
-    
+
     <para>
       If you install the CGI script as described above, any user will be allowed to view the complete print
@@ -125 +125 @@
       then there's no restriction on what may appear on the print quota report.
     </para>
-    
+
     <para>
       To automatically ask for an authentication dialog whenever the CGI script is accessed, you have to configure
-      your web server to do so. If your webserver is <ulink url="http://httpd.apache.org"><application>Apache</application></ulink>, then it's relatively easy. First you have to put 
+      your web server to do so. If your webserver is <ulink url="http://httpd.apache.org"><application>Apache</application></ulink>, then it's relatively easy. First you have to put
       <command>printquota.cgi</command> in its own subdirectory below your web server's <filename>cgi-bin</filename>
       directory, for example in <filename>cgi-bin/PyKota/</filename>. Then use the <command>htpasswd</command>
@@ -140 +140 @@
       authentication mechanism.
     </para>
-    
+
     <para>
       The detailed procedure to do all this is out of the scope of the present document, please refer to
-      <application>Apache</application>'s <ulink url="http://httpd.apache.org/docs-project/">documentation</ulink> 
+      <application>Apache</application>'s <ulink url="http://httpd.apache.org/docs-project/">documentation</ulink>
       for all the gory details.
     </para>