summaryrefslogtreecommitdiff
path: root/gs/contrib/pcl3/doc/pcl3opts.ref
blob: ad9a095a4397949343b939103727f9b3ea7a4d8c (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
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN">

<refentry id="pcl3opts">

<docinfo>
  <title>Reference page for the command <command>pcl3opts</command></title>
  <author>
    <firstname>Martin</firstname>
    <surname>Lottermoser</surname>
  </author>
  <address>
    <street>Greifswaldstra&szlig;e 28</street>
    <postcode>38124</postcode> <city>Braunschweig</city>
    <country>Germany</country>
    <email>Martin.Lottermoser@t-online.de</email>
  </address>
  <copyright>
    <year>2000</year>
    <year>2001</year>
    <holder>Martin Lottermoser</holder>
  </copyright>
  <releaseinfo>$Id: pcl3opts.ref,v 1.10 2001/02/10 17:01:06 Martin Rel $</releaseinfo>
</docinfo>

<!--************************************************************************-->

<refmeta>
  <refentrytitle>PCL3OPTS</refentrytitle>
  <manvolnum>1</manvolnum>
</refmeta>

<!--************************************************************************-->

<refnamediv>
  <refname>pcl3opts</refname>
  <refpurpose>determine options for the ghostscript driver <command
    >pcl3</command> from a PCL-3+ file</refpurpose>
</refnamediv>

<!--************************************************************************-->

<refsynopsisdiv>
  <!-- According to Walsh+Muellner, "DocBook - The Definitive Guide" (1.0.2),
       the title should be generated. The version of Norman Walsh's HTML
       stylesheet I'm using does not do it, docbook-to-man does.
       If one specifies a title here, docbook-to-man produces two.
       Hence both packages are wrong. -->
  <cmdsynopsis>
    <command>pcl3opts</command>
    <arg choice="Opt"><option>-o <replaceable>output_file</replaceable></option
      ></arg>
    <arg choice="Opt" rep="Repeat"><replaceable>input_file</replaceable></arg>
  </cmdsynopsis>
</refsynopsisdiv>

<!--************************************************************************-->

<refsect1><title>DESCRIPTION</title>
<para>
The command <command>pcl3opts</command>
is intended to help in determining which options one should use when
calling ghostscript using <command>pcl3</command> for driving a PCL-3+ printer.
It analyzes one or more PCL <replaceable>input_files</replaceable>
and issues on the <replaceable>output_file</replaceable>
its best guess as to which options one should specify in order to produce
files using a similar configuration.
The default <replaceable>output_file</replaceable> is standard output.
If no <replaceable>input_files</replaceable> are specified,
the command reads from standard input.
</para>

<para>
This command is mostly of interest if you have access to PCL files generated by
software provided by the printer's manufacturer,
for example if you have a manufacturer-supplied
Microsoft Windows driver for your printer.
In that case you can generate a few files under Windows using different
settings and let <command>pcl3opts</command> examine them.
</para>
</refsect1>

<!--************************************************************************-->

<refsect1><title>LIMITATIONS</title>
<para>
Note that <command>pcl3opts</command>
cannot guarantee that the collection of options it proposes leads to a file
which is understood by the printer.
It can merely provide a best guess.
</para>

<para>
In addition, some settings require interpretation of the page contents
in order to properly translate them into options for <command>pcl3</command>
and some cannot reliably be derived from a PCL file at all.
Finding good values for these parameters is beyond
<command>pcl3opts</command>'s capabilities.
This includes <option>LeadingEdge</option>, <option>SendBlackLast</option>,
<option>Tumble</option> and the distinction between the colour models
<userinput>CMY+K</userinput> and <userinput>CMYK</userinput>.
</para>
</refsect1>

<!--************************************************************************-->

<refsect1><title>SEE ALSO</title>
<para>
<!-- I should generate a link here for HTML output. -->
<citerefentry>
  <refentrytitle>gs-pcl3</refentrytitle>
  <manvolnum>1</manvolnum>
</citerefentry>
</para>
</refsect1>

<!--************************************************************************-->

<refsect1><title>AUTHOR</title>
<para>
Copyright &copy; 2000, 2001 by Martin Lottermoser,
Greifswaldstra&szlig;e 28, 38124 Braunschweig, Germany.
E-mail: <email>Martin.Lottermoser@t-online.de</email>.
</para>

<para>
Version of this reference page: $Revision: 1.10 $
($Date: 2001/02/10 17:01:06 $).
</para>
</refsect1>

<!--************************************************************************-->
</refentry>