summaryrefslogtreecommitdiff
path: root/dviware/dvichk
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /dviware/dvichk
Initial commit
Diffstat (limited to 'dviware/dvichk')
-rw-r--r--dviware/dvichk/README34
-rw-r--r--dviware/dvichk/dvichk-de.txt418
-rw-r--r--dviware/dvichk/dvichk-en.txt395
3 files changed, 847 insertions, 0 deletions
diff --git a/dviware/dvichk/README b/dviware/dvichk/README
new file mode 100644
index 0000000000..8cddec60ef
--- /dev/null
+++ b/dviware/dvichk/README
@@ -0,0 +1,34 @@
+This is the alpha-testing release of DVIChk, an utility to display the
+page numbers of a `.dvi' resp., `.log' file created by the TeX formatter.
+
+This is the C port of the Pascal program by the same name created by
+Thomas Esken <esken@gmx.net>.
+
+You can get the original (PC version with Turbo-Pascal source) via anonymous
+FTP from the CTAN TeX-archive <CTAN:/tex-archive/dviware/dvichk/>.
+
+Changes against the Turbo-Pascal PC version:
+============================================
+I took out the file wildcarding option forever.
+
+How to Install:
+===============
+UNIX system: Simply run the `configure' script and after its run,
+ simply type `make install' for installing all necessary
+ targets, resp., type `make help' for an overview of all
+ build-related targets available.
+
+MS/PC-DOS systems: Copy `./systems/msdos/makefile.bcc' to `./src/Makefile'
+ and copy `./lib/getopt*' to `./src'. Well, maybe you want
+ to edit the `./src/Makefile' so it reflects your local
+ environment?! However, simply change to the file
+ directory `./src', then type `make' to create the
+ binary DVIChk program.
+
+Copyright Notes:
+================
+All files of this distribution are either
+Copyright (C) by the Free Software Foundation Inc., or
+Copyright (C) by Thomas Esken <esken@gmx.net> under
+the GNU GENERAL PUBLIC LICENSE. See the file `COPYING' and
+the Copyright notice leading each file for further details.
diff --git a/dviware/dvichk/dvichk-de.txt b/dviware/dvichk/dvichk-de.txt
new file mode 100644
index 0000000000..58c4420378
--- /dev/null
+++ b/dviware/dvichk/dvichk-de.txt
@@ -0,0 +1,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
+
+
diff --git a/dviware/dvichk/dvichk-en.txt b/dviware/dvichk/dvichk-en.txt
new file mode 100644
index 0000000000..dd86bdcb01
--- /dev/null
+++ b/dviware/dvichk/dvichk-en.txt
@@ -0,0 +1,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
+
+