[user-guide] Added KDE content to chapter.
Ben Cotton
bcotton at fedoraproject.org
Thu Aug 19 00:22:44 UTC 2010
commit bc5b08fee8001f8501ea0f399447c8a5d74339f7
Author: Ben Cotton <bcotton at fedoraproject.org>
Date: Wed Aug 18 20:22:19 2010 -0400
Added KDE content to chapter.
en-US/Printing.xml | 100 ++++++++++++++++++++++++++++++++++++++-------------
1 files changed, 74 insertions(+), 26 deletions(-)
---
diff --git a/en-US/Printing.xml b/en-US/Printing.xml
index bbab046..2e51a0f 100644
--- a/en-US/Printing.xml
+++ b/en-US/Printing.xml
@@ -24,19 +24,36 @@
<section id="sect-User_Guide-adding_a_single_printer-USB">
<title>Adding a USB printer</title>
- For a USB printer, Fedora makes the setup as easy as possible:
- simply plug the USB cable into the computer. You'll be prompted to install
- print drivers if they aren't already installed, and Fedora will detect which
- ones you need in most cases.</para>
-
- <para>Click <guibutton>Install</guibutton> to begin installing the drivers. You
- may also need additional packages apart from the print drivers. If you are
- asked to confirm installation of these packages, click <guibutton>Continue</guibutton>
- to install them. You will then be asked to authenticate. Type in the password
- for the root account and click <guibutton>Authenticate</guibutton>. When
- this process completes, the printer is installed and ready for use.<para>
+
+ <section id="sect-User_Guide-single_printer-USB-Gnome">
+ <title>Adding a USB printer in Gnome</title>
+ <para>For a USB printer, Fedora makes the setup as easy as possible:
+ simply plug the USB cable into the computer. You'll be prompted to install
+ print drivers if they aren't already installed, and Fedora will detect which
+ ones you need in most cases.</para>
+
+ <para>Click <guibutton>Install</guibutton> to begin installing the drivers. You
+ may also need additional packages apart from the print drivers. If you are
+ asked to confirm installation of these packages, click <guibutton>Continue</guibutton>
+ to install them. You will then be asked to authenticate. Type in the password
+ for the root account and click <guibutton>Authenticate</guibutton>. When
+ this process completes, the printer is installed and ready for use.</para>
+ </section>
+
+ <section id="sect-User_Guide-single_printer-KDE">
+ <title>Adding a USB printer in KDE</title>
+ <para>The KDE printing applet automates the installation of many models of printer.
+ Simply plug the printer in and in a few seconds it will be added to the system.
+ The printer information will be set automatically. If you'd like to change the
+ settings, go to <menuchoice><guimenu>KMenu</guimenu>
+ <guisubmenu>Applications</guisubmenu><guisubmenu>Settings</guisubmenu>
+ <guisubmenu>System Settings</guisubmenu></menuchoice> and then click on
+ <guibutton>Printer Configuration</guibutton>. USB printers will appear under the
+ <guilabel>Local Printers</guilabel> section.</para>
+ </section>
</section>
+
<section id="sect-User_Guide-adding_a_single_printer-Network">
<title>Adding a network printer</title>
<para>In some cases, the printer might not be in reach of a USB cable, or it might be
@@ -45,7 +62,8 @@
for either wired or wireless connection. This allows the printer to be anywhere
with a network connection, even if it's in a different room.</para>
- <section id="sect-User_Guide-singe_printer-Network-Gnome">
+
+ <section id="sect-User_Guide-single_printer-Network-Gnome">
<title>Adding a network printer in Gnome</title>
<para>Even if the printer is on your local network, connecting is still
easy. To start, open the printing configuration. In GNOME, this is
@@ -80,21 +98,29 @@
</para>
</section>
- <!-- The interface for KDE is different enough to warrant a separate
- section. I'm leaving a stub here for now until the Gnome parts are
- complete. Eventually, we'll probably want to add instructions for other
- supported desktop environments.
-
<section id="sect-User_Guide-single_printer-Network-KDE">
<title>Adding a network printer in KDE</title>
- <para> In KDE, you first have to launch the Sytem Settings program by
- going to <menuchoice><guimenu>KMenu</guimenu>
- <guisubmenu>Applications</guisubmenu><guisubmenu>Settings</guisubmenu>
- <guisubmenu>System Settings</guisubmenu></menuchoice> and then clicking on
- <guibutton>Printer Configuration</guibutton>.
-
+ <!--KDE printing is made slightly more difficult by https://bugs.kde.org/show_bug.cgi?id=248308 -->
+ <para> In KDE, you first have to launch the Sytem Settings program. Press
+ <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>, type
+ <literal>kdesu kcmshell4 system-config-printer-kde</literal> and press
+ <keycap>Enter</keycap>. Type in your root password in the dialog box that
+ appears and click <guibutton>OK</guibutton>. Select <guilabel>New Printer</guilabel>
+ and click <guibutton>New Network Printer</guibutton>.
+ <guilabel>New Printer</guilabel> and click <guibutton>New Network Printer</guibutton>.
+ Select the appropriate connection for your printer, and enter the required
+ information for that connection type. Click <guibutton>Forward</guibutton> to
+ proceed.</para>
+
+ <para>In the last window, you'll be asked for some information to describe
+ the printer. For the <guilabel>Printer Name</guilabel>, you should select a
+ short, easy-to-remember name such as "laserjet". The
+ <guilabel>Description</guilabel> and <guilabel>Location</guilabel> fields are
+ optional. You can use those to provide information about the features of
+ the printer and it's location. Once you've entered the information, click
+ <guibutton>OK</guibutton>. The printer is now added to the system.</para>
</section>
- -->
+
</section>
<section id="sect-User_Guide-Printing-print_server">
@@ -105,6 +131,12 @@
Fedora makes it easy to connect to a wide variety of print servers.
</para>
+ <note>
+ <title>Firewall settings for printing</title>
+ <para>By default, CUPS uses TCP port 631 for network communication. If you're connecting
+ to a print server running CUPS, ensure the server firewall allows connections on port 631.</para>
+ </note>
+
<section id="sect-User_Guide-Printing-print_server-gnome">
<title>Connecting to a print server in Gnome</title>
<para>Connecting to an existing print server is similar to adding a single
@@ -113,13 +145,29 @@
<guisubmenu>Printing</guisubmenu></menuchoice>. In the <guilabel>Printing</guilabel>
window, select <menuchoice><guimenu>Server</guimenu><guisubmenu>Connect...</guisubmenu></menuchoice>.
In the <guilabel>CUPS server:</guilabel> field, enter the host name or IP address
- of your print server (for example: print.example.com or 192.168.1.10) and check
+ of your print server (for example: <literal>print.example.com</literal> or
+ <literal>192.168.1.10</literal>) and check
<guilabel>Require encryption</guilabel> if desired. Then click <guibutton>Connect</guibutton>.
It may take a few seconds to connect to the print server, but you should see all
of the printers on the server in your printer list.</para>
</section>
- <!-- Insert KDE section here -->
+ <section id="sect-User_Guide-Printing-print_server-kde">
+ <title>Connecting to a print server in KDE</title>
+ <para>KDE does not have an option for connecting to all queues on a remote printer.
+ To add printers connected to a print server, follow the directions above.</para>
+ </section>
+
+ <note>
+ <title>Connecting to a print server from the CUPS configuration files</title>
+ <para>Regardless of the desktop environment in use, a computer can be connected to a CUPS
+ print server by editing the file <filename>/etc/cups/client.conf</filename>. By default,
+ this file exists, but is empty. To connect to a CUPS print server, add the line
+ <screen><literal>ServerName</literal> <replaceable>server</replaceable></screen>
+ where <replaceable>server</replaceable>is the host name or IP address of the server. All
+ of the available print queues on that system will immediately be shown on the client
+ computer.</para>
+ </note>
</section>
<section id="sect-User_Guide-Printing-printing">
More information about the docs-commits
mailing list