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