tde-i18n/tde-i18n-en_GB/docs/tdebase/tdeioslave/print/index.docbook

<?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 % British-English "INCLUDE"> <!-- change language only here -->
]>

<article lang="&language;" id="print">
<title>print</title>
<articleinfo>
<authorgroup>
<author>&Kurt.Pfeifle; &Kurt.Pfeifle.mail;</author>
<othercredit role="translator"><firstname>Malcolm</firstname><surname>Hunter</surname><affiliation><address><email>malcolm.hunter@gmx.co.uk</email></address></affiliation><contrib>Conversion to British English</contrib></othercredit> 

</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 &kde;. 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 &kde;. Pages showing printer information display only those parts that are valid for the &kde; 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 &kde; Control Centre. 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>.</para>

</article>