<!DOCTYPE book PUBLIC  "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
  <!ENTITY kappname "&klpq;" -- this only *seems* redundant -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % German "INCLUDE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>

<book lang="&language;">
<bookinfo>
<title>Das &klpq;-Handbuch</title>

<authorgroup>
<author>
<firstname>Christoph</firstname>
<surname>Neerfeld</surname>
<affiliation>
<address><email>chris@kde.org</email></address>
</affiliation>
</author>

<author>
<firstname>Hans Petter</firstname>
<surname>Bieker</surname>
<affiliation>
<address><email>bieker@kde.org</email></address>
</affiliation>
</author>

<author
<firstname>Dirk</firstname>
<surname>D&ouml;rflinger</surname>
<affiliation>
<jobtitle>Deutsche &Uuml;bersetzung</jobtitle>
<address><email><ulink url="mailto:ddoerflinger@web.de">ddoerflinger@web.de</ulink></email></address>
</affiliation>
</author>
</authorgroup>

<date>14/12/2000</date>
<releaseinfo>1.0.1</releaseinfo>

<copyright>
<year>2000</year>
<holder>Christoph Neerfeld</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<abstract><para>Dieses Handbuch beschreibt &klpq; Version 1.0.1</para></abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>KLpq</keyword>
<keyword>printing</keyword>
<keyword>queueing</keyword>
<keyword>drucken</keyword>
<keyword>drucker</keyword>
<keyword>lpq</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Einf&uuml;hrung</title>

<para>&klpq; ist eine graphische Oberfl&auml;che f&uuml;r die Druckerwarteschlange. Es ist haupts&auml;chlich dazu gedacht,
die Druckerwarteschlange zu &uuml;berwachen und Auftr&auml;ge daraus zu l&ouml;schen. Au&szlig;erdem kann das Drucken
auch erlaubt/verboten werden, falls man die n&ouml;tigen Rechte dazu besitzt.</para>

<para>&klpq; ver&auml;ndert die Druckerwarteschlage nicht, sondern nutzt die Systemkommandos <command>lpq</command>, <command>lprm</command> and
<command>lpc</command>. Deshalb sollte &klpq; eigentlich unkritisch sein, solange
<command>lpq</command>, <command>lprm</command> und <command>lpc</command> dies sind.</para>

<itemizedlist>
<listitem><para>Unterst&uuml;tzt BSD, PPR und LPRng Drucksysteme.</para></listitem>
<listitem><para>Ist netzwerktransparent.</para></listitem>
<listitem><para>Unterst&uuml;tzt Drag &amp; Drop</para></listitem>
</itemizedlist>

</chapter>

<chapter id="usage">
<title>&klpq; verwenden</title>

<sect1 id="startup">
<title>Starten von &klpq;</title>

      <cmdsynopsis>
	<command>klpq</command>
	<arg>
	  <arg>-n</arg>
	  <arg>-P printer</arg>
          file1 file2 URL1 URL2
        </arg>
      </cmdsynopsis>

<para>Beim ersten Start von &klpq; erscheint ein Fenster mit der Frage, welches Druckersystem Sie benutzen.
&klpq; unterst&uuml;tzt die Systeme BSD, PPR und LPRng. Falls Sie nicht wissen, welches Druckersystem auf Ihrem Computer l&auml;uft, versuchen Sie es mit BSD, welches auf den meisten g&auml;ngigen Systemen l&auml;uft.
Falls &klpq; die Druckerwarteschlange nicht anzeigt, probieren Sie eines der anderen Systeme
(Sie k&ouml;nnen das System unter <menuchoice> <guimenu>Optionen</guimenu> <guimenuitem>Spooler</guimenuitem>
</menuchoice> ausw&auml;hlen).</para>

<para>Ohne Parameter gestartet, sucht &klpq; nach der Umgebungsvariablen
<envar>PRINTER</envar> und versucht, den Inhalt der korrespondierenden Druckerwarteschlange anzuzeigen.
Falls <envar>PRINTER</envar> nicht gesetzt sein sollte, zeigt &klpq; den Inhalt der Warteschlange <filename>lp</filename> an.
Falls auch diese nicht existiert, wird die erste in <filename>/etc/printcap</filename> angezeigt.</para>

<para>Mit einer Datei als Parameter k&ouml;nnen Sie &klpq; als Ersatz f&uuml;r
<command>lpr</command> verwenden. Sie brauchen nicht <command>lpr
<replaceable>dokument</replaceable>; klpq</command> einzugeben,
<command>klpq <replaceable>dokument</replaceable></command> gen&uuml;gt. &klpq;
startet <command>lpr</command> f&uuml;r Sie. Der Parameter <option>-P</option>
spezifiziert die Druckerumgebung. Momentan werden keine weiteren Optionen von
<command>lpr</command> unterst&uuml;tzt.</para>

<para>Der Parameter <option>-n</option> zwingt &klpq;, die Warteschlange nicht anzuzeigen,
wenn ein Dateiname &uuml;bergeben wurde. <abbrev>Z.B.</abbrev> l&auml;sst <command>klpq
<option>-n <replaceable>dokument</replaceable></option></command> &klpq; die Datei <filename>dokument</filename> an lpr senden und sich sofort wieder beenden. <command>klpq
<option>-n</option></command> ohne Dateiname startet &klpq; ganz normal.</para>

<para>&klpq; unterst&uuml;tzt auch <abbrev>URL</abbrev>s als Kommandozeilenparameter. Hierf&uuml;r wird <application>Konqueror</application>
verwendet, um die Datei tempor&auml;r als lokale Datei abzulegen und anschlie&szlig;end zu drucken.
</para>

<note><para>Bitte beachten Sie, dass &klpq; w&auml;hrend des Downloads aktiv sein muss. Ansonsten
wird die Datei nicht gedruckt.</para></note>

<para>Unterst&uuml;tzung von Drag &amp; Drop: Sie k&ouml;nnen jegliche <abbrev>URL</abbrev> aus
<application>Konqueror</application> auf das &klpq; Fenster her&uuml;ber ziehen, um ihren Inhalt zu drucken.
</para>

</sect1>

<sect1 id="mainwindow">
<title>Das Hauptfenster</title>

<para>&klpq; ist sehr einfach zu benutzen, daher hier nur ein paar kurze Worte &uuml;ber die Dinge, die nicht
so offensichtlich sind:</para>

<para>Wenn der Knopf <guibutton>Auto</guibutton> gedr&uuml;ckt ist, liest &klpq; alle "n" Sekunden
die Warteschlange, sodass Sie den Knopf <guibutton>Aktualisieren</guibutton> nicht mehr dr&uuml;cken m&uuml;ssen.
Sie k&ouml;nnen die "n" Sekunden unter
<menuchoice> <guimenu>Optionen</guimenu> <guimenuitem>Aktualisierungsfrequenz</guimenuitem></menuchoice>einstellen.
Wenn Sie "n" auf 0 setzen, wird der Knopf <guilabel>Auto</guilabel>
komplett dektiviert.</para>

<para>Falls Sie die Fehlermeldung "<errorname>Dies ist ein privilegierter Befehl und Sie haben
keine Berechtigung, ihn auszuf&uuml;hren.</errorname>" erhalten, m&uuml;ssen Sie sich als root oder
als anderer privilegierter Benutzer anmelden, um diesen Befehl ausf&uuml;hren zu k&ouml;nnen.
Der Versuch, den Druckauftrag eines anderen Benutzers zu l&ouml;schen, wird schlicht ignoriert.</para>

<para>Es gibt verschiedene Tastaturk&uuml;rzel:</para>

      <informaltable>
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>Taste:</entry>
	      <entry>Ausf&uuml;hrung</entry>
	    </row>
	  </thead>
	  <tbody>
	    <row>
	      <entry><keycap>U</keycap></entry>
	      <entry>Entspricht dem Dr&uuml;cken des Knopfes "<guibutton>Aktualisieren</guibutton>"
	      (englisch: Update).</entry>
	    </row>
	    <row>
	      <entry><keycap>R</keycap></entry>
	      <entry>Entspricht dem Dr&uuml;cken des  Knopfes "<guibutton>Entfernen</guibutton>"
	      (englisch: Remove)</entry>
	    </row>
	    <row>
	      <entry><keycap>T</keycap></entry>
	      <entry>Entspricht dem Dr&uuml;cken des Knopfes "<guibutton>Nach oben setzen</guibutton>"
	      (englisch: Make Top)</entry>
	    </row>
	    <row>
	      <entry><keycap>A</keycap></entry>
	      <entry>Entspricht dem Dr&uuml;cken des <guibutton>Auto</guibutton>-Knopfes.
	      button</entry>
	    </row>
	    <row>
	      <entry><keycap>Pfeil nach links</keycap></entry>
	      <entry>Zeigt die vorherige Druckerwarteschlange</entry>
	    </row>
	    <row>
	      <entry><keycap>Pfeil nach rechts</keycap></entry>
	      <entry>Zeigt die n&auml;chste Druckerwarteschlange</entry>
            </row>
	  </tbody>
	</tgroup>
      </informaltable>

</sect1>

<sect1 id="spooler-dialog">
<title>Der Spooler Dialog</title>

<para>Im Dialog Spooler kann das Drucksystem (BSD, PPR, LPRng) ausgew&auml;hlt werden.
Anschlie&szlig;end m&uuml;ssen noch die Pfade f&uuml;r die Druckkommandos gesetzt werden. Hilfe dazu finden
Sie in den man-pages Ihres Drucksystemes.</para>

</sect1>

</chapter>

<chapter id="todo">
<title>Zu erledigen</title>

<itemizedlist>
<listitem><para>mehr KDE Tastaturbefehle mit kkeyconfig</para></listitem>
<listitem><para>alle Warteschlangen gleichzeitig anzeigen</para></listitem>
<listitem><para>ein kleines Statusfenster in
<application>Kicker</application> integrieren</para></listitem>
<listitem><para>Unterst&uuml;tzung von mehr Befehlen von
<application>lprng</application></para></listitem>
<listitem><para>&klpq; komplett neu schreiben ;-)</para></listitem>
</itemizedlist>

<para>War da noch was?</para>
</chapter>

<chapter id="author">
<title>Autor</title>

<para>Mein Name ist Christoph Neerfeld. Ich studiere angewandte Informatik an der Fachhochschule f&uuml;r
angewandte Informatik Sankt Augustin, Deutschland.
Wer will, kann mir gerne Berichte, W&uuml;nsche oder Postkarten aus seiner Heimatstadt schicken.
Ich liebe es, Postkarten zu bekommen.
(Anm. des &Uuml;bersetzers: Postkarten an <email>chris@kde.org</email> kommen selten an ;-)</para>

<para>Vielen Dank an</para>

<itemizedlist>
<listitem><para>Victor Kolossov <email>kolosov@iris1.itep.ru</email> f&uuml;r die
Unterst&uuml;tzung zu <application>LPRng</application></para></listitem>
<listitem><para>Remco Treffkorn <email>remco@rvt.com</email> f&uuml;r die Unterst&uuml;tzung
zu <application>ppr</application></para></listitem>
</itemizedlist>

<para>und an viele andere f&uuml;r Fehlermeldungen und Vorschl&auml;ge.</para>

<para>&klpq; ist Copyright 1997/98 Christoph Neerfeld
<email>chris@kde.org</email></para>

<para>Copyright f&uuml;r die Dokumentation 2000 Dirk D&ouml;rflinger
<email>ddoerflinger@web.de</email></para>

&underFDL;
&underGPL;

</chapter>

<appendix id="Installation">
<title>Installation</title>

<sect1 id="how-to-obtain-klpq">
<title>Woher bekomme ich &klpq;?</title>

<para>&klpq; ist Teil des <ulink
url="http://www.kde.org">KDE Projektes</ulink>. &klpq; ist unter <ulink
url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, der Haupt-FTP-Seite des KDE Projektes, zu finden.
 Dort gibt es auch viele Links zu Spiegelservern auf der ganzen Welt.</para>

</sect1>

<sect1 id="requirements">
<title>Voraussetzungen</title>

<para>Um &klpq; erfolgreich compilieren zu k&ouml;nnen, ben&ouml;tigen Sie zumindest das Paket kdelibs, zu finden auf <ulink
url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>. Au&szlig;erdem wird empfohlen, auch das Paket kdebase installiert zu haben.</para>

<para>Zus&auml;tzlich ben&ouml;tigen Sie eine funktionierende Konfiguration der Datei
<filename>/etc/printcap</filename>.</para>

</sect1>

<sect1 id="compilation-and-installation">
<title>Kompilieren und Installieren</title>

<para>&klpq; ist normalerweise Bestandteil des Paketes kdeutils und wird im Laufe der Installation dieses Paketes mitinstalliert.</para>

<para>Falls Sie nur &klpq; selbst &uuml;bersetzen wollen, geben sie im Quelltextverzeichnis des Pakets kdeutils folgenden Befehl ein:</para>
<screen>
<prompt>%</prompt> <command>./configure</command>
</screen>
<para>Danach die zwei folgenden Befehle im &klpq;-Quellverzeichnis:</para>

<para>
<screen>
<prompt>%</prompt> <command>make</command>
<prompt>%</prompt> <command>make <option>install</option></command>
</screen>
</para>

<para>Da &klpq; <application>autoconf</application> benutzt, sollten sich eigentlich keine Probleme bei der Installation ergeben.
Falls doch welche auftauchen sollten, berichten Sie diese bitte in den KDE Mailinglisten.</para>

</sect1>
</appendix>

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
