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