<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>
<article lang="&language;">
<title>Printer Configuration</title>
<articleinfo>
<authorgroup>
<author><firstname>Robin</firstname> <surname>Kumar</surname></author>
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<copyright>
<year>2012</year>
<holder>Robin Kumar</holder>
</copyright>
<copyright>
<year>2012</year>
<holder>&TC.Hollingsworth;</holder>
</copyright>
<legalnotice>&FDLNotice;</legalnotice>

<date>2012-02-16</date>
<releaseinfo>&kde; 4.8</releaseinfo>

<keywordset>
<keyword>KDE</keyword>
<keyword>Systemsettings</keyword>
<keyword>printer</keyword>
<keyword>CUPS</keyword>
</keywordset>
</articleinfo>

<sect1 id="intro">
<title>Introduction</title>

<para>The <application>Printer Configuration</application> module of
&systemsettings; allows you to add and manage printers using the &CUPS;
print server, as well as configure the server itself.</para>

<para>The <application>Common &UNIX; Printing System</application>, or
&CUPS;, is print server software developed by Apple, Inc. and used by most
modern &Linux; distributions and other &UNIX;-based operating systems.  For more
information,
<ulink url="http://www.cups.org/">visit the &CUPS; website</ulink>.</para>

</sect1>

<sect1 id="new">
<title>Adding a New Printer or Class</title>

<tip>
<para>Most USB printers will be detected and automatically configured by the
<ulink url="help:printer-applet">Printer Applet</ulink> when they are plugged in.
There is no need to add them manually.</para>

<para>Use this module only when adding a network printer, a printer using an
older local connection method like parallel or serial ports, or if USB
autodetection fails.</para>
</tip>

<para>To add a new printer, or a printer class (group of printers), select the
<guilabel>New Printer</guilabel> node from the left pane.</para>

<screenshot id="screenshot-new">
<screeninfo>New Printer</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="new.png" format="PNG"/></imageobject>
<textobject><phrase>The New Printer window.</phrase></textobject>
<caption><para>Add a new printer or class</para></caption>
</mediaobject>
</screenshot>

<para>There you will find two options:</para>

<sect2 id="new-printer">
<title>New Printer</title>

<para>To add a new printer which is connected to your local computer, home
network or on the Internet, select the <guilabel>New Printer</guilabel>
button.  A new window will open where you can specify your printer
configuration.</para>

<para>Choose the type of connection your printer uses from the left pane, then
input the required details for the connection type in the right pane, and then
click the <guibutton>Forward</guibutton> to proceed.</para>

<para>The following connection types are available:</para>

<variablelist>

<varlistentry>
<term><guilabel>AppSocket/HP JetDirect</guilabel></term>
<listitem>
<para>
<ulink url="http://lprng.sourceforge.net/LPRng-Reference-Multipart/appsocket.htm">AppSocket</ulink>
and <ulink url="http://en.wikipedia.org/wiki/JetDirect">JetDirect</ulink> are
two similar technologies that permit printers to receive print jobs over a
network.  If your printer or print server supports these technologies, you may
use this option to connect to the printer.</para>

<para>You will need to know the hostname and port of the print server over
the network to use this type of connection.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Internet Printing Protocol</guilabel></term>
<listitem>
<para>The
<ulink url="http://en.wikipedia.org/wiki/Internet_Printing_Protocol">Internet
Printing Protocol</ulink>, or <acronym>IPP</acronym> permits sending print jobs
and managing print jobs over a local network or the Internet.  There are three
entries for <acronym>IPP</acronym>:  secure <acronym>HTTP</acronym>
<guilabel>(https)</guilabel>, unsecure <acronym>IPP</acronym>
<guilabel>(ipp)</guilabel>, and secure <acronym>IPP</acronym>
<guilabel>(ipps)</guilabel>.</para>

<para>You will need to know the printer's URI to configure this type of
connection.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>LPD/LPR Host or Printer</guilabel></term>
<listitem>
<para>The Line Printer Daemon (<acronym>LPD</acronym>) or Line Printer Remote
(<acronym>LPR</acronym>) is a standard protocol for accessing printers over a
network that was commonly used by older &UNIX; print servers and continues to be
supported by newer ones like &CUPS;.</para>

<para>You will need to know the host of the print server and the name of the
<guilabel>Queue</guilabel> that represents the printer in order to use this type
of connection.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Other</guilabel></term>
<listitem><para>If none of the listed connection types are appropriate for
the printer you wish to add, you may select this connection type and enter any
URI that is accepted by &CUPS;.</para></listitem>
</varlistentry>

</variablelist>

<screenshot id="screenshot-new-uri">
<screeninfo>New Printer</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="new-uri.png" format="PNG"/></imageobject>
<textobject><phrase>The New Printer URI entry window.</phrase></textobject>
<caption><para>Entering a printer's URI.</para></caption>
</mediaobject>
</screenshot>

<para>On the next page, you may select the manufacturer of your printer from
the list provided, or select a Postscript Printer Description
(<acronym>PPD</acronym>) file. Then, click the <guibutton>Forward</guibutton>
button.</para>

<screenshot id="screenshot-new-manufacturer">
<screeninfo>Manufacturer Selection</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="new-manufacturer.png" format="PNG"/></imageobject>
<textobject><phrase>The New Printer manufacturer selection window.</phrase></textobject>
<caption><para>Selecting the printer's manufacturer.</para></caption>
</mediaobject>
</screenshot>

<para>On the next page, you can select the model of printer from the left, and
select the driver to use on the right. If you aren't sure which driver to use,
choose the driver that ends with <guilabel>(recommended)</guilabel>, which will
be selected by default.</para>

<screenshot id="screenshot-new-driver">
<screeninfo>Model and Driver Selection</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="new-driver.png" format="PNG"/></imageobject>
<textobject><phrase>The New Printer model and driver selection window.</phrase></textobject>
<caption><para>Selecting the printer's model and driver.</para></caption>
</mediaobject>
</screenshot>
<para>Finally, enter a name for your printer in the
<guilabel>Printer Name</guilabel> field if you wish to change the default. 
All printable characters except <userinput>/</userinput>, <userinput>#</userinput> 
and whitespace are allowed. You
may also enter the <guilabel>Description</guilabel> and
<guilabel>Location</guilabel> if you would like, but these fields are optional.
</para>

<para>Click the <guibutton>OK</guibutton> to configure the printer.</para>

<screenshot id="screenshot-new-details">
<screeninfo>New Printer Details</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="new-details.png" format="PNG"/></imageobject>
<textobject><phrase>The New Printer details entry window.</phrase></textobject>
<caption><para>Entering details about the new printer.</para></caption>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="new-printer-class">
<title>New Printer Class</title>

<para>To add a new printer class that specifies a group of printers to print to,
click on the <guibutton>New Printer Class</guibutton> button.</para>
<para>On the first page, you must enter a name for the class in the
<guilabel>Printer Name</guilabel> field. All printable characters except 
<userinput>/</userinput>, <userinput>#</userinput> 
and whitespace are allowed. You may also optionally enter a 
<guilabel>Description</guilabel> and the <guilabel>Location</guilabel>. 
Then, click <guibutton>Forward</guibutton>.</para>

<para>On the next page, you will see a list of printers present in the class on
the left, and all other printers configured on your system on the right.  To
add a printer to the class, select it from the right and click the
<guibutton>Left Arrow</guibutton> button. To remove a printer from the class,
select it from the left and click the <guibutton>Right Arrow</guibutton> button.
</para>

<para>Finally, click <guibutton>OK</guibutton> to create the new printer class.
</para>

<screenshot id="screenshot-new-class">
<screeninfo>New Printer Class</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="new-class.png" format="PNG"/></imageobject>
<textobject><phrase>The New Printer Class window.</phrase></textobject>
<caption><para>Selecting printers for a new class.</para></caption>
</mediaobject>
</screenshot>

</sect2>
</sect1>

<sect1 id="printer">
<title>Configuring a Printer</title>

<para>All printers configured on your system will be listed under the Local
Printers node. Select a printer from the list, and configuration options for it
will appear on the right.</para>

<para>Printer options are sorted into four groups, which can be accessed using
the tabs on the top.</para>

<sect2 id="printer-settings">
<title>Settings</title>

<para>The <guilabel>Settings</guilabel> tab allows you to view basic
configuration information about your printer like the driver it uses, as well
as perform basic actions like printing a test page.</para>

<screenshot id="screenshot-printer-settings">
<screeninfo>The Settings Tab</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="printer-settings.png" format="PNG"/></imageobject>
<textobject><phrase>The Settings tab in a printer's configuration.</phrase></textobject>
<caption><para>Modifying basic printer settings.</para></caption>
</mediaobject>
</screenshot>

<para>The following options are available:</para>

<variablelist>

<varlistentry>
<term><guilabel>Printer Description</guilabel></term>
<listitem>
<variablelist>

<varlistentry>
<term><guilabel>Location</guilabel></term>
<listitem><para>An optional description of the printer's location.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Printer Description</guilabel></term>
<listitem><para>A textual description of the printer, that will be displayed
alongside it in many applications.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Device URI</guilabel></term>
<listitem><para>The Uniform Resource Identifier of your printer. This may be
a &URL; for a printer on the Internet, a &UNIX; device file, or another URI
used by &CUPS; to locate your printer.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>This is the default printer</guilabel></term>
<listitem><para>This allows you to select this printer as the default printer.
The default printer will be automatically selected when invoking the Print
option of applications.</para>
<para>If this is the only configured printer, this option will be disabled.
</para></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Driver Details</guilabel></term>
<listitem>
<variablelist>

<varlistentry>
<term><guilabel>Printer Model</guilabel></term>
<listitem><para>This describes the manufacturer and model of the printer, and
also lists the driver currently in use.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Change</guibutton></term>
<listitem><para>Select this button to change the manufacturer, model, or driver
of this printer.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Printer State</guilabel></term>
<listitem><para>This describes the current state of your printer.  If it's not
printing, it will say <guilabel>Idle</guilabel>, otherwise it might inform you
that your printer is currently printing, or that there is an error, like a printer
jam or that it is of paper or ink.</para></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Printer Status</guilabel></term>
<listitem>
<variablelist>

<varlistentry>
<term><guilabel>Enable</guilabel></term>
<listitem><para>When this checkbox is selected, the printer will print any jobs
that it currently has or accepts.  When disabled, it will not print.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Accepting</guilabel></term>
<listitem><para>When this checkbox is selected, the printer will accept new jobs.
When disabled, it will not accept new jobs.</para>

<tip>
<para>If you plan to take a printer offline for a short time, but want it to
continue to accept jobs that will be printed when it is restored, you can
unselect <guilabel>Enabled</guilabel> but leave <guilabel>Accepting</guilabel>
enabled.  If you plan to take a printer offline for a long time, you could
leave <guilabel>Enabled</guilabel> selected but uncheck <guilabel>Accepting</guilabel>,
so the printer will print all remaining jobs but not accept any new ones.</para>
</tip>

</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Sharing</guilabel></term>
<listitem><para>This enables or disables sharing the printer with other computers.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Print Test Page</guibutton></term>
<listitem><para>Click this button to print a test page using this printer, to
verify that it is working correctly.</para></listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Remove Printer</guibutton></term>
<listitem><para>Click this button to remove this printer from the &CUPS; server.
</para></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="printer-policies">
<title>Policies</title>

<para>The <guilabel>Policies</guilabel> tab allows you to add a banner to every
page printed and disable or enable it for certain users.</para>

<screenshot id="screenshot-printer-policies">
<screeninfo>The Policies Tab</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="printer-policies.png" format="PNG"/></imageobject>
<textobject><phrase>The Policies tab in a printer's configuration.</phrase></textobject>
<caption><para>Modifying printer policy settings.</para></caption>
</mediaobject>
</screenshot>

<para>The following options are available:</para>

<variablelist>

<varlistentry>
<term><guilabel>Banner Settings</guilabel></term>
<listitem>

<para>A banner page is a special page that is printed before or after a printed
document, and may optionally define a header or footer that is displayed on a
document. For more information on banners, see
<ulink url="http://www.cups.org/articles.php?L204+TFAQ+Q">the relevant section
of the &CUPS; documentation</ulink>.</para>

<variablelist>

<varlistentry>
<term><guilabel>Starting Banner</guilabel></term>
<listitem><para>Select a banner page that is printed <emphasis>before</emphasis>
every printed document.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Ending Banner</guilabel></term>
<listitem><para>Select a banner page that is printed <emphasis>after</emphasis>
every printed document.</para></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>User and Group Permissions</guilabel></term>
<listitem>

<para>This permits you to enable or disable this printer for certain users or
groups on your system.</para>

<!--The period inconsistency here is present in 4.8.  Fixed in trunk.-->
<para>To configure it such that only the listed users or groups can use the
printer, select <guilabel>Deny printing for everyone except these users</guilabel>.
To configure it such that all users and groups can print <emphasis>except</emphasis>
those listed, select <guilabel>Allow printing for everyone except these users.</guilabel>
</para>

<para>To add a user or group to the list, click the <guibutton>Add</guibutton>
button, then enter the username or group name.  To remove a user or group from
the list, select it and click the <guibutton>Remove</guibutton> button.</para>

</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="printer-options">
<title>Printer Options</title>

<para>The <guilabel>Printer Options</guilabel> tab allows you to select options
that will be applied by default to various jobs, like the size or type of the
paper used or the quality of printing that the printer will perform.</para>

<caution>
<para>These options are specified by the driver used by your printer.  Rarely,
a printer may not offer some of the options listed here.  Quite frequently,
there will be more than are listed here.</para>
</caution>

<screenshot id="screenshot-printer-options">
<screeninfo>The Printer Options Tab</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="printer-options.png" format="PNG"/></imageobject>
<textobject><phrase>The Printer Options tab in a printer's configuration.</phrase></textobject>
<caption><para>Modifying advanced printer options.</para></caption>
</mediaobject>
</screenshot>

<para>The following options are usually available in most printers:</para>

<variablelist>

<varlistentry>
<term><guilabel>Media Size</guilabel></term>
<listitem><para>This lets you select the size of the media being printed on. A
list of standard sizes is provided.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Media Type</guilabel></term>
<listitem><para>This permits you to select the type of media that will be printed
on.  This usually is as simple as plain or photo paper, but advanced printers can
directly print on things like CD or DVD discs.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Print Quality</guilabel></term>
<listitem><para>This lets you choose the quality of printed documents.  Higher
quality printed documents generally appear better than lower quality ones, but
they will also take longer to print and use more ink or toner.</para></listitem>
</varlistentry>

</variablelist>

<para>Here are some additional options that are present in some printers:</para>

<variablelist>

<varlistentry>
<term><guilabel>Double-Sided Printing</guilabel></term>
<listitem><para>This enables or disabled double-sided printing, which may or
may not be automatic depending on the model of printer used.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Media Source</guilabel></term>
<listitem><para>This allows you to select for instance the tray that will be
used, if your printer has multiple paper trays.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Output Mode</guilabel></term>
<listitem><para>This permits you to configure the printer to print in color
or grayscale, if your printer supports doing so.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Duplexer Installed</guilabel></term>
<listitem><para>Printers that support a duplexer can print to both sides of a
page automatically, usually by mechanically flipping the page. Select this option
if your printer supports this.</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="printer-job-options">
<title>Job Options</title>

<para>The <guilabel>Job Options</guilabel> tab lets you select the default
settings that are applied to each print job, like the number of copies to be
printed.  These options can be changed in the print dialog of all &kde; applications
as well as many others.</para>

<screenshot id="screenshot-printer-job-options">
<screeninfo>The Job Options Tab</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="printer-job-options.png" format="PNG"/></imageobject>
<textobject><phrase>The Job Options tab in a printer's configuration.</phrase></textobject>
<caption><para>Modifying default job options.</para></caption>
</mediaobject>
</screenshot>

<para>All options are listed below.  Each option, except for the custom options,
provides a <guibutton>Reset</guibutton> to the right of the option.  Click this
button to restore that setting to its default value.</para>

<variablelist>

<varlistentry>
<term><guilabel>Common Options</guilabel></term>
<listitem>
<variablelist>

<varlistentry>
<term><guilabel>Copies</guilabel></term>
<listitem><para>Each document will be printed the number of times
configured here.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Orientation</guilabel></term>
<listitem><para>Allows you to select the orientation of printed documents, such
as <guilabel>Portrait</guilabel> or <guilabel>Landscape</guilabel>.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Scale to fit</guilabel></term>
<listitem><para>When this option is selected, documents larger than the media
will be shrunk to fit completely on it, while smaller documents will be expanded.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Pages per side</guilabel></term>
<listitem><para>This lets you print multiple pages on one page, for instance
by splitting it in half.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Pages per side layout</guilabel></term>
<listitem><para>This lets you select how multiple pages printed on one page will
be arranged.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Brightness</guilabel></term>
<listitem><para>This configures the darkness of the printed document.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Finishings</guilabel></term>
<listitem><para>Some printers support optional finishings, such as staples, hole
punches, or folding.  If you printer supports this, you may select one here.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Job priority</guilabel></term>
<listitem><para>Some print servers will print certain jobs before others. This
allows you to ensure your job is printed quickly or after more important ones.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Media</guilabel></term>
<listitem><para>This configures the size of media that the job will be printed
on.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Sides</guilabel></term>
<listitem><para>This configures double-sided printing.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Hold until</guilabel></term>
<listitem><para>This instructs the print server to not print your job until
a specified time, or never.</para></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Image Options</guilabel></term>
<listitem>

<para>These options affect only printed images.</para>

<variablelist>

<varlistentry>
<term><guilabel>Mirror</guilabel></term>
<listitem><para>If selected, the image will be reversed, as if it appeared in a
mirror.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Scaling</guilabel></term>
<listitem><para>This permits you to reduce or enlarge the image to a specified
size.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Saturation</guilabel></term>
<listitem><para>This configures the saturation, or intensity, or the color
printed.  For more information, see
<ulink url="http://en.wikipedia.org/wiki/Saturation_(color_theory)">the Saturation
article on Wikipedia</ulink>.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Hue adjustment</guilabel></term>
<listitem><para>This shifts the hue, or pure color, of the image.  For more
information, see <ulink url="http://en.wikipedia.org/wiki/Hue">the Hue article
on Wikipedia</ulink>.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Gamma</guilabel></term>
<listitem><para>This affects the gamma correction of the image.  For more
information, see <ulink url="http://en.wikipedia.org/wiki/Gamma_correction">the
Gamma Correction article on Wikipedia</ulink>.</para></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Text Options</guilabel></term>
<listitem>

<para>These options affect only jobs that consist solely of plain text.</para>

<variablelist>

<!--I'm not sure if these become metric in other countries or if &CUPS; foists our
    silly units upon the rest of the world.  ;-)  I tried to leave the
    descriptions nonspecific, just in case.   -->
<varlistentry>
<term><guilabel>Characters per inch</guilabel></term>
<listitem><para>Configures the density of characters in the printed document.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Lines per inch</guilabel></term>
<listitem><para>Configures the density of lines in the printed document.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Margins</term>
<listitem><para>You can configure the size of the left, right, top, and bottom
margins in the number selection boxes provided.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Pretty print</guilabel></term>
<listitem><para>When enabled, a header we be placed at the top of each page that
contains the page number, job title (usually the file name), and the date. C/C++
keywords will be highlighted and comments italicized.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Word wrap</guilabel></term>
<listitem><para>The enables or disabled wrapping of long lines.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Columns</guilabel></term>
<listitem><para>This configures the number of columns (or the width) of printed
text.</para></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term>Custom Options</term>
<listitem>

<para>In addition to the options defined above, &CUPS; supports a number of
additional options that aren't yet exposed in the user interface or are specific
to certain printer models.  These can be modified at the bottom of the
<guilabel>Job Options</guilabel> screen.</para>

<para>To add a custom option, enter the name of the option in the text box at
the very bottom of the screen and click the <guibutton>Add</guibutton> button.
</para>

<para>To change an option, select the desired option from the drop down box to
the right of the option's name.</para>

<para>To remove a custom option, click the <guibutton>Remove</guibutton> to the
far right of the option's name.</para>

</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="server">
<title>Configuring Server Settings</title>

<para>To modify settings that affect the &CUPS; print server itself, select the
<guilabel>Server Settings</guilabel> node from the left pane.</para>

<screenshot id="server.png">
<screeninfo>Server Settings</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="server.png" format="PNG"/></imageobject>
<textobject><phrase>The Server Settings window.</phrase></textobject>
<caption><para>Modifying the print server's settings.</para></caption>
</mediaobject>
</screenshot>

<para>The following options are available:</para>

<variablelist>

<varlistentry>
<term><guilabel>Show printers shared by other systems</guilabel></term>
<listitem><para>When enabled, &CUPS; will look for printers shared by other
systems and list them in the <guilabel>New Printer</guilabel> interface.
</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Share published printers connected to this system</guilabel></term>
<listitem>

<para>This globally enables sharing of shared printers to the local network
only.</para>

<variablelist>
<varlistentry>
<term><guilabel>Allow printing from the Internet</guilabel></term>
<listitem><para>This enables sharing of shared printers on the Internet, in
addition to the local network.</para></listitem>
</varlistentry>
</variablelist>

</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Allow remote administration</guilabel></term>
<listitem><para>This enables access to the &CUPS; web administration interface
from other systems on the local network or Internet.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Allow users to cancel any job (not just their own)</guilabel></term>
<listitem><para>Ordinarily, normal user accounts can only cancel jobs they
started.  When this option is enabled, users can cancel any job.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Save debugging information for troubleshooting</guilabel></term>
<listitem><para>When enabled, &CUPS; will dump a lot of extra information to its
log file.  This can be used by developers to troubleshoot issues with the
printing system.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="credits">
<title>Credits and License</title>

<para>Special thanks to Google Code-In 2011 participant Robin Kumar for writing
much of this article.</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;               <!-- FDL: do not remove -->
&underGPL;               <!-- GPL License -->

</sect1>

</article>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->
