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