Changeset 2835

Timestamp:

04/05/06 22:55:03 (18 years ago)

Author:

jerome

Message:

Improved installation documentation

Location:

pykota/trunk/docs

Files:

• filterpykota.sgml (modified) (1 diff)
• installation.sgml (modified) (7 diffs)

pykota/trunk/docs/filterpykota.sgml

@@ -42 +42 @@
   
   <para>
-    Currently with a <application>CUPS</application> internal accounting mechanism, the <command>pstops</command>
+    Currently with <application>CUPS</application>' internal accounting mechanism, the <command>pstops</command>
     filter can be bypassed. That's why <application>PyKota</application> uses its own backend.
     The <command>cupspykota</command> backend wrapper ensures that jobs can't bypass it, so you can use

pykota/trunk/docs/installation.sgml

@@ -467 +467 @@
         <listitem>
           <para>
-            <application>Python</application> version 2.1 or above.
+            <application>Python</application> version 2.2 or above.
             You can download it from <ulink url="http://www.python.org">http://www.python.org</ulink>.
             While <application>PyKota</application> itself will try to preserve compatibility
-            with <application>Python</application> version 2.1 for the near future, some <application>Python</application>
-            modules which are needed by <application>PyKota</application> may mandate the use of a more recent version
+            with <application>Python</application> version 2.2 for the near future, some <application>Python</application>
+            modules which are needed by <application>PyKota</application> may require a more recent version
             of this language.
           </para>
@@ -607 +607 @@
           </para>
         </listitem>  
+        <listitem>
+          <para>
+            The <application>PyPAM</application> Python interface to <acronym>PAM</acronym>.
+            You'll need this if you plan to ask users to authenticate when printing through <command>pknotify</command>
+            and <command>pykoticon</command>. You don't need this module otherwise.
+            If needed, you can download it from <ulink url="http://www.pangalactic.org/PyPAM/">http://www.pangalactic.org/PyPAM/</ulink>.
+          </para>
+        </listitem>  
       </itemizedlist>  
     </para>
@@ -686 +694 @@
       begins with a name between square brackets <literal>[]</literal>.
       The name to use to define a particular printer section is the name
-      of the print queue on which you want to set quotas.
+      of the print queue you want to manage with PyKota.
     </para>
     
@@ -748 +756 @@
     <para>
       This all depends on the printing system you are using, and the user the
-      printing system is usually running as. You need to remember two things :
+      printing system is usually running as. You need to remember three things :
       
       <itemizedlist>
@@ -764 +772 @@
           </para>
         </listitem>
+        <listitem>        
+          <para>
+            If <filename>cupsd.conf</filename> contains <literal>RunAsUser</literal>, then
+            you won't be able to authenticate users with <command>pknotify</command> and <command>pykoticon</command>.
+            Also in this case you may have to make <application>PyKota</application>'s configuration files
+            owned by the user <application>CUPS</application> runs as.
+          </para>
+        </listitem>
       </itemizedlist>  
     </para>
@@ -774 +790 @@
     <para>
       Now depending on your printing system, the configuration to do is particular.
-      We will now see how to plug PyKota into your printing system.
+      We will now see how to plug PyKota into <application>CUPS</application> since <application>LPRng</application>
+      is not supported anymore.
     </para>
     
@@ -836 +853 @@
           to ask on PyKota's mailing list, describing the symptoms, as
           well as the hardware and software you use.
-          In a future release of this document, a section dedicated to 
-          Frequently Asked Questions will be included.
         </para>
         
         <para>
-          You can now also ask us questions on IRC :
+          A searchable FAQ is now available at 
+          <ulink url="http://otrs.librelogiciel.com/otrs/public.pl">http://otrs.librelogiciel.com/public.pl</ulink>.
+          A FAQ entry explaining in great details how to diagnose a problem correctly is
+          available at 
+          <ulink url="http://otrs.librelogiciel.com/otrs/public.pl?ID=2">http://otrs.librelogiciel.com/public.pl?ID=2</ulink>.
+        </para>
+        
+        <para>
+          You can now ask questions on IRC :
           <screen>
 /server irc.freenode.net