<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 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
> <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>


