<article lang="&language;" id="print">
<title>print</title>
<articleinfo>
<authorgroup>
<author><firstname>Kurt</firstname><surname>Pfeifle</surname>
<affiliation><address><email>kpfeifle@danka.de</email></address></affiliation>
</author>
</authorgroup>

<date>2002-07-01</date>
<releaseinfo>1.00.00</releaseinfo>

</articleinfo>


<para>The <acronym>print</acronym> KIOSlave gives quick access to browse
different KDEPrint sections via <quote>virtual folders</quote>.
These folders provide
some information about and quick access to your print subsystem.</para>

<para><quote>print:/</quote> 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
 <quote>print:/manager</quote></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 CUPS, 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> -- </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>(i.e. the root of print-kioslave)</term>
<listitem>
<para>  virtual root for browsing your print subsystem.
        It displays subfolders <quote>classes</quote>,
	<quote>printers</quote>, <quote>manager</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:/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 KDEPrint
      Manager module inside the  &kde; 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>

        <para> * the two that let you save a printfile to disk, in
                 PostScript or PDF format;</para>

        <para> * one that sends it as a PDF-attachment via KMail;</para>

        <para> * and last, send it via fax, if you have one of the
                 supported fax backends active, Hylafax or efax.</para>

</listitem>
</varlistentry>

</variablelist>

<para>Hint: you can also put <quote>print:/manager</quote>
 or similar as command in
 the <quote>Quick Command</quote> utility (started via
<userinput>[ALT+F2]</userinput>)
</para>

<para> </para>

<para> -- </para>

<para>You can learn more about printing and KDEPrint's powerful abilities
by reading the <ulink url="help:/kdeprint/index.html">KDEPrint Handbook
locally</ulink> or at the <ulink url="http://printing.kde.org/">KDEPrint
Website</ulink>. The information at this website is regularly updated.
There are already a few documents online (HTML and PDF),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+Tricks related to printing in general.</para>

</article>
