Author: randy Date: 2005-04-09 22:51:53 -0600 (Sat, 09 Apr 2005) New Revision: 3697
Modified: trunk/BOOK/general.ent trunk/BOOK/pst/printing/cups.xml Log: Updated build entities and added indexing tags to CUPS instructions Modified: trunk/BOOK/general.ent =================================================================== --- trunk/BOOK/general.ent 2005-04-09 06:13:21 UTC (rev 3696) +++ trunk/BOOK/general.ent 2005-04-10 04:51:53 UTC (rev 3697) @@ -1,4 +1,4 @@ -<!ENTITY day "09"> +<!ENTITY day "10"> <!ENTITY month "04"> <!ENTITY year "2005"> <!ENTITY version "svn-&year;&month;&day;"> Modified: trunk/BOOK/pst/printing/cups.xml =================================================================== --- trunk/BOOK/pst/printing/cups.xml 2005-04-09 06:13:21 UTC (rev 3696) +++ trunk/BOOK/pst/printing/cups.xml 2005-04-10 04:51:53 UTC (rev 3697) @@ -7,8 +7,8 @@ <!ENTITY cups-download-ftp "ftp://ftp.easysw.com/pub/cups/&cups-version;/cups-&cups-version;-source.tar.bz2";> <!ENTITY cups-md5sum "4ce09b1dce09b6b9398af0daae9adf63"> <!ENTITY cups-size "8.7 MB"> - <!ENTITY cups-buildsize "46 MB"> - <!ENTITY cups-time "0.54 SBU (additional 69 SBU to run full test suite)"> + <!ENTITY cups-buildsize "48 MB"> + <!ENTITY cups-time "0.52 SBU (additional 69 SBU to run full test suite)"> ]> <sect1 id="cups" xreflabel="CUPS-&cups-version;"> @@ -18,6 +18,8 @@ </sect1info> <?dbhtml filename="cups.html"?> <title>CUPS-&cups-version;</title> +<indexterm zone="cups"> +<primary sortas="a-CUPS">CUPS</primary></indexterm> <sect2> <title>Introduction to @@ -95,9 +97,12 @@ running the following commands:</para> <screen><userinput><command>./configure && -make && -make install</command></userinput></screen> +make</command></userinput></screen> +<para>Now, as the root user:</para> + +<screen><userinput role='root'><command>make install</command></userinput></screen> + </sect2> <sect2> @@ -133,11 +138,14 @@ this is considered to be a hack by <application><acronym>CUPS</acronym></application> developers.</para> -<para>During the install, <application><acronym>CUPS</acronym></application> +<para id="cups-init">During the install, +<application><acronym>CUPS</acronym></application> created the startup file <command>/etc/rc.d/init.d/cups</command>. The file works, but you may want to change it to a more conventional <acronym>LFS</acronym> startup file by installing the script included in the <xref linkend="intro-important-bootscripts"/> package:</para> +<indexterm zone="cups cups-init"> +<primary sortas="f-cups">cups</primary></indexterm> <screen><userinput><command>make install-cups</command></userinput></screen> @@ -146,126 +154,198 @@ <sect2> <title>Contents</title> -<para><application><acronym>CUPS</acronym></application> provides -<command>accept</command>, -<command>cupsaddsmb</command>, -<command>cupsd</command>, -<command>cupstestppd</command>, -<command>lpadmin</command>, -<command>lpc</command>, -<command>lpinfo</command>, -<command>lpmove</command>, -<command>reject</command>, -<command>cancel</command>, -<command>cups-config</command>, -<command>disable</command>, -<command>enable</command>, -<command>lp</command>, -<command>lpoptions</command>, -<command>lppasswd</command>, -<command>lpq</command>, -<command>lpr</command>, -<command>lprm</command>, -<command>lpstat</command>, -<filename class="libraryfile">libcups</filename>, -<filename class="libraryfile">libcupsimage</filename> and various -scripts and filters.</para> +<segmentedlist> +<segtitle>Installed Programs</segtitle> +<segtitle>Installed Libraries</segtitle> +<segtitle>Installed Directories</segtitle> -<sect3><title>lpc</title> -<para><command>lpc</command> provides limited control over printer -and class queues provided by <application><acronym>CUPS</acronym> -</application>. -</para></sect3> +<seglistitem> +<seg>accept, cancel, cups-config, cupsaddsmb, cupsd, cupstestppd, disable, +enable, lp, lpadmin, lpc, lpinfo, lpmove, lpoptions, lppasswd, lpq, lpr, +lprm, lpstat and reject</seg> +<seg>libcups.[so,a], libcupsimage.[so,a] and various filters and backend +drivers</seg> +<seg>/etc/cups, /usr/include/cups, /usr/lib/cups, /usr/share/doc/cups, +/usr/share/cups, /var/log/cups and /var/spool/cups</seg> +</seglistitem> +</segmentedlist> -<sect3><title>cupsd</title> -<para><command>cupsd</command> is the scheduler for the Common Unix Printing -System. -</para></sect3> +<variablelist> +<bridgehead renderas="sect3">Short Descriptions</bridgehead> +<?dbfo list-presentation="list"?> -<sect3><title>accept</title> -<para><command>accept</command> instructs the printing system to accept print -jobs to the specified destinations. -</para></sect3> +<varlistentry id="accept"> +<term><command>accept</command></term> +<listitem><para>instructs the printing system to accept print jobs to the +specified destinations.</para> +<indexterm zone="cups accept"> +<primary sortas="b-accept">accept</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>reject</title> -<para><command>reject</command> instructs the printing system to -reject print jobs to the specified destinations. -</para></sect3> +<varlistentry id="cancel-cups"> +<term><command>cancel</command></term> +<listitem><para>cancels existing print jobs from the print queues.</para> +<indexterm zone="cups cancel-cups"> +<primary sortas="b-cancel">cancel</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>cupsaddsmb</title> -<para><command>cupsaddsmb</command> exports printers to the SAMBA software for -use with Windows clients. -</para></sect3> +<varlistentry id="cups-config"> +<term><command>cups-config</command></term> +<listitem><para>is a <application><acronym>CUPS</acronym></application> +program configuration utility.</para> +<indexterm zone="cups cups-config"> +<primary sortas="b-cups-config">cups-config</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>lpadmin</title> -<para><command>lpadmin</command> configures printer and class queues provided -by <acronym>CUPS</acronym>. -</para></sect3> +<varlistentry id="cupsaddsmb"> +<term><command>cupsaddsmb</command></term> +<listitem><para>exports printers to the <application>Samba</application> +software for use with Windows clients.</para> +<indexterm zone="cups cupsaddsmb"> +<primary sortas="b-cupsaddsmb">cupsaddsmb</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>lpinfo</title> -<para><command>lpinfo</command> lists the available devices or drivers known to -the <acronym>CUPS</acronym> server. -</para></sect3> +<varlistentry id="cupsd"> +<term><command>cupsd</command></term> +<listitem><para>is the scheduler for the Common Unix Printing System.</para> +<indexterm zone="cups cupsd"> +<primary sortas="b-cupsd">cupsd</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>lpmove</title> -<para><command>lpmove</command> moves the specified job to a new destination. -</para></sect3> +<varlistentry id="cupstestppd"> +<term><command>cupstestppd</command></term> +<listitem><para>tests the conformance of <filename>PPD</filename> files.</para> +<indexterm zone="cups cupstestppd"> +<primary sortas="b-cupstestppd">cupstestppd</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>cupstestppd</title> -<para><command>cupstestppd</command> tests the conformance of -<filename>PPD</filename> files. -</para></sect3> +<varlistentry id="disable"> +<term><command>disable</command></term> +<listitem><para>stops the named printers or classes.</para> +<indexterm zone="cups disable"> +<primary sortas="b-disable">disable</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>lpq</title> -<para><command>lpq</command> shows the current print queue status on the named -printer. -</para></sect3> +<varlistentry id="enable"> +<term><command>enable</command></term> +<listitem><para>starts the named printers or classes.</para> +<indexterm zone="cups enable"> +<primary sortas="b-enable">enable</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>lpr</title> -<para><command>lpr</command> submits files for printing. -</para></sect3> +<varlistentry id="lp-cups"> +<term><command>lp</command></term> +<listitem><para>submits files for printing or alters a pending job.</para> +<indexterm zone="cups lp-cups"> +<primary sortas="b-lp">lp</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>lprm</title> -<para><command>lprm</command> cancels print jobs that have been queued for -printing. -</para></sect3> +<varlistentry id="lpadmin"> +<term><command>lpadmin</command></term> +<listitem><para>configures printer and class queues provided by +<application><acronym>CUPS</acronym></application>.</para> +<indexterm zone="cups lpadmin"> +<primary sortas="b-lpadmin">lpadmin</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>cancel</title> -<para><command>cancel</command> cancels existing print jobs. -</para></sect3> +<varlistentry id="lpc-cups"> +<term><command>lpc</command></term> +<listitem><para> provides limited control over printer and class queues +provided by <application><acronym>CUPS</acronym></application>.</para> +<indexterm zone="cups lpc-cups"> +<primary sortas="b-lpc">lpc</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>disable</title> -<para><command>disable</command> stops the named printers or classes. -</para></sect3> +<varlistentry id="lpinfo"> +<term><command>lpinfo</command></term> +<listitem><para>lists the available devices or drivers known to the +<application><acronym>CUPS</acronym></application> server.</para> +<indexterm zone="cups lpinfo"> +<primary sortas="b-lpinfo">lpinfo</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>enable</title> -<para><command>enable</command> starts the named printers or classes. -</para></sect3> +<varlistentry id="lpmove"> +<term><command>lpmove</command></term> +<listitem><para>moves the specified job to a new destination.</para> +<indexterm zone="cups lpmove"> +<primary sortas="b-lpmove">lpmove</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>lp</title> -<para><command>lp</command> submits files for printing or alters a pending job. -</para></sect3> +<varlistentry id="lpoptions"> +<term><command>lpoptions</command></term> +<listitem><para>displays or sets printer options and defaults.</para> +<indexterm zone="cups lpoptions"> +<primary sortas="b-lpoptions">lpoptions</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>lpoptions</title> -<para><command>lpoptions</command> displays or sets printer options and -defaults. -</para></sect3> +<varlistentry id="lppasswd"> +<term><command>lppasswd</command></term> +<listitem><para>adds, changes or deletes passwords in the +<application><acronym>CUPS</acronym></application> digest password file +<filename>passwd.md5</filename>.</para> +<indexterm zone="cups lppasswd"> +<primary sortas="b-lppasswd">lppasswd</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>lpstat</title> -<para><command>lpstat</command> displays status information about the -current classes, jobs, and printers.</para></sect3> +<varlistentry id="lpq-cups"> +<term><command>lpq</command></term> +<listitem><para>shows the current print queue status on the named +printer.</para> +<indexterm zone="cups lpq-cups"> +<primary sortas="b-lpq">lpq</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>lppasswd</title> -<para><command>lppasswd</command> adds, changes or deletes passwords in -the <application><acronym>CUPS</acronym></application> digest password file -<filename>passwd.md5</filename>. -</para></sect3> +<varlistentry id="lpr-cups"> +<term><command>lpr</command></term> +<listitem><para>submits files for printing.</para> +<indexterm zone="cups lpr-cups"> +<primary sortas="b-lpr">lpr</primary> +</indexterm></listitem> +</varlistentry> -<sect3><title>cups-config</title> -<para><command>cups-config</command> is the <application><acronym>CUPS -</acronym></application> program configuration utility. -</para></sect3> +<varlistentry id="lprm-cups"> +<term><command>lprm</command></term> +<listitem><para>cancels print jobs that have been queued for printing.</para> +<indexterm zone="cups lprm-cups"> +<primary sortas="b-lprm">lprm</primary> +</indexterm></listitem> +</varlistentry> +<varlistentry id="lpstat-cups"> +<term><command>lpstat</command></term> +<listitem><para>displays status information about the current classes, jobs, +and printers.</para> +<indexterm zone="cups lpstat-cups"> +<primary sortas="b-lpstat">lpstat</primary> +</indexterm></listitem> +</varlistentry> + +<varlistentry id="reject"> +<term><command>reject</command></term> +<listitem><para>instructs the printing system to reject print jobs to the +specified destinations.</para> +<indexterm zone="cups reject"> +<primary sortas="b-reject">reject</primary> +</indexterm></listitem> +</varlistentry> +</variablelist> + </sect2> </sect1> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
