Vb.120: Hilfe

[Bernhard Eversberg]

Verlautbarung 120 der Entwicklungsabteilung                        1999-10-07
-------------------------------------------

ftp:  ac15/a99/update/a99upd.exe   und  help.lzh
      ac15/alcarta/update/alcupd.exe

Man muss nicht alles wissen, aber wo die Taste F1 ist
-----------------------------------------------------
Nolens volens kommen auch wir nicht darum herum, der gesunkenen und
weiter sinkenden Neigung Rechnung zu tragen (ohne ihr Vorschub leisten
zu wollen, aber das kann gleichwohl leider die Folge sein) papierene
Beschreibungen herauszusuchen, in die Hand zu nehmen, eine bestimmte
Seite zu suchen und diese auch noch zu lesen.
Will besagen: jede Hilfe, die nicht online im Moment des Bedarfs abgerufen
werden kann, hat wenig Chancen, ueberhaupt in Anspruch genommen zu werden,
also ihren Zweck zu erfuellen.
Das Hilfewesen der Programme a99/alcarta hatte sich aus einfachen Anfaengen
entwickelt. Jetzt, da man mit RTF weitreichende Moeglichkeiten der Gestaltung
hat, musste das Ganze nochmals ueberdacht werden. Insbesondere sollten die
Dateien jetzt so strukturiert sein, dass sie bei einer Veraenderung der
Fenstergroesse nicht ploetzlich unordentlich aussehen, denn das RTF-Fenster
macht selber den Zeilenumbruch des darin befindlichen Textes.
Die neue Kollektion von Hilfedateien muss noch weiter ausgebaut werden,
die englischen Files liegen ausserdem noch nicht vor.
Die bisher vorhandenen Dateien funktionieren weiter, sie muessten nur
umbenannt werden (siehe unten) und ohne .RTF, wenn es noch keine echten
RTF-Dateien sind. Auf Anhieb wird daher nun bei F1 oft nichts kommen,
wenn Sie HELP.LZH nicht uebernehmen:
Es gibt jetzt einen Satz von neuen Dateien. Wer eigene, verbesserte 
Versionen hat, kann diese auf die neuen Namen umstellen (siehe unten).
(Die Namensstruktur wird veraendert: Das Praefix HE bzw. HA wird aufgegeben.)
Empfehlung: Haengen Sie an das Programmverzeichnis (Eintragung "ProgDir"
in Ihrer INI-Datei) ein Verzeichnis HELP und kopieren Sie alle Hilfedateien
dort hin, bis auf die datenbankspezifischen, die gehoeren nach DbDir.
Jetzt kann man das Hilfeverzeichnis auch woanders hinlegen: dafuer steht
ein neuer INI-Befehl,
HelpDir=...
Dahinter kann ein vollstaendiger Verzeichnisname stehen, z.B.
HelpDir=c:\a99\Hilfe
oder ein relativer (der kein \ enthalten darf):
HelpDir=hilfe
Dieser Name muss dann am ProgDir haengen.

Gesucht wird in der Reihenfolge  Lokal / DbDir / ProgDir\Help / ProgDir,
was wohl allgemein sinnvoll ist.

Nun zu den neuen Dateien. Es sind alles RTF-Dateien, und sie liegen in
Deutsch und bald auch Englisch vor. Daher hat der eigentliche Dateiname 
immer bis zu 5 Buchstaben, denn es kommt GER oder ENG hintendran.
(Wir wollen nicht ohne Not auf laengere Dateinamen ausweichen, sonst ist
Aerger vorprogrammiert, wenn z.B. Dateien auf dem Umweg ueber DOS kopiert
oder mit einem aelteren Packer archiviert werden.)

Hier die wichtigsten neuen Hilfedateien. An die Namen kommt immer noch
GER.RTF (bzw. ENG.RTF) hinten dran.

Die ersten 5 Dateien kommen alle bei F1 mit Focus im Auswahlfeld:
(frueher kam in jedem Fall der Text HEBO1..., jetzt haengt es davon ab, 
was gerade in der Auswahl zu sehen ist)

recrd   Aufnahmespeicher     Normalzustand (aktueller Satz)
resrv   Reservespeicher      Alt+r
reslt   Ergebnismenge        Alt+e
konfg   Schema-Anzeige       Alt+y (CFG-Liste)
prmpt   Abfrageliste         Alt+y (Abfrageliste)
  
Wie gesagt, wenn man diese Dateien auf's Datenbankverzeichnis kopiert, werden
sie von dort geholt. Somit kann man sie datenbankspezifisch ausbauen und an
die Datenbank binden, wie immer schon bei den Hilfedateien.

write   Wenn der Focus im Schreibfeld ist   (frueher HEBO2GER)
commd   ... im Feld "Suchbefehl".           (frueher HEBO3GER)
find    Hinweise zu Suchbefehlen
displ   Hilfen zu den Buttons               (frueher HEBO4GER)

genrl   Allgemeine Hilfen zur Benutzung einer Datenbank. Kommt, wenn man
        den Fragezeichen-Button hat und keine datenbankspezifische Datei
        dbnger.rtf vorhanden ist.      (vorher HEGENGER)

exprt   Fuer den Menuepunkt "Export"   (vorher HEEXPGER)
menu    Hilfe zu den Menuepunkten      (       HEMNUGER)

TIP:
Wenn Sie also eine gute, eigene Version von HEMNUGER hatten: Umbenennen in
MENUGER und unsere menuger.rtf loeschen, dann sollte das kein Problem sein.
Wenn die aeltere HEMNUENG weiter funktionieren soll: MENUENG draus machen.

Bernhard Eversberg
Universitaetsbibliothek, Postf. 3329, 
D-38023 Braunschweig, Germany
Tel.  +49 531 391-5026 , -5011 , FAX  -5836
e-mail  B.Eversberg at tu-bs.de