Changeset 89475857


Ignore:
Timestamp:
08/07/2012 02:20:14 PM (12 years ago)
Author:
Krejzi <krejzi@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
852554e1
Parents:
3b6b240f
Message:

Cups 1.6.1. Please check for gramatical errors and wrong instructions.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10491 af4574ff-66df-0310-9fd7-8a98e5e911e0

Files:
4 edited

Legend:

Unmodified
Added
Removed

  • general.ent

    r3b6b240f r89475857  
    44-->
    55
    6 <!ENTITY day          "01">                   <!-- Always 2 digits -->
     6<!ENTITY day          "07">                   <!-- Always 2 digits -->
    77<!ENTITY month        "08">                   <!-- Always 2 digits -->
    88<!ENTITY year         "2012">
    … …  
    1010<!ENTITY copyholder   "The BLFS Development Team">
    1111<!ENTITY version      "&year;-&month;-&day;">
    12 <!ENTITY releasedate  "August 1st, &year;">
     12<!ENTITY releasedate  "August 7th, &year;">
    1313<!-- <!ENTITY releasedate  "November &day;st, &year;"> -->
    1414<!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
    … …  
    11341134<!-- Part XII -->
    11351135<!-- Chapter 42 -->
    1136 <!ENTITY cups-version                 "1.5.0">
     1136<!ENTITY cups-version                 "1.6.1">
    11371137<!ENTITY LPRng-version                "3.8.B">
    11381138<!ENTITY gs-version                   "9.05">

  • introduction/welcome/changelog.xml

    r3b6b240f r89475857  
    4444
    4545-->
     46    <listitem>
     47      <para>August 7th, 2012</para>
     48      <itemizedlist>
     49        <listitem>
     50          <para>[krejzi] - CUPS 1.6.1.</para>
     51        </listitem>
     52      </itemizedlist>
     53    </listitem>
    4654
    4755    <listitem>

  • postlfs/config/users.xml

    r3b6b240f r89475857  
    7474        <row><entry>atd     </entry><entry>17</entry><entry>17</entry></row>
    7575        <row><entry>messagebus</entry><entry>18</entry><entry>18</entry></row>
    76         <!--<row><entry>haldaemon</entry><entry>19</entry><entry>19</entry></row> -->
     76        <row><entry>lpadmin </entry><entry></entry><entry>19</entry></row>
    7777        <row><entry>named   </entry><entry>20</entry><entry>20</entry></row>
    7878        <row><entry>gdm     </entry><entry>21</entry><entry>21</entry></row>

  • pst/printing/cups.xml

    r3b6b240f r89475857  
    77  <!ENTITY cups-download-http "http://ftp.easysw.com/pub/cups/&cups-version;/cups-&cups-version;-source.tar.bz2">
    88  <!ENTITY cups-download-ftp  "ftp://ftp.easysw.com/pub/cups/&cups-version;/cups-&cups-version;-source.tar.bz2">
    9   <!ENTITY cups-md5sum        "e54ed09ede2340fc3014913333520fe4">
    10   <!ENTITY cups-size          "3.9 MB">
    11   <!ENTITY cups-buildsize     "91 MB">
    12   <!ENTITY cups-time          "0.7 SBU">
     9  <!ENTITY cups-md5sum        "87ade07e3d1efd03c9c3add949cf9c00">
     10  <!ENTITY cups-size          "7.9 MB">
     11  <!ENTITY cups-buildsize     "90 MB">
     12  <!ENTITY cups-time          "1.2 SBU">
    1313]>
    1414
    … …  
    3030    <title>Introduction to Cups</title>
    3131
    32     <para>The Common Unix Printing System (CUPS) is a print spooler and
    33     associated utilities. It is based on the "Internet Printing
    34     Protocol" and provides printing services to most PostScript and raster
    35     printers.</para>
     32    <para>
     33      The Common Unix Printing System (CUPS) is a print spooler and
     34      associated utilities. It is based on the "Internet Printing
     35      Protocol" and provides printing services to most PostScript
     36      and raster printers.
     37    </para>
    3638
    3739    &lfs71_checked;
    … …  
    4042    <itemizedlist spacing="compact">
    4143      <listitem>
    42         <para>Download (HTTP): <ulink url="&cups-download-http;"/></para>
     44        <para>
     45          Download (HTTP): <ulink url="&cups-download-http;"/>
     46        </para>
    4347      </listitem>
    4448      <listitem>
    45         <para>Download (FTP): <ulink url="&cups-download-ftp;"/></para>
     49        <para>
     50          Download (FTP): <ulink url="&cups-download-ftp;"/>
     51        </para>
    4652      </listitem>
    4753      <listitem>
    48         <para>Download MD5 sum: &cups-md5sum;</para>
     54        <para>
     55          Download MD5 sum: &cups-md5sum;
     56        </para>
    4957      </listitem>
    5058      <listitem>
    51         <para>Download size: &cups-size;</para>
     59        <para>
     60          Download size: &cups-size;
     61        </para>
    5262      </listitem>
    5363      <listitem>
    54         <para>Estimated disk space required: &cups-buildsize;</para>
     64        <para>
     65          Estimated disk space required: &cups-buildsize;
     66        </para>
    5567      </listitem>
    5668      <listitem>
    57         <para>Estimated build time: &cups-time;</para>
     69        <para>
     70          Estimated build time: &cups-time;
     71        </para>
    5872      </listitem>
    5973    </itemizedlist>
    … …  
    6377    <bridgehead renderas="sect4">Recommended</bridgehead>
    6478    <para role="recommended">
    65       <xref linkend="libjpeg"/>,
    66       <xref linkend="libpng"/>, and
    67       <xref linkend="libtiff"/>
     79      <xref linkend="colord"/>,
     80      <xref linkend="dbus"/> and
     81      <xref linkend="libusb"/>
    6882    </para>
    6983
    7084    <bridgehead renderas="sect4">Optional</bridgehead>
    7185    <para role="optional">
    72       <xref linkend="dbus"/>,
    73       <xref linkend="libusb"/>,
    7486      <xref linkend="acl"/>,
    75       <xref linkend="linux-pam"/>,
    76       <xref linkend="openldap"/>,
    77       <xref linkend="gnutls"/> or <xref linkend="openssl"/> (looked for in that
    78       order), <xref linkend="mitkrb"/>,
    79       <xref linkend="php"/>,
    80       <xref linkend="gs"/>,
    81       <xref linkend="python2"/>,
    82       <xref linkend="openjdk"/>,
    83       <ulink url="http://portland.freedesktop.org/wiki/">Xdg-utils</ulink>,
    84       <ulink url="http://www.openslp.org/">OpenSLP</ulink>,
     87      <xref linkend="avahi"/>,
     88      <xref linkend="gnutls"/> or <xref linkend="openssl"/>,
    8589      <ulink
    8690      url="http://packages.debian.org/source/sid/libpaper">libpaper</ulink>,
    87       <ulink url="http://www.easysw.com/htmldoc/">HTMLDOC</ulink>, and
    88       <ulink url="http://valgrind.org/">Valgrind</ulink> (optionally used if
    89       running the test suites)
     91      <xref linkend="linux-pam"/>,
     92      <xref linkend="mitkrb"/>,
     93      <xref linkend="openjdk"/>,
     94      <xref linkend="php"/>,
     95      <xref linkend="python2"/>,
     96      <!-- <ulink url="http://valgrind.org/">Valgrind</ulink>
     97      (optionaly used during the test suites) -->and
     98      <xref linkend="xdg-utils"/>
    9099    </para>
    91100
    92101    <para condition="html" role="usernotes">User Notes:
    93     <ulink url="&blfs-wiki;/cups"/></para>
    94 
     102      <ulink url="&blfs-wiki;/cups"/>
     103    </para>
    95104  </sect2>
    96105
    … …  
    98107    <title>Kernel Configuration</title>
    99108
    100     <para>If you have a parallel printer enable the following options in your
    101     kernel configuration and recompile the kernel:</para>
    102 
    103 <screen><literal>Device Drivers  ---&gt;
    104   [*] Parallel port support  ---&gt;
    105     [*]   PC-style hardware
    106 ...
    107   Character devices  ---&gt;
    108     [*] Parallel printer support</literal></screen>
    109 
    110     <note><para>If you have a USB printer there is a conflict between the
    111     <application>Cups</application> <application>libusb</application>
    112     backend and the kernel driver. If you want to use
    113     <application>Cups</application> with <application>libusb</application>
    114     support <emphasis>do not</emphasis> enable USB Printer support in your
    115     kernel and remove the <option>--disable-libusb</option> when you
    116     configure <application>Cups</application>.</para></note>
    117 
    118     <para>If you want to use the kernel usblp driver enable the following
    119     options in your kernel configuration and recompile the kernel:</para>
     109    <note>
     110      <para>
     111        There is a conflict between the <application>Cups</application>
     112        <application>libusb</application> backend and the usblp kernel
     113        driver. If you want to use <application>Cups</application> with
     114        <application>libusb</application> <emphasis>do not</emphasis>
     115        enable USB Printer support in your kernel.
     116      </para>
     117    </note>
     118
     119    <para>
     120      If you want to use the kernel usblp driver enable the following
     121      options in your kernel configuration and recompile the kernel:
     122    </para>
    120123
    121124<screen>Device Drivers  ---&gt;
    … …  
    128131    [*]   USB Printer support</screen>
    129132
     133    <para>
     134      If you have a parallel printer enable the following options in your
     135      kernel configuration and recompile the kernel:
     136    </para>
     137
     138<screen><literal>Device Drivers  ---&gt;
     139  [*] Parallel port support  ---&gt;
     140    [*]   PC-style hardware
     141...
     142  Character devices  ---&gt;
     143    [*] Parallel printer support</literal></screen>
     144
    130145    <indexterm zone="cups cups-kernel">
    131146      <primary sortas="d-cups">cups</primary>
    … …  
    137152    <title>Installation of Cups</title>
    138153
    139     <para>Create an <systemitem class="username">lp</systemitem> user, as
    140     <application>Cups</application> will create some files owned by this user.
    141     (The <systemitem class="username">lp</systemitem> user is the default used
    142     by <application>Cups</application>, but may be changed to a different user
    143     by passing a parameter to the <command>configure</command> script.) Use the
    144     following command as the <systemitem class="username">root</systemitem>
    145     user:</para>
    146 
    147 <screen role="root"><userinput>useradd -c "Print Service User" -d /dev/null -g lp -s /bin/false -u 9 lp</userinput></screen>
    148 
    149     <para>Install <application>Cups</application> by running the
    150     following commands:</para>
    151 
    152 <screen><userinput>sed -i 's#@CUPS_HTMLVIEW@#firefox#' desktop/cups.desktop.in &amp;&amp;
    153 ./configure --localstatedir=/var       \
    154             --disable-libusb           \
    155             --with-rcdir=/tmp/cupsinit \
    156             --with-docdir=/usr/share/doc/cups-&cups-version; &amp;&amp;
     154    <para>
     155      You will need to add the <systemitem class="username">lp</systemitem>
     156      user, as <application>Cups</application> will create some files owned
     157      by this user. (The <systemitem class="username">lp</systemitem> user
     158      is the default used by <application>Cups</application>, but may be
     159      changed to a different user by passing a parameter to the
     160      <command>configure</command> script.) Use the following command as
     161      the <systemitem class="username">root</systemitem> user:
     162    </para>
     163
     164<screen role="root"><userinput>useradd -c "Print Service User" -d /var/spool/cups -g lp -s /bin/false -u 9 lp</userinput></screen>
     165
     166    <para>
     167      You will also need dedicated group that will contain users allowed to
     168      do <application>Cups</application> administrative tasks. Add the group
     169      by running the following command as the
     170      <systemitem class="username">root</systemitem> user:
     171    </para>
     172
     173<screen role="root"><userinput>groupadd -g 19 lpadmin</userinput></screen>
     174
     175    <para>
     176      If you want to add an user to the <application>Cups</application>
     177      administrative group, run the following command as the
     178      <systemitem class="username">root</systemitem> user:
     179    </para>
     180
     181<screen role="root"><userinput>usermod -a -G lpadmin <replaceable>&lt;username&gt;</replaceable></userinput></screen>
     182
     183    <para>
     184      If you didn't install <xref linkend="xdg-utils"/>, use the following
     185      <command>sed</command> to change the default browser that will be used
     186      to access the <application>Cups</application> web interface:
     187    </para>
     188
     189<screen><userinput>sed -i 's#@CUPS_HTMLVIEW@#firefox#' desktop/cups.desktop.in</userinput></screen>
     190
     191    <para>
     192      Replace <command>firefox</command> with the web browser of your
     193      choice.
     194    </para>
     195
     196    <para>
     197      Install <application>Cups</application> by running the
     198      following commands:
     199    </para>
     200
     201    <!-- docdir is also document root for cups administration interface, so
     202    let's just put it in /usr/share/cups/doc and create symlink in
     203    /usr/share/doc -->
     204<screen><userinput>./configure --with-rcdir=/tmp/cupsinit \
     205            --with-docdir=/usr/share/cups/doc \
     206            --with-system-groups=lpadmin &amp;&amp;
    157207make</userinput></screen>
    158208
    159     <para>To test the results, issue: <command>make check</command>. This will
    160     run a basic test suite without any load testing. If you wish to run the
    161     tests specifying non-default parameters, issue:
    162     <command>make test</command>. Note that the <quote>torture load
    163     testing</quote> test uses more resources than those displayed in the
    164     prompt.</para>
    165 
    166     <para>Now, as the <systemitem class="username">root</systemitem>
    167     user:</para>
     209   <para>
     210     This package does not have working testsuite.
     211   </para>
     212
     213<!-- Testsuite is broken. It fails at colord tests, and before that I get
     214     lot of "document format not supported".
     215
     216    <para>
     217      To test the results, issue: <command>make check</command>. This will
     218      run a basic test suite without any load testing. If you wish to run
     219      the tests specifying non-default parameters, issue:
     220      <command>make test</command>. Note that the <quote>torture load
     221      testing</quote> test uses more resources than those displayed in the
     222      prompt.
     223    </para>
     224-->
     225
     226    <para>
     227      Now, as the <systemitem class="username">root</systemitem>
     228      user:
     229    </para>
    168230
    169231<screen role="root"><userinput>make install &amp;&amp;
    170 rm -rf /tmp/cupsinit</userinput></screen>
    171 
    172     <para>The <application>man</application> files are installed in compressed
    173     (<filename class="extension">.gz</filename>) format. If desired, use the
    174     following commands to uncompress them as the
    175     <systemitem class="username">root</systemitem> user:</para>
     232rm -rf /tmp/cupsinit &amp;&amp;
     233ln -sv ../cups/doc /usr/share/doc/cups-&cups-version;</userinput></screen>
     234
     235<!-- Not all raw usb printer device nodes have root:lp owner. -->
     236    <para>
     237      If you have built <application>Cups</application> with
     238      <application>libusb</application> support, fix the
     239      backend permissions so that it will be executed as the
     240      <systemitem class="username">root</systemitem> user.
     241      Run the following command as the
     242      <systemitem class="username">root</systemitem> user:
     243    </para>
     244
     245<screen role="root"><userinput>chmod -v 744 /usr/lib/cups/backend/usb</userinput></screen>
     246
     247    <para>
     248      The <application>man</application> files are installed in compressed
     249      (<filename class="extension">.gz</filename>) format. If desired,
     250      use the following commands to uncompress them as the
     251      <systemitem class="username">root</systemitem> user:
     252    </para>
    176253
    177254<screen role="root"><userinput>pushd /usr/share/man/                                  &amp;&amp;
    … …  
    190267    <title>Command Explanations</title>
    191268
    192     <para><command>sed -i 's#@CUPS_HTMLVIEW@#firefox#' ...</command>: This
    193      changes the browser that the <application>Cups</application> desktop file
    194      uses for its web interface.</para>
    195 
    196     <para><option>--localstatedir=/var</option>: This changes the location of
    197     the cache, log, run and spool directories from /usr/var to /var.</para>
    198 
    199     <para><option>--disable-libusb</option>: This disables the
    200     <application>Cups</application> <application>libusb</application> backend.
    201     If you&apos;d like <application>Cups</application> to use
    202     <application>libusb</application>, delete this option and make sure you
    203     compile your kernel with: # CONFIG_USB_PRINTER is not set</para>
    204 
    205     <para><option>--with-rcdir=/tmp/cupsinit</option>: This option makes it install its
    206     bootscript into <filename class="directory">/tmp</filename> instead of
    207     <filename class="directory">/etc/rc.d</filename>.</para>
     269    <para>
     270      <parameter>--with-rcdir=/tmp/cupsinit</parameter>: This switch tells
     271      build process to install the shipped bootscript into
     272      <filename class="directory">/tmp</filename> instead of
     273      <filename class="directory">/etc/rc.d</filename>.
     274    </para>
     275
     276<!-- There isn't any class="group" so I had to use class="username" here -->
     277    <para>
     278      <parameter>--with-system-groups=lpadmin</parameter>: This switch ensures
     279      that only <systemitem class="username">lpadmin</systemitem> will be used as
     280      the <application>Cups</application> administrative group.
     281    </para>
     282
     283    <para>
     284      <option>--disable-libusb</option>: Use this switch if you have installed
     285      <xref linkend="libusb"/>, but wish to use the kernel usblp driver.
     286    </para>
     287
     288    <para>
     289      <option>--enable-libpaper</option>: Use this switch if you have installed
     290      <application>libpaper</application> and wish to use it with
     291      <application>Cups</application>.
     292    </para>
     293
     294    <para>
     295      <option>--disable-gnutls --enable-openssl</option>: This switch tells build
     296      process to use <xref linkend="openssl"/> instead of <xref linkend="gnutls"/>.
     297      Current version of <application>GnuTLS</application> might produce lot of
     298      warnings during the <application>Cups</application> build.
     299    </para>
    208300
    209301  </sect2>
    … …  
    212304    <title>Configuring Cups</title>
    213305
    214     <para>Configuration of <application>Cups</application> is dependent on
    215     the type of printer and can be complex. Generally, PostScript printers
    216     are easier. For detailed instructions on configuration and use of
    217     <application>Cups</application>, see <ulink
    218     url="http://www.cups.org/documentation.php"/>. The Software Administrators
    219     Manual and Software Users Manual are particularly useful.</para>
    220 
    221     <para>For non-PostScript printers to print with
    222     <application>Cups</application>, you need to install <xref linkend="gs"/>
    223     to convert PostScript to raster images and a driver (e.g., from
    224     <xref linkend="gutenprint"/>) to convert the resulting raster images to a
    225     form that the printer understands.
    226     <ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>
    227     drivers use Ghostscript to convert PostScript to a printable form directly,
    228     but this is considered to be a hack by
    229     <application>Cups</application> developers.</para>
     306    <para>
     307      Configuration of <application>Cups</application> is dependent on
     308      the type of printer and can be complex. Generally, PostScript printers
     309      are easier. For detailed instructions on configuration and use of
     310      <application>Cups</application>, see <ulink
     311      url="http://www.cups.org/documentation.php"/>. The Software
     312      Administrators Manual and Software Users Manual are particularly useful.
     313    </para>
     314
     315    <para>
     316      For non-PostScript printers to print with
     317      <application>Cups</application>, you need to install <xref linkend="gs"/>
     318      to convert PostScript to raster images and a driver (e.g., from
     319      <xref linkend="gutenprint"/>) to convert the resulting raster images to a
     320      form that the printer understands.
     321      <ulink url="http://www.linuxprinting.org/foomatic.html">Foomatic</ulink>
     322      drivers use Ghostscript to convert PostScript to a printable form directly,
     323      but this is considered to be a hack by <application>Cups</application>
     324      developers.
     325    </para>
     326
     327    <sect3>
     328      <title>Linux PAM Configuration</title>
     329
     330      <para>
     331        The default <application>Cups</application>
     332        <application>PAM</application> configuration file should
     333        work by default. However, it does not make use of the
     334        BLFS specific <application>PAM</application>
     335        configuration files.
     336      </para>
     337
     338      <para>
     339        If you have built <application>Cups</application> with
     340        <application>PAM</application> support, create
     341        BLFS specific <application>PAM</application>
     342        configuration file by running the following command as
     343        the <systemitem class="username">root</systemitem> user:
     344      </para>
     345
     346<screen role="root"><userinput>cat &gt;&gt; /etc/pam.d/cups &lt;&lt; "EOF"
     347# Begin /etc/pam.d/cups
     348
     349auth    include system-auth
     350account include system-account
     351session include system-session
     352
     353# End /etc/pam.d/cups
     354EOF</userinput></screen>
     355
     356    </sect3>
    230357
    231358    <sect3 id="cups-init">
    232359      <title>Boot Script</title>
    233360
    234       <para>If you want the <application>Cups</application> to start
    235       automatically when the system is booted, install the init script included
    236       in the <xref linkend="bootscripts"/> package:</para>
     361      <para>
     362        If you want the <application>Cups</application> to start
     363        automatically when the system is booted, install the init
     364        script included in the <xref linkend="bootscripts"/>
     365        package:
     366      </para>
    237367
    238368      <indexterm zone="cups cups-init">
    … …  
    255385
    256386      <seglistitem>
    257         <seg>accept, cancel, cups-config, cupsaccept, cupsaddsmb, cupsctl,
    258         cupsd, cupsdisable, cupsenable, cupsfilter, cupsreject, cupstestdsc,
    259         cupstestppd, lp, lpadmin, lpc, lpinfo, lpmove, lpoptions, lppasswd,
    260         lpq, lpr, lprm, lpstat, ppdc, ppdhtml, ppdi, ppdmerge, ppdpo,
    261         reject</seg>
    262         <seg>libcups.so, libcupscgi.so, libcupsdriver.so,
    263         libcupsimage.so, libcupsmime.so, libcupsppdc.so, and
    264         various filters and backend drivers</seg>
    265         <seg>/etc/cups, /usr/include/cups, /usr/lib/cups, /usr/share/cups,
    266         /usr/share/doc/cups-&cups-version;, /var/cache/cups, /var/log/cups,
    267         /var/run/cups and /var/spool/cups.</seg>
     387        <seg>
     388          accept, cancel, cupsaccept, cupsaddsmb, cups-config,
     389          cupsctl, cupsd, cupsdisable, cupsenable, cupsfilter,
     390          cupsreject, cupstestdsc, cupstestppd, ipptool, lp,
     391          lpadmin, lpc, lpinfo, lpmove, lpoptions, lppasswd,
     392          lpq, lpr, lprm, lpstat, ppdc, ppdhtml, ppdi, ppdmerge,
     393          ppdpo and reject
     394        </seg>
     395        <seg>
     396          libcupscgi.so, libcupsimage.so, libcupsmime.so,
     397          libcupsppdc.so and libcups.so
     398        </seg>
     399        <seg>
     400          /etc/cups,
     401          /usr/include/cups,
     402          /usr/lib/cups,
     403          /usr/share/cups,
     404          /usr/share/doc/cups-&cups-version;,
     405          /var/cache/cups,
     406          /var/log/cups,
     407          /var/run/cups and
     408          /var/spool/cups
     409        </seg>
    268410      </seglistitem>
    269411    </segmentedlist>
    … …  
    277419        <term><command>accept</command></term>
    278420        <listitem>
    279           <para>instructs the printing system to accept print jobs to the
    280           specified destinations.</para>
     421          <para>
     422            instructs the printing system to accept print jobs to the
     423            specified destinations.
     424          </para>
    281425          <indexterm zone="cups accept">
    282426            <primary sortas="b-accept">accept</primary>
    … …  
    288432        <term><command>cancel</command></term>
    289433        <listitem>
    290           <para>cancels existing print jobs from the print queues.</para>
     434          <para>
     435            cancels existing print jobs from the print queues.
     436          </para>
    291437          <indexterm zone="cups cancel-cups">
    292438            <primary sortas="b-cancel">cancel</primary>
    … …  
    295441      </varlistentry>
    296442
     443      <varlistentry id="cupsaddsmb">
     444        <term><command>cupsaddsmb</command></term>
     445        <listitem>
     446          <para>
     447            exports printers to the <application>Samba</application>
     448            software for use with Windows clients.
     449          </para>
     450          <indexterm zone="cups cupsaddsmb">
     451            <primary sortas="b-cupsaddsmb">cupsaddsmb</primary>
     452          </indexterm>
     453        </listitem>
     454      </varlistentry>
     455
    297456      <varlistentry id="cups-config">
    298457        <term><command>cups-config</command></term>
    299458        <listitem>
    300           <para>is a <application>Cups</application>
    301           program configuration utility.</para>
     459          <para>
     460            is a <application>Cups</application>
     461            program configuration utility.
     462          </para>
    302463          <indexterm zone="cups cups-config">
    303464            <primary sortas="b-cups-config">cups-config</primary>
    … …  
    306467      </varlistentry>
    307468
    308       <varlistentry id="cupsaddsmb">
    309         <term><command>cupsaddsmb</command></term>
    310         <listitem>
    311           <para>exports printers to the <application>Samba</application>
    312           software for use with Windows clients.</para>
    313           <indexterm zone="cups cupsaddsmb">
    314             <primary sortas="b-cupsaddsmb">cupsaddsmb</primary>
     469      <varlistentry id="cupsctl">
     470        <term><command>cupsctl</command></term>
     471        <listitem>
     472          <para>
     473            updates or queries the cupsd.conf file for a server.
     474          </para>
     475          <indexterm zone="cups cupsctl">
     476            <primary sortas="b-cupsctl">cupsctl</primary>
    315477          </indexterm>
    316478        </listitem>
    … …  
    320482        <term><command>cupsd</command></term>
    321483        <listitem>
    322           <para>is the scheduler for the Common Unix Printing System.</para>
     484          <para>
     485            is the scheduler for the Common Unix Printing System.
     486          </para>
    323487          <indexterm zone="cups cupsd">
    324488            <primary sortas="b-cupsd">cupsd</primary>
    … …  
    327491      </varlistentry>
    328492
     493      <varlistentry id="cupsfilter">
     494        <term><command>cupsfilter</command></term>
     495        <listitem>
     496          <para>
     497            is a front-end to the <application>Cups</application>
     498            filter subsystem which allows you to convert a file
     499            to a specific format.
     500          </para>
     501          <indexterm zone="cups cupsfilter">
     502            <primary sortas="b-cupsfilter">cupsfilter</primary>
     503          </indexterm>
     504        </listitem>
     505      </varlistentry>
     506
     507      <varlistentry id="cupstestdsc">
     508        <term><command>cupstestdsc</command></term>
     509        <listitem>
     510          <para>
     511            tests the conformance of PostScript files.
     512          </para>
     513          <indexterm zone="cups cupstestdsc">
     514            <primary sortas="b-cupstestdsc">cupstestdsc</primary>
     515          </indexterm>
     516        </listitem>
     517      </varlistentry>
     518
    329519      <varlistentry id="cupstestppd">
    330520        <term><command>cupstestppd</command></term>
    331521        <listitem>
    332           <para>tests the conformance of PPD files.</para>
     522          <para>
     523            tests the conformance of PPD files.
     524          </para>
    333525          <indexterm zone="cups cupstestppd">
    334526            <primary sortas="b-cupstestppd">cupstestppd</primary>
    … …  
    337529      </varlistentry>
    338530
    339       <varlistentry id="disable">
    340         <term><command>disable</command></term>
    341         <listitem>
    342           <para>stops the named printers or classes.</para>
    343           <indexterm zone="cups disable">
    344             <primary sortas="b-disable">disable</primary>
    345           </indexterm>
    346         </listitem>
    347       </varlistentry>
    348 
    349       <varlistentry id="enable">
    350         <term><command>enable</command></term>
    351         <listitem>
    352           <para>starts the named printers or classes.</para>
    353           <indexterm zone="cups enable">
    354             <primary sortas="b-enable">enable</primary>
     531      <varlistentry id="ipptool">
     532        <term><command>ipptool</command></term>
     533        <listitem>
     534          <para>
     535            sends IPP requests to the specified URI and tests
     536            and/or displays the results.
     537          </para>
     538          <indexterm zone="cups ipptool">
     539            <primary sortas="b-ipptool">ipptool</primary>
    355540          </indexterm>
    356541        </listitem>
    … …  
    360545        <term><command>lp</command></term>
    361546        <listitem>
    362           <para>submits files for printing or alters a pending job.</para>
     547          <para>
     548            submits files for printing or alters a pending job.
     549          </para>
    363550          <indexterm zone="cups lp-cups">
    364551            <primary sortas="b-lp">lp</primary>
    … …  
    370557        <term><command>lpadmin</command></term>
    371558        <listitem>
    372           <para>configures printer and class queues provided by
    373           <application>Cups</application>.</para>
     559          <para>
     560            configures printer and class queues provided by
     561            <application>Cups</application>.
     562          </para>
    374563          <indexterm zone="cups lpadmin">
    375564            <primary sortas="b-lpadmin">lpadmin</primary>
    … …  
    381570        <term><command>lpc</command></term>
    382571        <listitem>
    383           <para> provides limited control over printer and class queues
    384           provided by <application>Cups</application>.</para>
     572          <para>
     573            provides limited control over printer and class queues
     574            provided by <application>Cups</application>.
     575          </para>
    385576          <indexterm zone="cups lpc-cups">
    386577            <primary sortas="b-lpc">lpc</primary>
    … …  
    392583        <term><command>lpinfo</command></term>
    393584        <listitem>
    394           <para>lists the available devices or drivers known to the
    395           <application>Cups</application> server.</para>
     585          <para>
     586            lists the available devices or drivers known to the
     587            <application>Cups</application> server.
     588          </para>
    396589          <indexterm zone="cups lpinfo">
    397590            <primary sortas="b-lpinfo">lpinfo</primary>
    … …  
    403596        <term><command>lpmove</command></term>
    404597        <listitem>
    405           <para>moves the specified job to a new destination.</para>
     598          <para>
     599            moves the specified job to a new destination.
     600          </para>
    406601          <indexterm zone="cups lpmove">
    407602            <primary sortas="b-lpmove">lpmove</primary>
    … …  
    413608        <term><command>lpoptions</command></term>
    414609        <listitem>
    415           <para>displays or sets printer options and defaults.</para>
     610          <para>
     611            displays or sets printer options and defaults.
     612          </para>
    416613          <indexterm zone="cups lpoptions">
    417614            <primary sortas="b-lpoptions">lpoptions</primary>
    … …  
    423620        <term><command>lppasswd</command></term>
    424621        <listitem>
    425           <para>adds, changes or deletes passwords in the
    426           <application>Cups</application> digest password file
    427           <filename>passwd.md5</filename>.</para>
     622          <para>
     623            adds, changes or deletes passwords in the
     624            <application>Cups</application> digest password file
     625            <filename>passwd.md5</filename>.
     626          </para>
    428627          <indexterm zone="cups lppasswd">
    429628            <primary sortas="b-lppasswd">lppasswd</primary>
    … …  
    435634        <term><command>lpq</command></term>
    436635        <listitem>
    437           <para>shows the current print queue status on the named printer.</para>
     636          <para>
     637            shows the current print queue status on the named printer.
     638          </para>
    438639          <indexterm zone="cups lpq-cups">
    439640            <primary sortas="b-lpq">lpq</primary>
    … …  
    445646        <term><command>lpr</command></term>
    446647        <listitem>
    447           <para>submits files for printing.</para>
     648          <para>
     649            submits files for printing.
     650          </para>
    448651          <indexterm zone="cups lpr-cups">
    449652            <primary sortas="b-lpr">lpr</primary>
    … …  
    455658        <term><command>lprm</command></term>
    456659        <listitem>
    457           <para>cancels print jobs that have been queued for printing.</para>
     660          <para>
     661            cancels print jobs that have been queued for printing.
     662          </para>
    458663          <indexterm zone="cups lprm-cups">
    459664            <primary sortas="b-lprm">lprm</primary>
    … …  
    465670        <term><command>lpstat</command></term>
    466671        <listitem>
    467           <para>displays status information about the current classes, jobs,
    468           and printers.</para>
     672          <para>
     673            displays status information about the current classes, jobs,
     674            and printers.
     675          </para>
    469676          <indexterm zone="cups lpstat-cups">
    470677            <primary sortas="b-lpstat">lpstat</primary>
    … …  
    473680      </varlistentry>
    474681
     682      <varlistentry id="ppdc">
     683        <term><command>ppdc</command></term>
     684        <listitem>
     685          <para>
     686            compiles PPDC source files into one or more PPD files.
     687          </para>
     688          <indexterm zone="cups ppdc">
     689            <primary sortas="b-ppdc">ppdc</primary>
     690          </indexterm>
     691        </listitem>
     692      </varlistentry>
     693
     694      <varlistentry id="ppdhtml">
     695        <term><command>ppdhtml</command></term>
     696        <listitem>
     697          <para>
     698            reads a driver information file and produces a HTML summary
     699            page that lists all of the drivers in a file and the
     700            supported options.
     701          </para>
     702          <indexterm zone="cups ppdhtml">
     703            <primary sortas="b-ppdhtml">ppdhtml</primary>
     704          </indexterm>
     705        </listitem>
     706      </varlistentry>
     707
     708      <varlistentry id="ppdi">
     709        <term><command>ppdi</command></term>
     710        <listitem>
     711          <para>
     712            imports one or more PPD files into a PPD compiler source file.
     713          </para>
     714          <indexterm zone="cups ppdi">
     715            <primary sortas="b-ppdi">ppdi</primary>
     716          </indexterm>
     717        </listitem>
     718      </varlistentry>
     719
     720      <varlistentry id="ppdmerge">
     721        <term><command>ppdmerge</command></term>
     722        <listitem>
     723          <para>
     724            merges two or more PPD files into a single, multi-language
     725            PPD file.
     726          </para>
     727          <indexterm zone="cups ppdmerge">
     728            <primary sortas="b-ppdmerge">ppdmerge</primary>
     729          </indexterm>
     730        </listitem>
     731      </varlistentry>
     732
     733      <varlistentry id="ppdpo">
     734        <term><command>ppdpo</command></term>
     735        <listitem>
     736          <para>
     737            extracts UI strings from PPDC source files and
     738            updates either a GNU gettext or Mac OS X strings
     739            format message catalog source file for translation.
     740          </para>
     741          <indexterm zone="cups ppdpo">
     742            <primary sortas="b-ppdpo">ppdpo</primary>
     743          </indexterm>
     744        </listitem>
     745      </varlistentry>
     746
    475747      <varlistentry id="reject">
    476748        <term><command>reject</command></term>
    477749        <listitem>
    478           <para>instructs the printing system to reject print jobs to the
    479           specified destinations.</para>
     750          <para>
     751            instructs the printing system to reject print jobs to the
     752            specified destinations.
     753          </para>
    480754          <indexterm zone="cups reject">
    481755            <primary sortas="b-reject">reject</primary>
    … …  
    484758      </varlistentry>
    485759
     760      <varlistentry id="libcups">
     761        <term><filename class="libraryfile">libcups.so</filename></term>
     762        <listitem>
     763          <para>
     764            contains the <application>Cups</application> API functions.
     765          </para>
     766          <indexterm zone="cups libcups">
     767            <primary sortas="c-libcups">libcups.so</primary>
     768          </indexterm>
     769        </listitem>
     770      </varlistentry>
     771
    486772    </variablelist>
    487773
Note: See TracChangeset for help on using the changeset viewer.