summaryrefslogtreecommitdiffstats
path: root/doc/tdeioslave/print/index.docbook
blob: 4febda243fc439111893a426a83663d77edad004 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
<?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>