[system-administrators-guide] misc updates to printer conf

stephenw stephenw at fedoraproject.org
Mon Dec 8 22:55:09 UTC 2014


commit 6b317c10f9d79080acce134938836adc2156ebad
Author: Stephen Wadeley <swadeley at redhat.com>
Date:   Mon Dec 8 23:53:50 2014 +0100

    misc updates to printer conf

 en-US/Printer_Configuration.xml |   80 ++++++++++++++++++---------------------
 1 files changed, 37 insertions(+), 43 deletions(-)
---
diff --git a/en-US/Printer_Configuration.xml b/en-US/Printer_Configuration.xml
index d15d07e..c98f266 100644
--- a/en-US/Printer_Configuration.xml
+++ b/en-US/Printer_Configuration.xml
@@ -12,7 +12,7 @@
      <see>Printer Configuration</see>
     </indexterm>
   <para>
-    The <application>Printer Configuration</application> tool serves for printer configuring, maintenance of printer configuration files, print spool directories and print filters, and printer classes management.      
+    The <application>Printer</application> configuration tool serves for printer configuring, maintenance of printer configuration files, print spool directories and print filters, and printer classes management.
   </para>
   <para>
     The tool is based on the Common Unix Printing System (<acronym>CUPS</acronym>). If you upgraded the system from a previous &MAJOROS; version that used CUPS, the upgrade process preserved the configured printers.
@@ -30,10 +30,10 @@
   <section id="sec-Starting_Printer_Config">
     <title>Starting the Printer Configuration Tool</title>
     <para>
-      With the Printer Configuration tool you can perform various operations on existing printers and set up new printers.
+      With the <application>Printer</application> configuration configuration tool you can perform various operations on existing printers and set up new printers. You can also use CUPS directly (go to <ulink url="http://localhost:631/">http://localhost:631/</ulink> to access the CUPS web application).
     </para>
     <para>
-      On the upper panel, go to <guimenu>Activities</guimenu>, choose <guisubmenu>Applications</guisubmenu> and click <guimenuitem>Printing</guimenuitem>. Alternatively, run the <command>system-config-printer</command> command from the command line to start the tool.
+    To start the <application>Printer</application> configuration tool if using the GNOME desktop, press the <keycap>Super</keycap> key to enter the Activities Overview, type <command>Printer</command>, select the icon, and then press <keycap>Enter</keycap>. The <application>Printer</application> configuration tool appears. The <keycap>Super</keycap> key appears in a variety of guises, depending on the keyboard and other hardware, but often as either the Windows or Command key, and typically to the left of the <keycap>Spacebar</keycap>.
     </para>
     <para>
       The <guilabel>Printer Configuration</guilabel> window depicted in <xref  linkend="fig-printconf-main" /> appears.
@@ -62,7 +62,7 @@
         Printer setup process varies depending on the printer queue type.
       </para>
       <para>
-        If you are setting up a local printer connected with USB, the printer is discovered and added automatically. You will be prompted to confirm the packages to be installed and provide the root password. Local printers connected with other port types and network printers need to be set up manually.
+        If you are setting up a local printer connected with USB, the printer is discovered and added automatically. You will be prompted to confirm the packages to be installed and provide the <systemitem class="username">root</systemitem> password. Local printers connected with other port types and network printers need to be set up manually.
       </para>
       <procedure id="proc-Setting_up_Printer">
         <para>
@@ -70,14 +70,10 @@
         </para>
         <step>
           <para>
-            Start the Printer Configuration tool (refer to <xref linkend="sec-Starting_Printer_Config" />).
-          </para>
-        </step>
-        <step>
-          <para>
-            Go to <menuchoice><guimenu>Server</guimenu><guisubmenu>New</guisubmenu><guimenuitem>Printer</guimenuitem></menuchoice>.
+            Start the Printer configuration tool (refer to <xref linkend="sec-Starting_Printer_Config" />).
           </para>
         </step>
+
         <step>
           <para>
             In the <guilabel>Authentication Required</guilabel> box, type the root user password and confirm.
@@ -85,7 +81,7 @@
         </step>
         <step>
           <para>
-            Select the printer connection type and provide its details in the area on the right.
+            Select the plus sign to open the <guimenuitem>Add a New Printer</guimenuitem> dialog. Select the printer from the list or enter its address below.
           </para>
         </step>
       </procedure>
@@ -102,7 +98,7 @@
         <procedure id="proc-Adding_Other_Printer">
           <step>
             <para>
-              Open the <systemitem>New Printer</systemitem> dialog (refer to <xref linkend="sec-Setting_Printer" />).
+              Open the <systemitem>Add a New Printer</systemitem> dialog (refer to <xref linkend="sec-Setting_Printer" />).
             </para>
           </step>
           <step>
@@ -175,7 +171,7 @@
         <procedure id="proc-Adding_JetDirect_Printer">
           <step>
             <para>
-              Open the <systemitem>New Printer</systemitem> dialog (refer to <xref linkend="sec-Starting_Printer_Config" />).
+              Open the <systemitem>Add a New Printer</systemitem> dialog (refer to <xref linkend="sec-Starting_Printer_Config" />).
             </para>
           </step>
           <step>
@@ -192,7 +188,7 @@
                 <term><guilabel>Hostname</guilabel></term>
                 <listitem>
                   <para>
-                    printer hostname or IP address
+                    Printer host name or <systemitem class="protocol">IP</systemitem> address.
                   </para>
                 </listitem>
               </varlistentry>
@@ -200,7 +196,7 @@
                 <term><guilabel>Port Number</guilabel></term>
                 <listitem>
                   <para>
-                    printer port listening for print jobs (<literal>9100</literal> by default)
+                    Printer port listening for print jobs (<literal>9100</literal> by default).
                   </para>
                 </listitem>
               </varlistentry>
@@ -238,14 +234,14 @@
         <secondary>IPP Printers</secondary>
       </indexterm>
         <para>
-          An IPP printer is a printer attached to a different system on the same TCP/IP network. The system this printer is attached to may either be running CUPS or simply configured to use IPP.
+          An <systemitem class="protocol">IPP</systemitem> printer is a printer attached to a different system on the same TCP/IP network. The system this printer is attached to may either be running CUPS or simply configured to use <systemitem class="protocol">IPP</systemitem>.
         </para>
         <para>
-          If a firewall is enabled on the printer server, then the firewall must be configured to allow incoming TCP connections on port 631. Note that the CUPS browsing protocol allows client machines to discover shared CUPS queues automatically. To enable this, the firewall on the client machine must be configured to allow incoming UDP packets on port 631.
+          If a firewall is enabled on the printer server, then the firewall must be configured to allow incoming <systemitem class="protocol">TCP</systemitem> connections on port <literal>631</literal>. Note that the CUPS browsing protocol allows client machines to discover shared CUPS queues automatically. To enable this, the firewall on the client machine must be configured to allow incoming <systemitem class="protocol">UDP</systemitem> packets on port <literal>631</literal>.
         </para>
         <procedure id="proc-Adding_IPP_Printer">
           <para>
-            Follow this procedure to add an IPP printer:
+            Follow this procedure to add an <systemitem class="protocol">IPP</systemitem> printer:
           </para>
           <step>
             <para>
@@ -266,7 +262,7 @@
                 <term><guilabel>Host</guilabel></term>
                 <listitem>
                   <para>
-                    the hostname for the system that controls the printer
+                    The hostname of the <systemitem class="protocol">IPP</systemitem> printer.
                   </para>
                 </listitem>
               </varlistentry>
@@ -274,8 +270,7 @@
                 <term><guilabel>Queue</guilabel></term>
                 <listitem>
                   <para>
-                    the queue name to be given to the new queue (if the box is left empty, a name based on the device node will be used)
-                  </para>
+                    The queue name to be given to the new queue (if the box is left empty, a name based on the device node will be used).</para>
                 </listitem>
               </varlistentry>
             </variablelist>
@@ -286,7 +281,7 @@
                   <imagedata fileref="images/printconf-ipp.png" format="PNG" scalefit="0" />
                 </imageobject>
                 <textobject>
-                  <para>Networked IPP Printer</para>
+                  <para>Networked <systemitem class="protocol">IPP</systemitem> Printer</para>
                 </textobject>
               </mediaobject>
             </figure>
@@ -337,7 +332,7 @@
                 <term><guilabel>Host</guilabel></term>
                 <listitem>
                   <para>
-                    the hostname of the LPD/LPR printer or host
+                    The hostname of the LPD/LPR printer or host.
                   </para>
                   <para>
                     Optionally, click <guibutton>Probe</guibutton> to find queues on the LPD host.
@@ -348,7 +343,7 @@
                 <term><guilabel>Queue</guilabel></term>
                 <listitem>
                   <para>
-                    the queue name to be given to the new queue (if the box is left empty, a name based on the device node will be used)
+                    The queue name to be given to the new queue (if the box is left empty, a name based on the device node will be used).
                   </para>
                 </listitem>
               </varlistentry>
@@ -443,12 +438,12 @@
             <stepalternatives>
               <step>
                 <para>
-                  <guilabel>Prompt user if authentication is required</guilabel>: username and password are collected from the user when printing a document.
+                  <guilabel>Prompt user if authentication is required</guilabel>: user name and password are collected from the user when printing a document.
                 </para>
               </step>
               <step>
                 <para>
-                  <guilabel>Set authentication details now</guilabel>: provide authentication information now so it is not required later. In the <guilabel>Username</guilabel> field, enter the username to access the printer. This user must exist on the SMB system, and the user must have permission to access the printer. The default user name is typically <userinput>guest</userinput> for Windows servers, or <userinput>nobody</userinput> for Samba servers.
+                  <guilabel>Set authentication details now</guilabel>: provide authentication information now so it is not required later. In the <guilabel>Username</guilabel> field, enter the user name to access the printer. This user must exist on the SMB system, and the user must have permission to access the printer. The default user name is typically <userinput>guest</userinput> for Windows servers, or <userinput>nobody</userinput> for Samba servers.
                 </para>
               </step>
             </stepalternatives>
@@ -460,10 +455,10 @@
             <warning>
               <title>Be careful when choosing a password</title>
               <para>
-                Samba printer usernames and passwords are stored in the printer server as unencrypted files readable by root and lpd. Thus, other users that have root access to the printer server can view the username and password you use to access the Samba printer.
+                Samba printer user names and passwords are stored in the printer server as unencrypted files readable by <systemitem class="username">root</systemitem> and the Linux Printing Daemon, <systemitem class="daemon">lpd</systemitem>. Thus, other users that have <systemitem class="username">root</systemitem> access to the printer server can view the user name and password you use to access the Samba printer.
               </para>
               <para>
-                As such, when you choose a username and password to access a Samba printer, it is advisable that you choose a password that is different from what you use to access your local &MAJOROS; system.
+                Therefore, when you choose a user name and password to access a Samba printer, it is advisable that you choose a password that is different from what you use to access your local &MAJOROS; system.
               </para>
               <para>
                 If there are files shared on the Samba print server, it is recommended that they also use a password different from what is used by the print queue.
@@ -508,7 +503,7 @@
             </step>
             <step>
               <para>
-                <guilabel>Provide PPD file</guilabel> — the system uses the provided PostScript Printer Description (PPD) file for installation. A PPD file may also be delivered with your printer as being normally provided by the manufacturer. If the PPD file is available, you can choose this option and use the browser bar below the option description to select the PPD file.
+                <guilabel>Provide PPD file</guilabel> — the system uses the provided <firstterm>PostScript Printer Description</firstterm> (<acronym>PPD</acronym>) file for installation. A PPD file may also be delivered with your printer as being normally provided by the manufacturer. If the PPD file is available, you can choose this option and use the browser bar below the option description to select the PPD file.
               </para>
             </step>
             <step>
@@ -538,17 +533,17 @@
           <itemizedlist>
             <listitem>
               <para>
-                Printer brand for the <guilabel>Select printer from database</guilabel> option
+                Printer brand for the <guilabel>Select printer from database</guilabel> option.
               </para>
             </listitem>
             <listitem>
               <para>
-                PPD file location for the <guilabel>Provide PPD file</guilabel> option
+                PPD file location for the <guilabel>Provide PPD file</guilabel> option.
               </para>
             </listitem>
             <listitem>
               <para>
-                Printer make and model for the <guilabel>Search for a printer driver to download</guilabel> option
+                Printer make and model for the <guilabel>Search for a printer driver to download</guilabel> option.
               </para>
             </listitem>
           </itemizedlist>
@@ -565,7 +560,7 @@
           <note>
             <title>Selecting a printer driver</title>
             <para>
-              On the right, the recommended printed driver is automatically selected; however, you can select another available driver. The print driver processes the data that you want to print into a format the printer can understand. Since a local printer is attached directly to your computer, you need a printer driver to process the data that is sent to the printer.
+              On the right, the recommended printer driver is automatically selected; however, you can select another available driver. The print driver processes the data that you want to print into a format the printer can understand. Since a local printer is attached directly to your computer, you need a printer driver to process the data that is sent to the printer.
             </para>
           </note>
           <figure  float="0"  id="fig-printconf-select-driver">
@@ -612,13 +607,13 @@
         </step>
         <step>
           <para>
-            After the changes are applied, a dialog box appears allowing you to print a test page. Click <guibutton>Print Test Page</guibutton> to print a test page now. Alternatively, you can print a test page also later, refer to <xref linkend="s1-printing-test-page" /> for details.
+            After the changes are applied, a dialog box appears allowing you to print a test page. Click <guibutton>Print Test Page</guibutton> to print a test page now. Alternatively, you can print a test page later as described in <xref linkend="s1-printing-test-page" />.
           </para>
         </step>
       </procedure>
     </section>
     <section id="s1-printing-test-page">
-      <title>Printing a test page</title>
+      <title>Printing a Test Page</title>
       <procedure id="proc-Printing_Test_Page">
         <para>
           After you have set up a printer or changed a printer configuration, print a test page to make sure the printer is functioning properly:
@@ -643,7 +638,7 @@
     <section id="s1-printing-edit">
       <title>Modifying Existing Printers</title>
       <para>
-        To delete an existing printer, in the <guilabel>Printer Configuration</guilabel> window, select the printer and go to <menuchoice><guimenu>Printer</guimenu><guimenuitem>Delete</guimenuitem></menuchoice>. Confirm the printer deletion. Alternatively, press the <keycap>Delete</keycap> key.
+        To delete an existing printer, in the <guilabel>Printer</guilabel> configuration window, select the printer and go to <menuchoice><guimenu>Printer</guimenu><guimenuitem>Delete</guimenuitem></menuchoice>. Confirm the printer deletion. Alternatively, press the <keycap>Delete</keycap> key.
       </para>
       <para>
         To set the default printer, right-click the printer in the printer list and click the <guimenuitem>Set As Default</guimenuitem> button in the context menu.
@@ -682,7 +677,7 @@
         <para>
           You can select the printer states, configure the <guilabel>Error Policy</guilabel> of the printer (you can decide to abort the print job, retry, or stop it if an error occurs).</para>
         <para>
-          You can also create a <firstterm>banner page</firstterm> (a page that describes aspects of the print job such as the originating printer, the username from the which the job originated, and the security status of the document being printed): click the <guilabel>Starting Banner </guilabel> or <guilabel>Ending Banner</guilabel> drop-menu and choose the option that best describes the nature of the print jobs (such as <guilabel>topsecret</guilabel>, <guilabel>classified</guilabel>, or <guilabel>confidential</guilabel>).
+          You can also create a <firstterm>banner page</firstterm> (a page that describes aspects of the print job such as the originating printer, the user name from the which the job originated, and the security status of the document being printed): click the <guilabel>Starting Banner</guilabel> or <guilabel>Ending Banner</guilabel> drop-down menu and choose the option that best describes the nature of the print jobs (for example, <guilabel>confidential</guilabel>).
         </para>
         <section id="sec-Sharing_Printers">
         <title>Sharing Printers</title>
@@ -693,9 +688,7 @@
           <para>
             On the <guilabel>Policies</guilabel> page, you can mark a printer as shared: if a printer is shared, users published on the network can use it. To allow the sharing function for printers, go to <menuchoice><guimenu>Server</guimenu><guimenuitem>Settings</guimenuitem></menuchoice> and select <guilabel>Publish shared printers connected to this system</guilabel>.
           </para>
-          <para>
-           Finally, ensure that the firewall allows incoming TCP connections to port 631, which is Network Printing Server (IPP) in system-config-firewall.
-          </para>
+
           <figure id="fig-printconf-config2">
             <title>Policies page</title>
             <mediaobject>
@@ -751,6 +744,7 @@
 
 
         </section>
+
        <section id="sec-The_Access_Control_Page">
         <title>The Access Control Page</title>
         <para>
@@ -792,7 +786,7 @@
       <section id="sec-Job_Options_Page">
         <title>Job Options Page</title>
         <para>
-          On the <guilabel>Job Options</guilabel> page, you can detail the printer job options. Click the <guilabel>Job Options</guilabel> label on the left to display the page. Edit the default settings to apply custom job options, such as number of copies, orientation, pages per side,scaling (increase or decrease the size of the printable area, which can be used to fit an oversize print area onto a smaller physical sheet of print medium), detailed text options, and custom job options.
+          On the <guilabel>Job Options</guilabel> page, you can detail the printer job options. Click the <guilabel>Job Options</guilabel> label on the left to display the page. Edit the default settings to apply custom job options, such as number of copies, orientation, pages per side, scaling (increase or decrease the size of the printable area, which can be used to fit an oversize print area onto a smaller physical sheet of print medium), detailed text options, and custom job options.
         </para>
         <figure id="fig-printconf-config5">
           <title>Job Options page</title>
@@ -867,7 +861,7 @@ Aaron-61                twaugh            1024   Tue 08 Feb 2011 16:42:44 GMT
 Ben-62                  root              1024   Tue 08 Feb 2011 16:45:42 GMT</screen>
       </example>
       <para>
-        If you want to cancel a print job, find the job number of the request with the command <command>lpstat -o</command> and then use the command <command>cancel <replaceable>job number</replaceable></command>. For example, <command>cancel 60</command> would cancel the print job in <xref linkend="lpq-example" />. You cannot cancel print jobs that were started by other users with the <command>cancel</command> command. However, you can enforce deletion of such job by issuing the <command>cancel -U root <replaceable>job_number</replaceable></command> command. To prevent such canceling, change the printer operation policy to <literal>Authenticated</literal> to force root authentication.
+        If you want to cancel a print job, find the job number of the request with the command <command>lpstat -o</command> and then use the command <command>cancel <replaceable>job number</replaceable></command>. For example, <command>cancel 60</command> would cancel the print job in <xref linkend="lpq-example" />. You cannot cancel print jobs that were started by other users with the <command>cancel</command> command. However, you can enforce deletion of such job by issuing the <command>cancel -U root <replaceable>job_number</replaceable></command> command. To prevent such canceling, change the printer operation policy to <literal>Authenticated</literal> to force <systemitem class="username">root</systemitem> authentication.
       </para>
       <para>
         You can also print a file directly from a shell prompt. For example, the command <command>lp sample.txt</command> prints the text file <filename>sample.txt</filename>. The print filter determines what type of file it is and converts it into a format the printer can understand.
@@ -877,7 +871,7 @@ Ben-62                  root              1024   Tue 08 Feb 2011 16:45:42 GMT</s
   <section id="s1-printing-additional-resources">
     <title>Additional Resources</title>
     <para>
-      To learn more about printing on &MAJOROS;, refer to the following resources.
+      To learn more about printing on &MAJOROS;, see the following resources.
     </para>
     <section id="s2-printing-additional-resources-installed">
       <title>Installed Documentation</title>


More information about the docs-commits mailing list