.TH BIBVIEW 1 "Jun 1993"
.SH NAME
bibview \- 
eine graphische Benutzerschnittstelle 
f\(uer BibTeX-Literaturdatenbanken.
.SH SYNOPSIS
\fBbibview  [standardoptions] [-file bibdatei] [-rcfile konfdatei]  \fP 
.SH DESCRIPTION
     
Bibview erleichtert die Verwaltung von BibTeX-Literaturdatenbanken
(im folgenden BiBs genannt).
Es k\(oennen bereits vorhandene BiBs geladen sowie neue BiBs erzeugt 
werden . In einer Konfigurationsdatei k\(oennen auf einfache 
Weise neue Typen definiert werden oder Felder zu existierenden
Typen hinzugef\(uegt werden.
.br
Beim Laden einer BiB erscheint ein
Bibliographiefenster mit einer Men\(ueleiste, die die
Kommandos zur Bearbeitung der BiB enth\(aelt. Unter anderem
kann man sich eine Liste mit einem \(Ueberblick \(ueber alle
Eintr\(aege der BiB oder mit Eintr\(aegen,
die bestimmte Kriterien erf\(uellen, anzeigen lassen.
Durch das Anklicken
des Eintrags mit der linken Maustaste erscheint ein Fenster
zum Editieren des Eintrags, das dem Typ des Eintrags angepa\(sst ist.
Die f\(uer den bearbeiteten Typ ben\(oetigten Felder
sind durch dicke Umrandung gekennzeichnet. Editieren eines
Feldes erfolgt durch das Positionieren der Maus in das
Kartenfenster. Das aktuelle Eingabefeld hat keinen Rand.
Das Eingabefeld kann durch Dr\(uecken der <tab>- bzw. <esc>-Taste
vorw\(aerts bzw. r\(ueckw\(aerts bewegt werden. Durch das Dr\(uecken
der rechten Maustaste in einem Feld wird dieses Feld zum neuen
Eingabefeld. Dieses Verhalten kann in der Ressourcedatei
oder in der Datei .bibviewrc ge\(aendert werden. Die Eingabe
geht dann an das Feld, in dem sich der Mauscursor befindet.

Im Feld BibTeX-Key  wird der f\(uer jeden Eintrag
erforderliche cite-key abgefragt. 
Makros k\(oennen durch das Voranstellen
des Zeichens '@' eingegeben werden.

.SH Das Hauptfenster

Das Hauptfenster, das beim Aufruf von bibview erscheint,
bietet folgende Men\(ues:
\fBDatei\fR:  Funktionen zum Laden und Speichern von BiBs
.RS
.IP "\fINeu\fR" 19
Anlegen einer neuen Bib.
.br
.IP "\fIOeffnen\fR" 19
Einlesen einer bereits vorhandenen Bib.
.br
.IP "\fISchliessen\fR" 19
Schlie\(ssen einer ge\(oeffneten Bib.
.br
.IP "\fISpeichern\fR" 19
Speichern einer Bib.
.br
.IP "\fISpeichern unter\fR" 19
Speichern einer Bib unter neuem Namen.
.br
.IP "\fIBeenden\fR" 19
Beenden einer Sitzung.
.RE

\fBDienste\fR:
.br
.RS
.IP "\fIKonsistenzcheck\fR" 19
Eintr\(aege werden auf Vollst\(aendigkeit 
\(ueberpr\(ueft.
.br
.IP "\fIMischen\fR" 19
Eintr\(aege  aus einer Bib werden in eine andere 
\(uebernommen. Eintr\(aege mit bereits vorhandenen Schl\(uesseln werden
ignoriert.
.br
.IP "\fIDruck in Datei\fR" 19
Eintr\(aege einer Bib werden in LaTeX-Datei 
gespeichert
.br
.IP "\fIMakros editieren\fR" 19
Editieren von Makros
.br
.IP "\fIKonfiguration laden\fR" 19
Laden einer Konfigurationsdatei
.RE

\fBOptionen\fR: Festlegen von Voreinstellungen
.br
.RS
.IP "\fIWarnton bei Fehlern\fR" 19
Beim Auftreten von Fehlern ert\(oent ein 
Warnton (Voreinstellung: TRUE)
.br
.IP "\fISicherungskopien\fR" 19
Vor dem Schreiben einer Bib wird eine
Sicherungskopie mit der Endung .bak angelegt (Voreinstellung: TRUE)
.br
.IP "\fIIcons auf Desktop\fR" 19
Icons zu Listen- und Kartenfenster
werden auf dem zugeh\(oerigen Bibliographiefenster
abgelegt. Diese Option funktioniert nicht unter allen
Window-Managern. (Voreinstellung: FALSE)
.br
.IP "\fIAutom. \(Ueberpr\(uefung\fR" 19
Beim Laden einer Datei wird
automatisch ein Konsistenzcheck durchgef\(uehrt.
(Voreinstellung: FALSE)
.br
.IP "\fIZwingende Felder\fR" 19
Ein Abspeichern eines Eintrags ist nur
m\(oeglich, wenn alle von BibTeX geforderten Felder
angegeben sind.  (Voreinstellung: FALSE)
.br
.IP "\fIIgnoriere Gross/Klein\fR" 19
Bei der Suche nach Eintr\(aegen
wird Gro\(ss/Kleinschreibung ignoriert.  (Voreinstellung: TRUE)
.br
.IP "\fIDrucke als BibTeX\fR" 19
Beim Ausdrucken von BibTeX-Dateien
wird eine LaTeX-Datei mit \\nocite-Befehl erzeugt (Voreinstellung:
TRUE). Das verwendete Style-file ist alpha. Die Voreinstellung
kann im [StyleFile] Teil der Konfigurationsdatei
ver\(aendert werden.
.br
Andernfalls ist die entstehende LaTeX-Datei von
einem festgelegten Format.
.RE
               
\fBFenster\fR: 
.br
.RS
.IP "\fIKaskadieren\fR" 19
zusammengeh\(oerige Fenster werden entsprechend gruppiert.
.RE

\fBHilfe\fR:
.br
.RS
Das Hilfe-Men\(ue bietet Hilfstexte zu den folgenden Punkten an:
.br
\fIUeberblick\fR
.br
\fIHauptfenster\fR
.br
\fIBibliographiefenster\fR
.br
\fIListenfenster\fR
.br
\fIKartenfenster\fR
.br
\fIAndere Fenster\fR
.br
\fIProgramm-Info\fR
.RE


.SH Das Bibliographiefenster

Die Men\(ueleiste des Bibliographiefensters enth\(aelt Funktionen,
mit denen der Benutzer die BiB bearbeiten kann.

.RS
.IP "\fBNeu\fR:" 17
Pulldownmen\(ue mit den BibTeX-Typen. Zum Eingeben von Eintr\(aegen
eines anderen Typs als den Standard-BibTeX-Typen dient der Punkt
'Kartentyp'.
.br
.IP "\fBSuchen\fR:" 17
Suchen nach bestimmten Eintr\(aegen. Es erscheint
ein Fenster, in dem f\(uer die Felder regul\(aere Ausdrucke
eingegeben werden k\(oennen. Das Ergebnis der Suche (alle
Eintr\(aege, auf die die UND-Verkn\(uepfung der Felder
zutrifft) wird im Listenfenster angezeigt.
.br
Falls ein regul\(aerer Ausdruck in dem Feld \fIAlle Felder\fR
eingegeben wird, enth\(aelt das Ergebnis alle Eintr\(aege,
bei denen der Ausdruck in irgendeinem Feld vorkommt.
.br
Eine Suche nach benutzerdefinierten Feldern ist m\(oeglich.
Dabei m\(uessen der Name des Feldes (kein regul\(aerer Ausdruck)
sowie ein regul\(aerer Ausdruck eingegeben werden.
.br
.IP "\fBListe\fR:" 17
Im Listenfenster werden alle Eintr\(aege der
BiB angezeigt. Durch das Anklicken eines Eintrags erscheint
ein Kartenfenster zum Editieren des Eintrags.
.br
.IP "\fBMakros\fR:" 17
Ein Fenster zum Editieren der STRING- und PREAMBLE-Makros erscheint.
.br
.IP "\fBDrucken\fR:" 17
Eine LaTeX-Datei mit den Datens\(aetzen der BiB wird erzeugt.
.br
.IP "\fBSpeichern\fR:" 17
Speichern der BiB. Die BiB bleibt im Arbeitsspeicher geladen.
.br
.IP "\fBSchliessen\fR:" 17
Entfernen der BiB aus dem Arbeitsspeicher.
.RE

.SH Das Listenfenster
Das Listenfenster erscheint durch das Anklicken des
Men\(uepunkts \fIListe\fR im Bibliographiefenster,
als Ergebnis einer Suche oder im Fall eines
Konsistenzchecks.
Die Men\(ueleiste des Listenfensters bietet folgende
Kommandos:
.RS
.br
.IP "\fBDrucken\fR:" 17
Eine LaTeX-Datei mit den Datens\(aetzen der Liste
wird erzeugt.
.br
.IP "\fBSpeichern\fR:" 17
Die Datens\(aetze der Liste werden als neue BiB gespeichert.
.br
.IP "\fBSortieren\fR:" 17
Die Datens\(aetze der Liste werden sortiert. Das Sortierkriterium
kann durch ein Men\(ue gew\(aehlt werden.
.br
.IP "\fBSchliessen\fR:" 17
Das Listenfenster wird geschlossen.
.RE

.SH Das Kartenfenster

Das Kartenfenster dient zum Erstellen von neuen Eintraegen
bzw. zum Editieren vorhandener Eintraege.
.br
Das Eingabefeld enthaelt keinen Rand bzw. (in der Farbversion)
einen roten Rand. Es kann durch die <tab>- und <esc>-Tasten
und durch das Druecken der rechten Maustaste in einem Feld
geaendert werden.
.br
In der Ressourcedatei bzw. in der Datei .bibviewrc kann dieses
Verhalten geaendert werden.
.br
Die erforderlichen Klammern fuer Feldinhalte werden automatisch
ergaenzt. Zur Eingabe von Makros und der Zeichen '#' und '@' ist
erforderlich, ein '@' voranzustellen.
.br
In der Ressourcedatei bzw. in der Datei .bibviewrc kann dieses
Verhalten geaendert werden.
.br
Die Men\(ueleiste des Kartenfensters bietet folgende
Kommandos:
.br
.RS
.IP "\fBVerdoppeln\fR:" 17
Ein neues Kartenfenster wird ge"offnet,
in dem die Feldinhalte des aktuellen Kartenfensters
\(uebernommen werden. Der Typ der neuen Karte kann
von einem Men\(ue gew\(aehlt werden. Es werden nur
diejenigen Feldinhalte ber"ucksichtigt, die schon
abgespeichert sind. Der BibTeX-Schl\(uessel der neuen
Karte ist leer.
.br
.IP "\fBBenutzerdaten\fR:" 17
Das Kartenfenster wird um die
benutzerdefinierten Felder erweitert bzw. gek\(uerzt.
.br
.IP "\fBAnmerkung\fR:" 17
Das annote-Feld eines Eintrags
kann in einem eigenen Fenster editiert werden.
.br
.IP "\fBL\(oeschen\fR:" 17
L\(oeschen des Eintrags aus der BiB.
.br
.IP "\fBSpeichern\fR:" 17
Speichern des Eintrags in der BiB.
.br
.IP "\fBKopieren\fR:" 17
Einf\(uegen des Eintrags in andere BiB.
.br
.IP "\fBCrossref\fR:" 17
Ein Kartenfenster wird ge\(oeffnet. Dieses Kartenfenster enth\(aelt
den Eintrag, auf den das crossref-Feld verweist.
.IP "\fBSchliessen\fR:" 17
Schlie\(ssen  des Kartenfensters.
.RE

.SH Die Konfigurationsdatei

Eine Konfigurationsdatei erm\(oeglicht es, das Verhalten von
\fBbibview\fR an die eigenen Vorstellungen anzupassen.
Standardm\(ae\(ssig wird als Konfigurationsdatei die Datei
\fI.bibviewrc\fR im Home-Directory des Benutzers verwendet.
.br
Die Konfigurationsdatei kann die folgenden Abschnitte
enthalten:
.br
\fB[Options]\fR: Zeilen der Form
.ti 5
\fB<option> : <bool>\fR
.br
k\(oennen zur Voreinstellung der Optionen verwendet werden.
.br
<option> kann sein \fBBeepOnError, IconsOnDesk, MakeBackups,
AutoCheckBib, RequiredFields, IgnoreCase, PrintAsBib\fR oder
\fBDisplayErrWin\fR. 
.br
<bool> kann \fBtrue\fR oder \fBfalse\fR sein.
.br
\fB[Types]\fR: Dieser Abschnitt der Konfigurationsdatei wird verwendet,
um neue Typen zu definieren, existierende Typen zu veraendern
oder um neue Felder zu allen definierten Typen hinzuzuf\(uegen.
.br
Typ-Definitionen beginnen mit Zeilen der Form
.ti 5
\fBt : <typ>\fR
.br
(definiere einen neuen Typ <typ> oder f\(uege Felder an den
existierenden Typ <typ> an)
.ti 5
\fBtc : <typ>\fR
.br
(definiere einen neuen Typ <typ> oder f\(uege Felder an den
existierenden Typ <typ> an, wobei bereits definierte Felder
undefiniert werden)
.ti 5
\fBt : all\fR
.br
(f\(uege die folgenden Felder zu allen definierten Typen hinzu).
.br
Einer Typ-Definition folgt eine beliebige Anzahl von
Feld-Definitionen der Form
.ti 5
\fBf : <feld>\fR
.br
(<feld> wird zum Feld des gerade definierten Typs oder von allen 
Typen (falls `all' angegeben ist))
.ti 5
\fBrf : <field name>\fR
.br
(<feld> wird zum notwendigen Feld des gerade definierten Typs oder von allen 
Typen (falls `all' angegeben ist))
.br
\fB[UserFields]\fR: Dieser Abschnitt wird verwendet, um benutzerdefinierte
Felder f\(uer alle oder f\(uer bestimmte Typen zu definieren.
Er enth\(aelt Zeilen der Form
.ti 5
\fB<typ> : <feld>\fR
.br
or
.ti 5
\fBall : <feld>\fR
.br
\fB[SortFields]\fR: In diesem Abschnitt k\(oennen die Felder festgelegt
werden, nach denen es m\(oeglich sein soll, eine Liste zu sortieren.
Eine Sortierreihenfolge kann bestimmt werden.
Der Abschnitt enth\(aelt Zeilen der Form
.ti 5
\fB<feld>\fR
.br
or
.ti 5
\fB<feld> : <reihenfolge>\fR
.br
Falls \fB$clear$\fR als <feld> angegeben wird, werden alle
bereits definierten Sortier-Felder zur\(ueckgenommen.
.br
\fB<reihenfolge>\fR kann sein \fBn\fR f\(uer Namen oder 
\fBd\fR f\(uer Datumsangaben der Form \fBtt.mm.yyyy\fR.
Falls keine Sortierreihenfolge angegeben wird, wird
lexikographische Ordnung verwendet.
.br
\fB[SearchFields]\fR: Dieser Abschnitt wird verwendet, um
die Felder zu definieren, die im Suchen-Fenster angeboten 
werden. Er enth\(aelt Zeilen der Form
.ti 5
\fB<feld>\fR
.br
Falls \fB$clear$\fR als <feld> angegeben wird, werden alle
bereits definierten Such-Felder zur\(ueckgenommen.
.br
\fB[ListFields]\fR: In diesem Abschnitt werden die
Felder definiert, die im Listenfenster angezeigt werden.
Er enth\(aelt Zeilen der Form
.ti 5
\fB<feld> : <weite>\fR
.br
<feld> kann sein \fBmainkey\fR, \fBcardtype\fR oder
ein Feldname, der f\(uer BibTeX standardm\(ae\(ssig definiert
ist oder in einem \fB[Types]\fR-Abschnitt definiert wurde.
.br
<weite> ist die Anzahl von Zeichen, die zur Darstellung
des Feldes verwendet wird.
.br
\fB[Predefines]\fR: Dieser Abschnitt wird verwendet, um
Daten zu definieren, die im Suchen-Fenster verwendet
werden k\(oennen. Er enth\(aelt Zeilen der Form
.ti 5
\fB<feld> : <daten>\fR
.br
<feld> kann sein \fBallfields\fR, \fBmainkey\fR, 
\fBcardtype\fR oder
ein Feldname, der f\(uer BibTeX standardm\(ae\(ssig definiert
ist oder in einem \fB[Types]\fR-Abschnitt definiert wurde.
.br
\fB[LatexHeader]\fR und \fB[LatexFooter]\fR: In diesen
Abschnitten k\(oennen die Kopfzeilen und Fu\(sszeilen definiert
werden, die in der LaTeX-Datei, die vom \fBPrintf\fR-Kommando
verwendet werden, definiert werden.
.br
\fB[BibDir]\fR: Dieser Abschnitt enth\(aelt den
absoluten Pfadnamen des Dateiverzeichnisses, in dem sich
die BibTeX-Dateien befinden.
.br
\fB[StyleFile]\fR: Dieser Abschnitt enth\(aelt den
Namen des BibTeX-Stils, der im LaTeX file, das mit dem
\fBPrint\fR-Kommando erzeugt wird, verwendet wird,
.br
\fB[AnnoteField]\fR: Dieser Abschnitt enth\(aelt den Namen
des Feldes, das f\(uer Anmerkungen verwendet wird.
.br
\fB[SortedBy]\fR: In diesem Abschnitt kann der Name des
Feldes angegeben werden, nach dem eine Liste standardm\(ae\(ssig
sortiert ist.
.br
\fB[Indent]\fR: Dieser Abschnitt enth\(aelt Angaben \(ueber
das Layout der BibTeX-Datei, die von bibview erzeugt wird.
.br 
Er enth\(aelt Zeilen der Form
.ti 5
\fB<parameter> : <zahl>\fR
.br
<parameter> kann sein \fBFldIndent\fR (gibt an, wie weit die
Feldnamen einger\(ueckt sind),
\fBContIndent\fR (gibt an, wie weit die erste Zeile des
Feldinhalts einger\(ueckt ist),
\fBNewlineIndent\fR (gibt an, wie weit die folgenden Zeilen des
Feldinhalts einger\(ueckt sind) und
\fBMaxLinelen\fR (maximale Zeilenl\(aenge der LaTeX-Datei 
mit \nocite-Kommandos).

Standardm\(ae\(ssig wird als Konfigurationsdatei die Datei \fI.bibviewrc\fR 
im Home-Directory des Benutzers verwendet.
Mit dem Men\(uepunkt \fIKonfiguration laden\fR des
Dienste-Men\(ues ist es m\(oeglich, eine andere Konfigurationsdatei
zu laden, wobei jedoch der Options-Teil nicht ausgewertet wird.
.br
Ein Beispiel f\(uer eine Konfigurationsdatei enth\(aelt die 
Datei bibviewrc.

.SH OPTIONS

\fBstandardoptions\fR:
.br
Zu den Standardoptionen geh\(oeren Kommandozeilenparameter
wie -display, -geometry, -iconic, -foreground, -background usw.
.br
\fB-file <bibdatei>\fR:
.br
Die Datei \fI<bibdatei>\fR wird beim Starten von  \fBbibview\fR
geladen.
.br
\fB-rcfile <konfdatei>\fR:
.br
Die Konfigurationsdatei \fI<konfdatei>\fR wird beim Starten von
\fBbibview\fR verwendet.
.br
\fB-bibdir <directory>\fR:
.br
Bei der Auswahl von BibTeX-Dateien wird von \fI<directory>\fR
ausgegangen.

.SH COPYRIGHT
Copyright 1992 Technische Universit\(aet M\(uenchen

.SH AUTHORS
Holger Martin, Peter Urban und Armin Liebl.
.br
Kommentare, Fehlermeldungen und Verbesserungsvorschl\(aege
werden dankbar angenommen von
liebla@informatik.tu-muenchen.de