summaryrefslogtreecommitdiff
path: root/dviware/dvichk/dvichk-en.txt
blob: dd86bdcb01f69160cf224abf214d0e37b9228ff0 (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
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
This file documents DVIChk, a program to extract the page numbers from
.DVI/.LOG files, which are created by means of the TeX formatter.

  Copyright (c) 1990-1993, 2000 Thomas Esken

  This edition is for DVIChk version 1.91.

  Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.

  Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

  Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be stated in a
translation approved by the Free Software Foundation.

  Any suggestions, improvements, extensions, bug reports, donations,
proposals for contract work, and so forth are welcome!  Please send
them directly to my eMail address.  If you like my work, I'd appreciate
a postcard from you!

------------------------oOO      \\\_''/      OOo---------------------------
Thomas Esken               O     (/o-o\)     O  eMail: esken@gmx.net
Im Hagenfeld 84                 ((  ^  ))       Phone: +49 251 232585
D-48147 Muenster; Germany    \____) ~ (____/    MotD : 2old2live, 2young2die

DVIChk
******

  DVIChk is a program for extracting the page numbers from .DVI/.LOG
files, which are created by means of the TeX formatter.

  This is Edition 1.00 of the DVIChk documentation, 6 June 2000, for
DVIChk 1.91.

  Any suggestions, improvements, extensions, bug reports, donations,
proposals for contract work, and so forth are welcome!  Please send
them directly to my eMail address.  If you like my work, I'd appreciate
a postcard from you!

------------------------oOO      \\\_''/      OOo---------------------------
Thomas Esken               O     (/o-o\)     O  eMail: esken@gmx.net
Im Hagenfeld 84                 ((  ^  ))       Phone: +49 251 232585
D-48147 Muenster; Germany    \____) ~ (____/    MotD : 2old2live, 2young2die

DVIChk Introduction
*******************

  DVIChk is a program for extracting the page numbers from .DVI files,
which are created by means of the TeX formatter.  When DVIChk processes
.DVI files, it is also able to display information about the fonts used
in the file.  DVIChk is also able to extract the page numbers from .LOG
files, which are created by means of the TeX formatter.  But when DVIChk
processes .LOG files, it is unable to display information about fonts,
thus a possibly given `--font-info' option will be ignored. In case of
errors, all output of DVIChk is directed to the standard error device
channel, otherwise to the standard output device channel.

  The detected page numbers are printed as a table with 4 columns per
row by default.  The number of columns can be changed by using the
`--columns' option.  `--columns=0' displays the detected page numbers in
non-tabulated manner, i.e. they are displayed in one rown, only
separated from each other by using a space character.  The table of
page numbers is lead by an informational text, which contains, among
other things, the file name of the processed file and the total number
of pages found in the file.  This informational text can be extended
with information about the used fonts if the `--font-info' option is
selected.  If no informational text is wanted, the `--no-info' option
can be used to suppress it.  The output of DVIChk, as described above,
can be internally paginated each 24 rows in case the `--pager' option
is used.  If you only want to known how many pages are stored in the
.DVI or .LOG file, simply use the `--total-only' option.

Invoking `dvichk'
*****************

  DVIChk is a command line oriented program.  It is usually called from
the "shell" (1) and processes given arguments that are options and
commands, i.e. you must call DVIChk in this way:



     dvichk [ OPTION... ] FILE...



  If DVIChk is started with invalid options or without a FILE command,
it displays a help text and the program exits.  In case a FILE command
without a file extension is given, DVIChk first tries to process a file
by the name of `FILE.log' if both the files `FILE.dvi' and `FILE.log'
exist.

  An option is defined by a leading "switch" character; the `-' (dash)
character for traditional short-style options, or `--' for mnemonic
long-style options; a command may not have a leading switch character!

  DVIChk supports both short-style options and GNU long-style options.
Traditional short-style options are indicated by a single switch
character, and trailed by the option character itself and perhaps a
modifier or an argument.  The most single character options (2) can be
composed into a single command line word: `-Ax' is equivalent to `-A
-x'.  GNU long-style options are indicated with `--', and trailed by
the mnemonic option name itself and perhaps an argument.  Long-style
options and their arguments may be abbreviated if done unambiguously.
When a long-style option takes an argument, connect the option name and
the argument with `='.

DVIChk distinguishes two different types of long-style options:

  1. `--foo'
     Enables option `--foo'.

  2. `--foo=BAR'
     Enables option `--foo' with required argument BAR.

Traditional short-style options differ as follows:

  1. `-x'
     Enables option `-x'.

  2. `-x BAR'
     Enables option `-x' with required argument BAR.  The BAR argument
     may be separated by a leading _whitespace_ character from the
     short-style option character `x'.  This means, the following
     notations are valid for giving an argument, namely `-x BAR' or
     `-xBAR'.

DVIChk recognizes and processes the following options:

`-c 0...9'
`--columns=0...9'
     The page numbers found in the FILE are displayed by using 1...9
     columns per row, the default number of columns per row is 4.  When
     using `--columns=0', the page numbers found are displayed in
     non-tabulated manner, i.e. they are displayed in one rown, only
     separated from each other by using a space character.

`-i'
`--no-info'
     The output contains no further information, i.e. only the page
     numbers found in the FILE are displayed.

`-f'
`--font-info'
     The output is provided with information of the fonts found in the
     FILE.  But this is only possible in case the mode of operation is
     to process a .DVI file, which is created by means of the TeX
     formatter.

`-t'
`--total only'
     Display the total number of pages found in the FILE *only*.

`-p'
`--pager'
     The output is internally paginated each 24 rows.

`-?'
`-h'
`--help'
     Print a short usage message listing most of all available options,
     then exit successfully.

`-L'
`--license'
`--copyleft'
`--copyright'
     Print the software license message, then exit successfully.

`-V'
`--version'
     Print the version number and compilation options, then exit
     successfully.

  ---------- Footnotes ----------

  (1) This is an operating system program which interprets and runs
given command lines.

  (2) Unless they take an argument.

Environment Variables
*********************

Here is a table of all environment variables which are used by DVIChk:



`LANGUAGE'
     The national language and other cultural-specific conventions used
     by DVIChk at run-time.  Takes precedence over `LC_ALL',
     `LC_MESSAGES' and `LANG'.

`LC_ALL'
     The national language and other cultural-specific conventions used
     by DVIChk at run-time.  Takes precedence over `LC_MESSAGES' and
     `LANG'.

`LC_MESSAGES'
     The national language and other cultural-specific conventions used
     by DVIChk at run-time.  Takes precedence over `LANG'.

`LANG'
     The national language and other cultural-specific conventions used
     by DVIChk at run-time.

Error Codes
***********

DVIChk produces the following _exit_ codes:



`126'
     Invalid command line argument / option.

`110'
     No file name given.

`109'
     File not found.

`107'
     Error while reading file.

`106'
     Error while closing file.

`105'
     Corrupted file.

`104'
     Empty file.

`103'
     Irregular file.

`50'
     Virtual memory exhausted.

`49'
     Internal error, invalid value for the size of internal table
     occured.

`48'
     Internal error, C function failed.

`0'
     Normal program termination.

Concept Index
*************

- switch character:
          See ``Invoking `dvichk'''.
-- switch character:
          See ``Invoking `dvichk'''.
Arguments of command line:
          See ``Invoking `dvichk'''.
Columns, number:
          See ``Invoking `dvichk'''.
Command line interpreter:
          See ``Invoking `dvichk'''.
Command line options, dvichk:
          See ``Invoking `dvichk'''.
Command line, arguments:
          See ``Invoking `dvichk'''.
Commands:
          See ``Invoking `dvichk'''.
Copyleft:
          See ``Invoking `dvichk'''.
Copyright:
          See ``Invoking `dvichk'''.
DVIChk Introduction:
          See ``DVIChk Introduction''.
dvichk options:
          See ``Invoking `dvichk'''.
dvichk, options:
          See ``Invoking `dvichk'''.
EMail, error code:
          See ``Error Codes''.
Environment variable, LANG:
          See ``Environment Variables''.
Environment variable, LANGUAGE:
          See ``Environment Variables''.
Environment variable, LC_ALL:
          See ``Environment Variables''.
Environment variable, LC_MESSAGES:
          See ``Environment Variables''.
Environment variables, table:
          See ``Environment Variables''.
Error Codes, table:
          See ``Error Codes''.
Exit Codes, table:
          See ``Error Codes''.
Font information, output:
          See ``Invoking `dvichk'''.
GNU style options:
          See ``Invoking `dvichk'''.
Help text, online:
          See ``Invoking `dvichk'''.
Informations, output without further:
          See ``Invoking `dvichk'''.
Interal pager:
          See ``Invoking `dvichk'''.
Invoking dvichk:
          See ``Invoking `dvichk'''.
LANG environment variable:
          See ``Environment Variables''.
LANGUAGE environment variable:
          See ``Environment Variables''.
LC_ALL environment variable:
          See ``Environment Variables''.
LC_MESSAGES environment variable:
          See ``Environment Variables''.
Long-style options:
          See ``Invoking `dvichk'''.
Number of columns:
          See ``Invoking `dvichk'''.
Online help text:
          See ``Invoking `dvichk'''.
Options:
          See ``Invoking `dvichk'''.
Options of dvichk:
          See ``Invoking `dvichk'''.
Options, long-style:
          See ``Invoking `dvichk'''.
Options, short-style:
          See ``Invoking `dvichk'''.
Output of total number of pages only:
          See ``Invoking `dvichk'''.
Output with font information:
          See ``Invoking `dvichk'''.
Output without further information:
          See ``Invoking `dvichk'''.
Pager, interal:
          See ``Invoking `dvichk'''.
Program exit states, table:
          See ``Error Codes''.
Respected environment variables, table:
          See ``Environment Variables''.
Run-time error codes, table:
          See ``Error Codes''.
Separator character, whitespace:
          See ``Invoking `dvichk'''.
Shell:
          See ``Invoking `dvichk'''.
Short-style options:
          See ``Invoking `dvichk'''.
Single character options:
          See ``Invoking `dvichk'''.
Single command line word:
          See ``Invoking `dvichk'''.
Software license, finding:
          See ``Invoking `dvichk'''.
Switch character, -:
          See ``Invoking `dvichk'''.
Switch character, --:
          See ``Invoking `dvichk'''.
Table of all environment variables:
          See ``Environment Variables''.
Table of all error codes:
          See ``Error Codes''.
Table of all exit codes:
          See ``Error Codes''.
Total number of pages, output:
          See ``Invoking `dvichk'''.
Version number, finding:
          See ``Invoking `dvichk'''.
Whitespace character:
          See ``Error Codes''.
Whitespace separator character:
          See ``Invoking `dvichk'''.
Inhaltsverzeichnis
******************


DVIChk

DVIChk Introduction

Invoking `dvichk'

Environment Variables

Error Codes

Concept Index