summaryrefslogtreecommitdiffstats
path: root/doc/tdeioslave/print
diff options
context:
space:
mode:
authorDarrell Anderson <humanreadable@yahoo.com>2014-02-06 17:50:29 -0600
committerDarrell Anderson <humanreadable@yahoo.com>2014-02-06 17:50:29 -0600
commitcf14b1bd7803760ea4657269aeb424869e0058c6 (patch)
tree083f9fdcac07a38d4bf733c601f24f52e6a8e925 /doc/tdeioslave/print
parent66e86452a4f46f029820115fe6e55761a8d13187 (diff)
downloadtdebase-cf14b1bd7803760ea4657269aeb424869e0058c6.tar.gz
tdebase-cf14b1bd7803760ea4657269aeb424869e0058c6.zip
Reorganize tdeioslave help handbooks, fix related protocol files and issues, update and add handbooks.
Diffstat (limited to 'doc/tdeioslave/print')
-rw-r--r--doc/tdeioslave/print/CMakeLists.txt9
-rw-r--r--doc/tdeioslave/print/Makefile.am2
-rw-r--r--doc/tdeioslave/print/index.docbook176
3 files changed, 187 insertions, 0 deletions
diff --git a/doc/tdeioslave/print/CMakeLists.txt b/doc/tdeioslave/print/CMakeLists.txt
new file mode 100644
index 000000000..7ebc5b392
--- /dev/null
+++ b/doc/tdeioslave/print/CMakeLists.txt
@@ -0,0 +1,9 @@
+#################################################
+#
+# Improvements and feedback are welcome
+#
+# This file is released under GPL >= 2
+#
+#################################################
+
+tde_create_handbook( DESTINATION tdeioslave/print )
diff --git a/doc/tdeioslave/print/Makefile.am b/doc/tdeioslave/print/Makefile.am
new file mode 100644
index 000000000..00fc813d6
--- /dev/null
+++ b/doc/tdeioslave/print/Makefile.am
@@ -0,0 +1,2 @@
+KDE_LANG = en
+KDE_DOCS = tdeioslave/print
diff --git a/doc/tdeioslave/print/index.docbook b/doc/tdeioslave/print/index.docbook
new file mode 100644
index 000000000..872b3714c
--- /dev/null
+++ b/doc/tdeioslave/print/index.docbook
@@ -0,0 +1,176 @@
+<?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" > <!-- change language only here -->
+]>
+
+<article lang="&language;" id="print">
+<title>print</title>
+<articleinfo>
+<authorgroup>
+<author>&Kurt.Pfeifle; &Kurt.Pfeifle.mail;</author>
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</authorgroup>
+
+<date>2002-06-23</date>
+<releaseinfo>1.00.00</releaseinfo>
+
+</articleinfo>
+
+<para>The <acronym>print</acronym> KIOSlave gives quick access to browse
+different &tdeprint; sections via <quote>virtual folders</quote>.
+These folders provide some information about and quick access to your print
+subsystem.</para>
+
+<para><command>print:/</command> represents one more of those useful
+KIOSlaves implemented by &tde;. To access it, just type <userinput>print:/
+ </userinput> into the address field of &konqueror;. <userinput>print:/
+ </userinput> doesn't purely provide <quote>read-only</quote> access to
+ your print subsystem, but it also allows you to change settings
+ of your printers, of your print system and lets you create new printers
+ and classes.</para>
+
+<para>You are asked for the Administrator or root password, if you are
+not allowed a view or an operation as a normal user.</para>
+
+<para>You can bookmark frequently used shortcuts like
+ <command>print:/manager</command></para>
+
+<para>Valid syntax is either
+<userinput>print:/[path-to-virtual-folder]</userinput> or
+<userinput>print:[path-to-virtual-folder]</userinput></para>
+
+<para>Note, that some of the views and actions offered do heavily
+ depend on the print subsystem that is installed on your box and presently
+activated for &tde;. Pages showing printer information display only
+those parts that are valid for the &tde; selected print subsystem.
+(So if you normally run <acronym>CUPS</acronym>, but switched temporarily to
+
+
+ <quote>Generic UNIX LPD Printing</quote>, which is possible, you will see
+less printer info, because LPD is not capable of using the same amount of
+print settings as are possible in CUPS).</para>
+
+<para>Valid syntax to access different virtual folders
+and a short explanation of what they represent:</para>
+
+<variablelist>
+<title>Some examples</title>
+
+<varlistentry>
+<term><userinput>print:/ </userinput> (&ie; the root of
+print-tdeioslave)</term>
+<listitem>
+<para> virtual root for browsing your print subsystem.
+ It displays subfolders <quote>Classes</quote>,
+ <quote>Jobs</quote>,
+ <quote>Manager</quote>, <quote>Printers</quote>,
+ and <quote>Specials</quote></para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><userinput>print:/classes</userinput> or
+<userinput>print:classes </userinput>
+</term> <listitem>
+<para> view your printer classes
+ (supported by and useful for CUPS only)
+</para>
+</listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term><userinput>print:/classes/class_name </userinput> or
+ <userinput>print:classes/class_name </userinput> </term> <listitem>
+<para>view all members of the named
+ printer class (supported by and useful only
+ for CUPS) </para>
+</listitem>
+</varlistentry>
+
+
+<varlistentry>
+<term><userinput>print:/jobs </userinput>
+or <userinput>print:jobs </userinput></term>
+<listitem>
+<para> lists the current and pending jobs.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><userinput>print:/printers </userinput>
+or <userinput>print:printers </userinput></term>
+<listitem>
+<para> lists all your printers. Clicking
+ on a printer name shows more info about that printer.
+</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><userinput>print:/printers/printer_name </userinput>
+or <userinput>print:printers/printer_name </userinput> </term>
+<listitem>
+<para>displays useful info about the named
+ printer </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><userinput>print:/manager </userinput> or
+<userinput>print:manager </userinput>
+</term> <listitem>
+<para>opens a page very similar to the &tdeprint;
+ Manager module inside the &tde; Control Center.
+ Switch to a different printing system here or do every
+ other administrative task.</para>
+<para>This is the most important of access points to your printing
+ system.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term><userinput>print:/specials </userinput> or
+<userinput>print:specials </userinput>
+</term><listitem>
+<para>lists all presently available <quote>special printers</quote>:
+ Likely you'll see:</para>
+<itemizedlist>
+<listitem>
+ <para>The two that let you save a printfile to disk, in
+ &PostScript; or <acronym>PDF</acronym> format.</para>
+</listitem>
+<listitem>
+ <para>One that sends it as a <acronym>PDF</acronym> attachment via
+&kmail;.</para>
+</listitem>
+<listitem>
+ <para>And last, send it via fax, if you have one of the
+ supported fax backends active,
+<application>Hylafax</application> or
+<application>efax</application>.</para>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<tip><para>You can also put <command>print:/manager</command>
+ or similar as the command in
+ the <quote>Quick Command</quote> utility (started via
+<keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>)</para></tip>
+
+<para>You can learn more about printing and &tdeprint;'s powerful abilities
+by reading the <ulink url="help:/tdeprint/index.html">&tdeprint; Handbook
+locally</ulink> or at the <ulink url="http://printing.kde.org/">&tdeprint;
+Website</ulink> where there are documents online (<acronym>HTML</acronym> and
+<acronym>PDF</acronym>),containing
+<ulink
+url="http://printing.kde.org/documentation/tutorials/">Tutorials</ulink>,
+ as well as <ulink url="http://printing.kde.org/faq/">FAQs</ulink> and
+ Tips and Tricks related to printing in general.</para>
+
+</article>