Debian Codegraph @

texmf-dist/doc/man/man1/pdfjadetex.1

raw
1 .TH PDFJADETEX 1 "12 July 1998" "Marcus Brinkmann"
2 .\"=====================================================================
3 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
4 .if n .ds TX TeX
5 .if n .ds MF Metafont
6 .if t .ds MF M\s-2ETAFONT\s0
7 .ie t .ds OX \fIT\v'+0.25m'E\v'-0.25m'X\fP\" for troff
8 .el .ds OX TeX\" for nroff
9 .\" the same but obliqued
10 .\" BX definition must follow TX so BX can use TX
11 .if t .ds BX \fRB\s-2IB\s0\fP\*(TX
12 .if n .ds BX BibTeX
13 .\" LX definition must follow TX so LX can use TX
14 .if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
15 .if n .ds LX LaTeX
16 .if t .ds AX \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(TX
17 .if n .ds AX AmSTeX
18 .if t .ds AY \fRA\\h'-0.1667m'\\v'0.20v'M\\v'-0.20v'\\h'-0.125m'S\fP\*(LX
19 .if n .ds AY AmSLaTeX
20 .\"=====================================================================
21 .SH NAME
22 pdfjadetex \- PDF output from JadeTeX
23 .SH SYNOPSIS
24 .B pdfjadetex
25 .RI [ options ]
26 .RI [ commands ]
27 .\"=====================================================================
28 .SH DESCRIPTION
29 This manual page was derived from the manual page for pdf\*(TX and is not meant
30 to be exhaustive. The complete documentation for this version of \*(TX can be
31 found in the info file or manual
32 .IR "Web2C: A TeX implementation" .
33 .PP
34 pdfjade\*(TX is a version of \*(TX that can create
35 .I PDF
36 files as well as
37 .I DVI
38 files.
39 .PP
40 The typical use of pdfjade\*(TX is with a pregenerated formats for which
41 PDF output has been enabled. The
42 .B pdfjadetex
43 command uses the equivalent of the plain Jade\*(TX format.
44 .PP
45 pdfjade\*(TX's handling of its command-line arguments is similar to that of
46 \*(LX.
47 .\"=====================================================================
48 .SH OPTIONS
49 This version of pdfjade\*(TX understands the following command line options.
50 .TP
51 .BI --fmt \ format
52 .rb
53 Use
54 .I format
55 as the name of the format to be used, instead of the name by which
56 pdfjade\*(TX was called or a
57 .I %&
58 line.
59 .TP
60 .B --help
61 .rb
62 Print help message and exit.
63 .TP
64 .B --ini
65 .rb
66 Be
67 .BR pdfinitex ,
68 for dumping formats; this is implicitly true if the program is called
69 as
70 .BR pdfinitex .
71 .TP
72 .BI --interaction \ mode
73 .rb
74 Sets the interaction mode. The mode can be one of
75 .IR batchmode ,
76 .IR nonstopmode ,
77 .IR scrollmode ,
78 and
79 .IR errorstopmode .
80 The meaning of these modes is the same as that of the corresponding
81 \ecommands.
82 .TP
83 .B --ipc
84 .rb
85 Send DVI or PDF output to a socket as well as the usual output file.
86 Whether this option is available is the choice of the installer.
87 .TP
88 .B --ipc-start
89 .rb
90 As
91 .BR --ipc ,
92 and starts the server at the other end as well. Whether this option
93 is available is the choice of the installer.
94 .TP
95 .BI --kpathsea-debug \ bitmask
96 .rb
97 Sets path searching debugging flags according to the bitmask. See the
98 .I Kpathsea
99 manual for details.
100 .TP
101 .BI --maketex \ fmt
102 .rb
103 Enable
104 .RI mktex fmt ,
105 where
106 .I fmt
107 must be one of
108 .I tex
109 or
110 .IR tfm .
111 .TP
112 .BI --no-maketex \ fmt
113 .rb
114 Disable
115 .RI mktex fmt ,
116 where
117 .I fmt
118 must be one of
119 .I tex
120 or
121 .IR tfm .
122 .TP
123 .BI --output-comment \ string
124 .rb
125 Use
126 .I string
127 for the DVI file comment instead of the date.
128 .TP
129 .BI --progname \ name
130 .rb
131 Pretend to be program
132 .IR name .
133 This affects both the format used and the search paths.
134 .TP
135 .B --shell-escape
136 .rb
137 Enable the
138 .BI \ewrite18{ command }
139 construct. The
140 .I command
141 can be any Bourne shell command. This construct is normally
142 disallowed for security reasons.
143 .TP
144 .B --version
145 .rb
146 Print version information and exit.
147 .\"=====================================================================
148 .SH ENVIRONMENT
149 See the Kpathsearch library documentation (the `Path specifications'
150 node) for precise details of how the environment variables are used.
151 The
152 .B kpsewhich
153 utility can be used to query the values of the variables.
154 .PP
155 One caveat: In most pdfjade\*(TX formats, you cannot use ~ in a filename you
156 give directly to pdfjade\*(TX, because ~ is an active character, and hence is
157 expanded, not taken as part of the filename. Other programs, such as
158 \*(MF, do not have this problem.
159 .PP
160 .TP
161 TEXMFOUTPUT
162 Normally, pdfjade\*(TX puts its output files in the current directory. If
163 any output file cannot be opened there, it tries to open it in the
164 directory specified in the environment variable TEXMFOUTPUT.
165 There is no default value for that variable. For example, if you say
166 .I tex paper
167 and the current directory is not writable, if TEXMFOUTPUT has
168 the value
169 .IR /tmp ,
170 pdfjade\*(TX attempts to create
171 .I /tmp/paper.log
172 (and
173 .IR /tmp/paper.pdf ,
174 if any output is produced.)
175 .TP
176 TEXINPUTS
177 Search path for
178 .I \einput
179 and
180 .I \eopenin
181 files.
182 This should probably start with ``.'', so
183 that user files are found before system files.
184 .TP
185 TEXFONTS
186 Search path for font metric
187 .RI ( .tfm )
188 files.
189 .TP
190 TEXFORMATS
191 Search path for format files.
192 .TP
193 TEXPOOL
194 search path for
195 .B pdfinitex
196 internal strings.
197 .TP
198 TEXEDIT
199 Command template for switching to editor. The default, usually
200 .BR vi ,
201 is set when pdfjade\*(TX is compiled.
202 .\"=====================================================================
203 .SH FILES
204 The location of the files mentioned below varies from system to
205 system. Use the
206 .B kpsewhich
207 utility to find their locations.
208 .TP
209 .I pdfjadetex.pool
210 Encoded text of pdfjade\*(TX's messages.
211 .TP
212 .I texfonts.map
213 Filename mapping definitions.
214 .TP
215 .I *.tfm
216 Metric files for pdfjade\*(TX's fonts.
217 .TP
218 .I *.fmt
219 Predigested pdfjade\*(TX format (.\|fmt) files.
220 .br
221 .\"=====================================================================
222 .SH BUGS
223 This version of pdfjade\*(TX fails to trap arithmetic overflow when
224 dimensions are added or subtracted. Cases where this occurs are rare,
225 but when it does the generated
226 .I DVI
227 file will be invalid.
228 .\"=====================================================================
229 .SH "SEE ALSO"
230 .BR jadetex (1),
231 .BR tex (1),
232 .BR mf (1),
233 .BR undump (1).
234 .\"=====================================================================
235 .SH AUTHORS
236 The author of pdfjade\*(TX is Sebastian Rahtz.
237 .PP
238 This manual page was derived by Marcus Brinkmann for the Debian distribution from
239 the pdf\*(TX manual page from the te\*(TX distribution by Thomas Esser.