You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdebase/doc/tdeioslave/print/index.docbook

191 lines
5.7 KiB

<?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;</author>
<author>&tde-authors;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
<releaseinfo>&tde-release-version;</releaseinfo>
<date>Reviewed: &tde-release-date;</date>
<copyright>
<year>2002</year>
<holder>&Kurt.Pfeifle;</holder>
</copyright>
<copyright>
<year>&tde-copyright-date;</year>
<holder>&tde-team;</holder>
</copyright>
<abstract>
<para>
This handbook describes the print protocol.
</para>
</abstract>
<keywordset>
<keyword>TDE</keyword>
<keyword>print</keyword>
<keyword>protocol</keyword>
</keywordset>
</articleinfo>
<para>The <acronym>print</acronym> tdeio slave 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
tdeio slaves 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">&tdeprint; Handbook</ulink>.
</para>
</article>