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
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
|
Diese Datei beschreibt DVIChk, ein Programm um Seitenzahlen aus
.DVI/.LOG Dateien auszulesen, die vom TeX-Formatierer erzeugt wurden.
Copyright (c) 1990-1993, 2000 Thomas Esken
Diese Ausgabe ist für DVIChk Version 1.91.
Hiermit wird die Erlaubnis erteilt, wortgetreue Kopien dieses Handbuchs
zu erstellen und zu vertreiben, sofern alle gemachten Kopien mit dem
Copyrightvermerk und diesem Genehmigungsvermerk ausgestattet sind und
vorgenannte Vermerke erhalten bleiben.
Hiermit wird die Erlaubnis erteilt, veränderte Kopien dieses Handbuchs
wie unter den Bedingungen für wortgetreue Kopien zu erstellen und zu
vertreiben, sofern die ausgeführten Arbeiten in Ableitung und Gesamtheit
innerhalb der Bestimmungen eines Genehmigungsvermerks liegen und zudem
mit diesem ausgestattet sind, welcher mit diesem hier identisch ist.
Hiermit wird die Erlaubnis erteilt, wie unter den vorgenannten
Bedingungen für veränderte Versionen Übersetzungen dieses Handbuchs in
eine andere Sprache zu erstellen und zu vertreiben, mit der Ausnahme,
daß dieser Genehmigungsvermerk in einer Übersetzung angegeben sein
darf, welche von der Free Software Foundation gebilligt wird.
Jedwede Vorschläge, Verbesserungen, Erweiterungen, Fehlerberichte, Geld-
und Sachspenden, Programmieraufträge usw. sind stets willkommen. Bitte
senden Sie diese direkt an meine eMail Adresse. Wenn Sie dieses
Werkzeug mögen, so würde ich mich sehr über eine Postkarte von Ihnen
freuen!
------------------------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 ist ein Programm um die Seitenzahlen aus .DVI/.LOG Dateien
auszulesen, die vom TeX-Formatierer erzeugt wurden.
Das ist die Ausgabe 1.00 der DVIChk Dokumentation vom 6 Juni 2000, für
DVIChk 1.91.
Jedwede Vorschläge, Verbesserungen, Erweiterungen, Fehlerberichte, Geld-
und Sachspenden, Programmieraufträge usw. sind stets willkommen. Bitte
senden Sie diese direkt an meine eMail Adresse. Wenn Sie dieses
Werkzeug mögen, so würde ich mich sehr über eine Postkarte von Ihnen
freuen!
------------------------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
Einleitung
**********
DVIChk ist ein Programm um die Seitenzahlen aus .DVI Dateien
auszulesen, die vom TeX-Formatierer erzeugt wurden. In dieser
Betriebsart ist DVIChk auch fähig, Informationen über die benutzten
Zeichensätze auszugeben. DVIChk ist ebenso in der Lage, die
Seitenzahlen aus .LOG Dateien auszulesen, die vom TeX-Formatierer
erzeugt wurden. In dieser Betriebsart ist DVIChk allerdings nicht mehr
in der Lage, Informationen über die benutzten Zeichensätze auszugeben,
so daß eine möglicherweise angegebene `--font-info' Option in diesem
Fall ignoriert wird. Im Fehlerfall werden alle Ausgaben von DVIChk auf
dem Standardfehler-Gerätekanal ausgegeben, ansonsten auf dem
Standardausgabe-Gerätekanal.
Die ermittelten Seitenzahlen werden in Form einer Tabelle mit 4 Spalten
je Zeile als Grundeinstellung ausgegeben. Die Spaltenanzahl kann durch
die `--columns' Option verändert werden, wobei `--columns=0' die
gefundenen Seitenzahlen untabuliert, nur durch ein Leerzeichen
voneinander getrennt, in einer Zeile ausgibt. Die Tabelle der
Seitenzahlen wird durch einen Informationstext angeführt, der unter
anderem auch den Dateinamen der verarbeiteten Datei sowie die
Gesamtanzahl der in der Datei vorgefundenen Seitenzahlen enthält.
Dieser Informationstext kann mittels der `--font-info' Option mit
Informationen über die benutzten Zeichensätze erweitert werden. Wird
überhaupt kein Informationstext gewünscht, so kann dieser per
`--no-info' Option unterdrückt werden. Mit der `--pager' Option wird
die zuvor beschriebene Ausgabe von DVIChk alle 24 Zeilen intern
paginiert. Wird nur die Ausgabe der Gesamtanzahl der in der
verarbeiteten Datei enthaltenen Seiten gewünscht, so sollte DVIChk mit
der `--total-only' Option aufgerufen werden.
Aufruf von `dvichk'
*******************
DVIChk ist ein kommandozeilenorientiertes Programm. Es wird
üblicherweise vom Kommandointerpretierer des Betriebssystems aus
aufgerufen (1), und verarbeitet die ihm übergebenen Argumente, nämlich
Optionen und Kommandos, d.h. DVIChk muß auf folgende Art und Weise
aufgerufen werden:
dvichk [ OPTION... ] DATEI...
Wenn DVIChk mit fehlerhaften Optionen oder ohne DATEI-Kommando
aufgerufen wird, so wird ein Hilfetext ausgegeben und der Programmlauf
beendet. Wird ein DATEI-Kommando angegeben, das keine
Dateinamenserweiterung enthält, so versucht DVIChk zuerst eine Datei
mit dem Dateinamen `DATEI.log' zu verarbeiten, falls die Dateien
`DATEI.dvi' und `DATEI.log' gemeinsam vorliegen.
Eine Option wird durch ein führendes Umschaltzeichen (2) definiert; das
`-' Zeichen bei traditionellen Kurzoptionen, oder `--' bei den
mnemotechnischen Langoptionen; einem Kommando darf kein Umschaltzeichen
vorangehen.
DVIChk ist in der Lage, Kurzoptionen sowie auch GNU Langoptionen zu
verarbeiten. Kurzoptionen werden von einem einzelnen Umschaltzeichen
angeführt, sodann folgt ein Optionszeichen und evtl. ein Modifizierer
oder ein Argument. Die meisten Einzelzeichenoptionen (3) können zu
einem einzelnen Kommandozeilenwort zusammengefaßt werden: `-Ax' ist
gleichwertig zu `-A -x'. GNU Langoptionen werden von `--' Zeichen
angeführt, sodann folgt ein Optionsname und evtl. ein Argument.
Langoptionen sowie deren Argumente dürfen abgekürzt werden, sofern die
vorgenommene Abkürzung eindeutig ist. Wenn ein Argument an eine
Langoption übergeben werden soll, so werden der Optionsname und das
Argument mit einem `=' Zeichen verbunden.
So unterscheidet DVIChk zwei verschiedene Typen von Langoptionen:
1. `--foo'
Schaltet die `--foo' Option an.
2. `--foo=BAR'
Schaltet die `--foo' Option mit dem benötigtem BAR Argument an.
Traditionelle Kurzoptionen unterscheiden sich wie folgt:
1. `-x'
Schaltet die `-x' Option an.
2. `-x BAR'
Schaltet die `-x' Option mit dem benötigtem BAR Argument an. Das
BAR Argument darf durch ein führendes _whitespace_ Zeichen von dem
Kurzoptionszeichen `x' abgegrenzt werden. Das bedeutet, daß
folgende Notationen zur Angabe eines Arguments verwendet werden
können, und zwar `-x BAR' und `-xBAR'.
DVIChk erkennt und verarbeitet die folgenden Optionen:
`-c 0...9'
`--columns=0...9'
Die in der DATEI vorgefundenen Seitenzahlen werden in 1...9
Spalten je Zeile ausgegeben, wobei in der Grundeinstellung 4
Spalten je Zeile ausgegeben werden. `--columns=0' gibt die
gefundenen Seitenzahlen untabuliert, d.h. nur durch ein
Leerzeichen voneinander getrennt, in einer Zeile aus.
`-i'
`--no-info'
Die Ausgabe erfolgt ohne weitere Informationen, d.h. es werden nur
die in der DATEI vorgefundenen Seitenzahlen ausgegeben.
`-f'
`--font-info'
Die Ausgabe wird mit Informationen zu den in der DATEI
vorgefundenen Zeichensätzen erweitert. Das ist aber nur bei der
Verarbeitung einer vom TeX-Formatierer erzeugten .DVI Datei
möglich.
`-t'
`--total-only'
Es wird *nur* die Gesamtanzahl der Seiten ausgegeben, die in der
DATEI vorgefundenen wurde.
`-p'
`--pager'
Die Ausgabe wird alle 24 Zeilen intern paginiert.
`-?'
`-h'
`--help'
Ausgabe eines Hilfetextes, der die verfügbaren Optionen aufzeigt;
sodann erfolgreiche Beendigung des Programms.
`-L'
`--license'
`--copyleft'
`--copyright'
Ausgabe des Software-Lizenztextes; sodann erfolgreiche Beendigung
des Programms.
`-V'
`--version'
Ausgabe der Versionsnummer und der Kompilations-Optionen; sodann
erfolgreiche Beendigung des Programms.
---------- Fussnoten ----------
(1) Im Englischen mit "shell" bezeichnet; dieses
Betriebssystemprogramm interpretiert Kommandozeilen und führt diese aus.
(2) Im Englischen mit "switch" Zeichen bezeichnet.
(3) Sofern diese kein Argument annehmen.
Umgebungsvariablen
******************
Hier ist eine Liste aller Umgebungsvariablen, die von DVIChk benutzt
werden:
`LANGUAGE'
Die Landessprache und sonstige kulturspezifische Konventionen, die
DVIChk zur Laufzeit verwenden soll. Hat Vorrang vor `LC_ALL',
`LC_MESSAGES' und `LANG'.
`LC_ALL'
Die Landessprache und sonstige kulturspezifische Konventionen, die
DVIChk zur Laufzeit verwenden soll. Hat Vorrang vor `LC_MESSAGES'
und `LANG'.
`LC_MESSAGES'
Die Landessprache und sonstige kulturspezifische Konventionen, die
DVIChk zur Laufzeit verwenden soll. Hat Vorrang vor `LANG'.
`LANG'
Die Landessprache und sonstige kulturspezifische Konventionen, die
DVIChk zur Laufzeit verwenden soll.
Fehlerkodes
***********
DVIChk erzeugt folgende _exit_-Kodes:
`126'
Unzulässige Option bei Programmaufruf.
`110'
Kein Dateiname angegeben.
`109'
Datei nicht gefunden.
`107'
Fehler beim Lesen der Datei aufgetreten.
`106'
Fehler beim Schließen der Datei aufgetreten.
`105'
Unzulässige Datei.
`104'
Inhaltsleere Datei.
`103'
Irreguläre Datei.
`50'
Virtueller Speicher erschöpft.
`49'
Interner Fehler, ungültiger Wert für die Größe einer internen
Tabelle aufgetreten.
`48'
Interner Fehler, C Funktion hat versagt.
`0'
Fehlerfreier Programmlauf.
Stichwortverzeichnis
********************
- Switch-Zeichen:
See ``Aufruf von `dvichk'''.
- Umschaltzeichen:
See ``Aufruf von `dvichk'''.
-- Switch-Zeichen:
See ``Aufruf von `dvichk'''.
-- Umschaltzeichen:
See ``Aufruf von `dvichk'''.
Alleinige Ausgabe der Gesamtanzahl der Seiten:
See ``Aufruf von `dvichk'''.
Anzahl der Spalten:
See ``Aufruf von `dvichk'''.
Argumente der Kommandozeile:
See ``Aufruf von `dvichk'''.
Aufruf von dvichk:
See ``Aufruf von `dvichk'''.
Ausgabe mit Zeichensatz-Informationen:
See ``Aufruf von `dvichk'''.
Ausgabe ohne weitere Informationen:
See ``Aufruf von `dvichk'''.
Copyleft:
See ``Aufruf von `dvichk'''.
Copyright:
See ``Aufruf von `dvichk'''.
dvichk, Optionen von:
See ``Aufruf von `dvichk'''.
Einführung in DVIChk:
See ``Einleitung''.
Einzelzeichenoption:
See ``Aufruf von `dvichk'''.
Endestatus, Programm:
See ``Fehlerkodes''.
Exit-Kodes, Tabelle aller:
See ``Fehlerkodes''.
Fehlerkodes, Tabelle aller:
See ``Fehlerkodes''.
Gesamtanzahl der Seiten, alleinige Ausgabe der:
See ``Aufruf von `dvichk'''.
GNU Langoptionen:
See ``Aufruf von `dvichk'''.
Hilfetext:
See ``Aufruf von `dvichk'''.
Informationen, Ausgabe ohne weitere:
See ``Aufruf von `dvichk'''.
Interner Paginierer:
See ``Aufruf von `dvichk'''.
Kommandointerpretierer:
See ``Aufruf von `dvichk'''.
Kommandos:
See ``Aufruf von `dvichk'''.
Kommandozeilenargumente:
See ``Aufruf von `dvichk'''.
Kommandozeilenoptionen, dvichk:
See ``Aufruf von `dvichk'''.
Kommandozeilenwort:
See ``Aufruf von `dvichk'''.
Kurzoptionen:
See ``Aufruf von `dvichk'''.
LANG Umgebungsvariable:
See ``Umgebungsvariablen''.
Langoptionen:
See ``Aufruf von `dvichk'''.
LANGUAGE Umgebungsvariable:
See ``Umgebungsvariablen''.
Laufzeitfehlerkodes:
See ``Fehlerkodes''.
LC_ALL Umgebungsvariable:
See ``Umgebungsvariablen''.
LC_MESSAGES Umgebungsvariable:
See ``Umgebungsvariablen''.
Liste aller Umgebungsvariablen:
See ``Umgebungsvariablen''.
Optionen:
See ``Aufruf von `dvichk'''.
Optionen der Kommandozeile:
See ``Aufruf von `dvichk'''.
Optionen von dvichk:
See ``Aufruf von `dvichk'''.
Optionen, GNU Stil:
See ``Aufruf von `dvichk'''.
Optionen, Kurzform:
See ``Aufruf von `dvichk'''.
Optionen, Langform:
See ``Aufruf von `dvichk'''.
Paginierer, interner:
See ``Aufruf von `dvichk'''.
Programmendestatus, Tabelle aller:
See ``Fehlerkodes''.
Shell:
See ``Aufruf von `dvichk'''.
Software Lizenz, Auffinden der:
See ``Aufruf von `dvichk'''.
Spaltenanzahl:
See ``Aufruf von `dvichk'''.
Switch-Zeichen, -:
See ``Aufruf von `dvichk'''.
Switch-Zeichen, --:
See ``Aufruf von `dvichk'''.
Tabelle aller Fehlerkodes:
See ``Fehlerkodes''.
Trennzeichen, whitespace:
See ``Aufruf von `dvichk'''.
Umgebungsvariable, LANG:
See ``Umgebungsvariablen''.
Umgebungsvariable, LANGUAGE:
See ``Umgebungsvariablen''.
Umgebungsvariable, LC_ALL:
See ``Umgebungsvariablen''.
Umgebungsvariable, LC_MESSAGES:
See ``Umgebungsvariablen''.
Umgebungsvariablen, Liste aller:
See ``Umgebungsvariablen''.
Umschaltzeichen, -:
See ``Aufruf von `dvichk'''.
Umschaltzeichen, --:
See ``Aufruf von `dvichk'''.
Versionsnummer, Auffinden der:
See ``Aufruf von `dvichk'''.
Whitespace Trennzeichen:
See ``Aufruf von `dvichk'''.
Zeichensatz-Informationen, Ausgabe mit:
See ``Aufruf von `dvichk'''.
Inhaltsverzeichnis
******************
DVIChk
Einleitung
Aufruf von `dvichk'
Umgebungsvariablen
Fehlerkodes
Stichwortverzeichnis
|
