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 fr 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, vernderte Kopien dieses Handbuchs
wie unter den Bedingungen fr wortgetreue Kopien zu erstellen und zu
vertreiben, sofern die ausgefhrten 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 fr vernderte 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 Vorschlge, Verbesserungen, Erweiterungen, Fehlerberichte, Geld-
und Sachspenden, Programmierauftrge usw. sind stets willkommen.  Bitte
senden Sie diese direkt an meine eMail Adresse.  Wenn Sie dieses
Werkzeug mgen, so wrde 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, fr
DVIChk 1.91.

Jedwede Vorschlge, Verbesserungen, Erweiterungen, Fehlerberichte, Geld-
und Sachspenden, Programmierauftrge usw. sind stets willkommen.  Bitte
senden Sie diese direkt an meine eMail Adresse.  Wenn Sie dieses
Werkzeug mgen, so wrde 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 fhig, Informationen ber die benutzten
Zeichenstze 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 Zeichenstze auszugeben,
so da eine mglicherweise angegebene `--font-info' Option in diesem
Fall ignoriert wird.  Im Fehlerfall werden alle Ausgaben von DVIChk auf
dem Standardfehler-Gertekanal ausgegeben, ansonsten auf dem
Standardausgabe-Gertekanal.

Die ermittelten Seitenzahlen werden in Form einer Tabelle mit 4 Spalten
je Zeile als Grundeinstellung ausgegeben.  Die Spaltenanzahl kann durch
die `--columns' Option verndert 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 angefhrt, der unter
anderem auch den Dateinamen der verarbeiteten Datei sowie die
Gesamtanzahl der in der Datei vorgefundenen Seitenzahlen enthlt.
Dieser Informationstext kann mittels der `--font-info' Option mit
Informationen ber die benutzten Zeichenstze erweitert werden.  Wird
berhaupt kein Informationstext gewnscht, so kann dieser per
`--no-info' Option unterdrckt 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 gewnscht, 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, nmlich
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 enthlt, 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 fhrendes 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
angefhrt, sodann folgt ein Optionszeichen und evtl. ein Modifizierer
oder ein Argument.  Die meisten Einzelzeichenoptionen (3) knnen zu
einem einzelnen Kommandozeilenwort zusammengefat werden: `-Ax' ist
gleichwertig zu `-A -x'.  GNU Langoptionen werden von `--' Zeichen
angefhrt, sodann folgt ein Optionsname und evtl. ein Argument.
Langoptionen sowie deren Argumente drfen abgekrzt werden, sofern die
vorgenommene Abkrzung 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 bentigtem 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 bentigtem BAR Argument an.  Das
     BAR Argument darf durch ein fhrendes _whitespace_ Zeichen von dem
     Kurzoptionszeichen `x' abgegrenzt werden.  Das bedeutet, da
     folgende Notationen zur Angabe eines Arguments verwendet werden
     knnen, 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 Zeichenstzen erweitert.  Das ist aber nur bei der
     Verarbeitung einer vom TeX-Formatierer erzeugten .DVI Datei
     mglich.

`-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 verfgbaren 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 fhrt 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'
     Unzulssige Option bei Programmaufruf.

`110'
     Kein Dateiname angegeben.

`109'
     Datei nicht gefunden.

`107'
     Fehler beim Lesen der Datei aufgetreten.

`106'
     Fehler beim Schlieen der Datei aufgetreten.

`105'
     Unzulssige Datei.

`104'
     Inhaltsleere Datei.

`103'
     Irregulre Datei.

`50'
     Virtueller Speicher erschpft.

`49'
     Interner Fehler, ungltiger Wert fr die Gre 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'''.
Einfhrung 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


