1STGUIDE.ACC		    29.04.1992		     ╜ Digital Design
=====================================================================

			  Inhaltsübersicht
			  ----------------

1.	Einführung
2.	Bedienung
3.	Dateiformate
	3.1.	▌Text▌UTIL\TEXT▌dateien (ASCII, 1st WORD, .OUT)
	3.2.	▌Resource▌UTIL\RESOURCE▌dateien (.RSC)
	3.3.	▌Rasterbild▌UTIL\IMAGE▌dateien (.IMG, XIMG, .IFF)
	3.4.	▌Meta▌UTIL\META▌dateien (.GEM)
	3.5.	▌Soundsample▌UTIL\SOUND▌dateien (.SAM, .SND)
	3.6.	▌Dump▌UTIL\DUMP▌-Modus
4.	Kommunikation
	4.1	1st Guide und GEMINI
	4.2	1st Guide und TC_HELP
	4.3	1st Guide und CALCLOCK
	4.4	1st Guide und das GEM-Clipboard
	4.5	1st Guide und andere Applikationen
5.	Geräteausgabe
6.	▌Rebuild▌UTIL\REBUILD▌-Funktion
7.	Konfiguration
8.	Grenzen
9.	▌1st Index▌UTIL\1STINDEX▌
10.	▌Neu in Version▌UTIL\VERSION▌
11.	Referenz

---------------------------------------------------------------------

1.	Einführung
------------------

Hatten	Sie  schon  immer  Probleme, zur richtigen Zeit die richtigen
Informationen parat zu haben?

Dann  wird  Ihnen  dieses  Accessory  gerade  recht  kommen.  Hierbei
handelt  es sich in erster Linie um ein Hypertext-System, welches Sie
spielend  und  zielgerichtet  durch einen Dschungel von Informationen
führt.	Der  Multi-Window-View	mit  perfekter GEM-Einbindung schafft
dabei den nötigen Durchblick für Ihre Arbeit.

In   der  Tat,	eine  hervorstechende  Eigenschaft  dieses  Programms
gegenüber     anderen	bekannten   Informations-Systemen   ist   die
Möglichkeit  der  Öffnung eines neuen Fensters bei jeder Verzweigung.
Der  gesamte  Informationspfad	bleibt	damit ständig im Zugriff, Sie
können	verschiedene  Pfade  gleichzeitig  verfolgen  und haben damit
verschiedene Stellen gleichzeitig im Blick.

Die  Hypertext-Eigenschaft  wird  ermöglicht,  indem  Sie  sogenannte
"Links"   (Verzweigungen)   in	 Ihren	Dateien  auf  einfache	Weise
definieren  können  (je  nach Dateiformat). Physisch präsentiert sich
das  Informationssystem  als  hierarchisches System von Hilfsdateien,
in   dem  sich	durch  die  Links  ein	umfassendes  Informationsnetz
herausbildet, das schnell und zielgerichtet durchsucht werden kann.

Die   unterstützten  Dateiformate  sind  nicht	willkürlich  gewählt,
sondern   es   handelt	 sich  hierbei	um  die  systemübergreifenden
Standard-GEM-Formate.  1st  Guide  wurde  portabel in Purbo C für den
Atari  ST(E)/TT  und  für  IBM-Kompatible  geschrieben	und sollte in
jeder Auflösung und mit jeder Grafikkarte arbeiten.


2.	Bedienung
-----------------

Wenn  Sie bereits mit Purbo-C für den Atari ST gearbeitet haben, wird
Ihnen  die  Bedienung  wohl  bekannt vorkommen. In der Tat orientiert
sich   1st   Guide   hier   an	 Purbo-C,   d.h.   Links   (Keywords,
Verzweigungsschlüssel)	  werden   in	Texten	 fett	unterstrichen
dargestellt,  und  die	Verzweigung  wird  durch  Doppelklick mit der
linken	Maustaste  auf	das  jeweilige	Keyword ausgelöst (oder durch
Drücken  der  RETURN/ENTER/HELP-Taste  nach Selektion des gewünschten
Eintrags).  Dabei wird jedoch bereits der erste Unterschied deutlich:
Das  Hilfe-Fenster  wird  nicht  mit  dem  neuen  Datei-Inhalt	über-
schrieben,   sondern   es   öffnet  sich  ein  eigenes	Fenster.  Der
Informationspfad   wird   genau   wie  bei  Purbo-C  im  Fenstertitel
dargestellt.

Wenn  Sie  den	Doppelklick  bei gedrückter Control-, Alternate- oder
Shift-Taste   ausführen   (bzw.  statt	RETURN/ENTER  die  HELP-Taste
drücken),  so  wird kein neues Fenster geöffnet, sondern das aktuelle
mit  dem  neuen  Datei-Inhalt  überschrieben,  wie  das etwa auch bei
Purbo-C  geschieht  (Der  ursprüngliche  Inhalt wird aus dem Speicher
gelöscht,  wenn der neue erfolgreich geladen werden konnte). Man kann
1st  Guide auch so konfigurieren (siehe Kapitel 7), daß standardmäßig
das  Fenster  überschrieben und nur bei Drücken einer Statustaste ein
neues Fenster geöffnet wird.

Mit   der  UNDO-  oder	ESC-Taste  können  Sie	den  Informationspfad
schrittweise  zurückverfolgen.	Dabei wird die vorhergehende Datei im
obersten  Fenster  überladen  und  an  der Position angezeigt, wo Sie
abgezweigt sind.

Fast  überflüssig  zu  erwähnen, da₧ Sie die Info-Fenster wie gewohnt
mit  der  Maus manipulieren, d.h. beliebig auf Ihrem Desktop (bzw. in
der  Applikation)  positionieren,  zoomen  usw. und beliebig scrollen
können.   Alternativ   zur   Maussteuerung   steht   eine  Reihe  von
▌Tastatur▌TASTATUR▌-Kommandos   zur   Verfügung,   welche   Ihnen   die   Arbeit
erleichtern   können.	Außerdem   gibt  es  eine  "Echtzeit-Scroll"-
Funktion:   Wenn   Sie	 bei  gedrückter  rechter  Maustaste  in  den
Sliderbereich  klicken,  können  Sie  bis zum Loslassen bzw. erneuten
Klick  der  linken Maustaste durch bloße Mausbewegung durch die Datei
"browsen".

Das   Programm	 kann	beliebig   viele   Info-Fenster  gleichzeitig
verwalten,  allerdings	beschränkt  der  Window-Manager  des  GEM  in
gegenwärtigen  Versionen  die  Gesamtzahl  der	Fenster  auf  7.  Sie
erhalten   eine   entsprechende  Meldung,  falls  kein	Fenster  mehr
geöffnet werden kann.

Wenn  Sie  mit	der Maus einmal auf das oberste Info-Fenster klicken,
erscheint  ein	Popup-Menü, mit dem Sie je nach Dateiart verschiedene
Parameter  einstellen  oder  Konvertierungen  vornehmen  können.  Die
Bedienung  kann  wahlweise  auf  GEM-Art  (einmal  kurz  drücken  und
loslassen,   auswählen	 und   danach  noch  mal  drücken)  oder  auf
Macintosh-Art	(Maustaste   gedrückt	halten,  auswählen  und  dann
loslassen) erfolgen.

Übrigens,     wenn   Sie   den	 Popup-Menü-Einfachklick   bzw.   den
Verzweigungs-Doppelklick  bei gedrückter rechter Maustaste ausführen,
können	Sie  die  entsprechende  Aktion  auch  in  einem Info-Fenster
auslösen,  das	nicht  oben  liegt (ohne da₧ dieses, wie es sonst der
Fall  wäre,  nach  oben  kommt).  Wu₧ten  Sie schon, da₧ eine analoge
Möglichkeit  auch  im normalen Desktop mit seinen Verzeichnisfenstern
besteht   (Markieren,	Öffnen,  Kopieren  usw.)?  Dies  ist  in  den
gewöhnlichen  Handbüchern  nicht  dokumentiert,  kann  aber  manchmal
recht nützlich sein.

Das  beiliegende  Informationssystem  ist für den informationsbedürf-
tigen  ST-C- und Assembler-Programmierer gedacht. Es ist so angelegt,
da₧  Sie  per Tastatur bzw. Doppelklick jede detaillierte Information
über  das  Betriebssystem  ▌TOS▌TOS▌ des ST mit ▌GEM▌GEM▌ erreichen können, wobei
Sie  gleich  hier  beginnen  können.  Wie Sie bemerken werden, ist es
allerdings noch nicht ganz komplett.


3.	Dateiformate
--------------------

Wie   schon  erwähnt,  werden  sämtliche  Standard-GEM-Formate	sowie
natürlich  das	ASCII-Textformat  unterstützt  und  können  jederzeit
geladen  werden.  Die  Erkennung  eines  Formates  erfolgt anhand der
Extension im Dateinamen:

    .RSC      GEM-▌Resource▌UTIL\RESOURCE▌-Dateien,
	      Bsp.: ▌TOS.RSC▌UTIL\TOS.RSC▌
    .IMG      GEM-▌Image▌UTIL\IMAGE▌-Dateien (Rastergrafiken),
	      Bsp.: ▌TIGER.IMG▌UTIL\TIGER.IMG▌, ▌COLORS.IMG▌UTIL\COLORS.IMG▌, ▌AAFALL.IMG▌UTIL\AAFALL.IMG▌
    .IFF      Interchange File Format (ILBM - Interleaved ▌Bitmaps▌UTIL\IMAGE▌),
	      Bsp.: ▌AUGEN_2.IFF▌UTIL\AUGEN_2.IFF▌
    .GEM      GEM-▌Meta▌UTIL\META▌dateien (Objektgrafiken),
	      Bsp.: ▌TOOLS.GEM▌UTIL\TOOLS.GEM▌, ▌TIGER.GEM▌UTIL\TIGER.GEM▌
    .SAM,.SND 8-Bit-▌Soundsample▌UTIL\SOUND▌dateien,
	      Bsp.: ▌WELCOME.SAM▌UTIL\WELCOME.SAM▌
    sonst     ASCII-▌Text▌UTIL\TEXT▌dateien,
	      1st Word Plus Dateien (.DOC) oder
	      Ausgabe-Dateien mit Schriftattributen (.OUT)

Wenn  Sie  etwa  eine  Textdatei in eine Datei mit der Extension .IMG
umbenennen,  könnten  Sie  sehen,  wie sich Ihr Text als Rastergrafik
präsentiert.  Ich  rate  Ihnen	jedoch von derlei Experimenten ab, da
Sie sonst möglicherweise unliebsame Überraschungen erleben könnten.

Verzweigungsmöglichkeiten  sind  derzeit  beim	Text-  und  Resource-
Format	eingebaut.  Bei  Rasterbildern	kann  ich  mir	keine  solche
Funktion  vorstellen,  bei Metadateien bieten sich die String-Objekte
(V_GTEXT  oder	V_JUSTIFIED)  dafür  an,  ich  werde  dies  demnächst
implementieren,   so   da₧   Sie  dann	auch  diese  Dateien  in  Ihr
Info-System	einbinden    können.   Ansonsten   können   Sie   die
Grafik-Formate	 derzeit  zumindest  als  End-Knoten  in  Info-Ketten
verwenden.


4.	Kommunikation
---------------------

4.1	1st Guide und GEMINI
----------------------------

Wenn  Sie  den Shareware-Desktop GEMINI von Stefan Eissing und Gereon
Steffens  benutzen,  können  Sie  die Arbeit mit 1st Guide wesentlich
komfortabler   gestalten.   1st   Guide   versteht   das   in  GEMINI
implementierte	Kommunikationsprotokoll.  Das  bedeutet, wenn Sie das
1STGUIDE.ACC-Icon  auf	dem offenen GEMINI-Desktop ablegen, so können
Sie  Dateien  aus  einem GEMINI-Fenster daraufziehen, woraufhin diese
von  1st  Guide  geöffnet  werden.  Sie  ersparen  sich  so die unter
Umständen  lästige  Suche  in  der  Datei-Auswahl-Box. Es können auch
mehrere  Dateien  gleichzeitig	gezogen  werden,  wobei dann für jede
Datei  ein  entsprechendes  Fenster  geöffnet  wird.  Au₧er  auf  das
1STGUIDE.ACC-Icon  können Sie Objekte aus GEMINI-Fenstern auch in ein
von  1st Guide geöffnetes Fenster ziehen. Das hat dann zur Folge, da₧
der  ent-  sprechende  Fensterinhalt mit dem Inhalt des neuen Objekts
überschrieben  wird  (entspricht  Control-D mit Dateiauswahl). Ziehen
Sie  mehrere  Objekte  auf  ein  1stGuide-Fenster,  so	wird  für die
weiteren   Objekte   jeweils   ein  weiteres  Fenster  geöffnet.  Ein
Doppelklick  auf  das  1STGUIDE.ACC-Icon bringt die Datei-Auswahl-Box
zum   Vorschein   (entspricht	Control-O  bzw.  Anklicken  des  Acc-
Menüpunktes).  Melden Sie 1STGUIDE.ACC bei GEMINI als Applikation auf
einen  bestimmten Dateityp an (z.B. *.HLP), so können Sie durch einen
Doppelklick  auf  ein  derartiges  Objekt in einem GEMINI-Fenster das
Öffnen	eines  entsprechenden  1stGuide-Fensters veranlassen (anstatt
dieses	Objekt	auf das 1STGUIDE.ACC-Icon zu ziehen). Sie können auch
1st  Guide  auf  "*" anmelden und in der Applikationsliste ganz unten
positionieren.	Dadurch erreichen Sie bei Doppelklick auf ein Objekt,
das  nicht  schon  einer  anderen  Applikation	zugeordnet  ist,  ein
sofortiges  Öffnen  eines  Fensters  durch  1st Guide statt des sonst
üblichen Ansehen/Drucken/Abbruch-Dialoges von GEMINI.

Tastatur-Eingaben,  die  unter	1st Guide keine Wirkung haben, werden
von  1st  Guide  an GEMINI weitergeleitet. Auf diese Weise können Sie
bestimmte   GEMINI-Aktionen  auch  dann  auslösen,  wenn  gerade  ein
1stGuide-Fenster oben liegt.

Schlie₧lich  möchte  ich  noch	bemerken, da₧ alles eben Gesagte auch
dann  funktioniert,  wenn  Sie	1st  Guide  über "The Chameleon┐" von
Karsten  Isakovic  geladen  haben,  da	The Chameleon Nachrichten von
GEMINI an das geladene Accessory (bzw. umgekehrt) durchreicht.


4.2	1st Guide und TC_HELP
-----------------------------

In  1st  Guide ist das TC_HELP-Protokoll eingebaut. Das bedeutet, daß
1st  Guide  auf  den  Nachrichtentyp  AC_HELP (Nummer 1025) reagiert.
Dies  wird  von  neueren Versionen verschiedener Editoren wie TEMPUS,
EDISON,  PKS-Edit sowie von 7UP (ein ausgezeichneter Shareware-Editor
von  Michael  Thänitz)	unterstützt.  Man kann dort ein Wort in einem
Text  selektieren  und	durch  Drücken	einer  Taste  (z.B. HELP) das
Senden einer AC_HELP-Nachricht veranlassen.

Ein  Problem  hierbei  ist,  daß  die  Editoren  dabei	von dem Namen
"TC_HELP"  des betreffenden Accessorys ausgehen. Eine Möglichkeit zur
Lösung	dieses	Problems  wäre	das  Umbenennen  von  1STGUIDE.ACC in
TC_HELP.ACC,   wodurch	 die  Nachrichten  richtig  ankommen  würden.
Dadurch  kann  man  dann  aber	die Konfiguration von 1st Guide nicht
mehr  ohne weiteres sichern (siehe Kapitel 7), da 1st Guide dann sein
eigenes Programm nicht mehr findet.

Eine  günstigere Möglichkeit ist daher das Patchen der entsprechenden
Programme,   indem   man  mit  einem  Dateimonitor  die  Zeichenkette
"TC_HELP  " sucht und durch "1STGUIDE" ersetzt. Dies funktioniert bei
7UP,  EDISON  sowie  TEMPUS 2.10 tadellos, PKS-Edit konnte noch nicht
getestet  werden.  Im  allgemeinen  sollte  dies immer funktionieren,
solange  die  Strings  nicht  aus irgendeinem Grunde verschlüsselt im
Programm stehen.

Bei  7UP  ab  Version 2.1 ist ein Patch nicht mehr nötig, da der Name
des Hilfsaccessorys frei konfiguriert werden kann.

Das  übergebene  Schlüsselwort	sucht  1st Guide in seiner Indexdatei
(kann  im  Konfigurations-Dialog eingestellt werden, siehe Kapitel 7)
und  öffnet  ein entsprechendes Fenster (bzw. gibt eine Alertbox aus,
daß der Begriff nicht gefunden werden konnte).

Bei  der  Indexdatei  handelt  es  sich  dabei	um  eine ganz normale
Textdatei  mit	Verzweigungsinformationen,  die normalerweise von dem
Hilfsprogramm ▌1st Index▌UTIL\1STINDEX▌ erstellt wurde.


4.3	1st Guide und CALCLOCK
------------------------------

1st  Guide  hat  zwei  Berührungspunkte  mit  einem Spooler-Accessory
namens CALCLOCK.

Zunächst  kann	man 1st Guide so konfigurieren (siehe Kapitel 7), daß
es  bei  Drücken  von ^P eine Nachricht an ein CALCLOCK-Accessory zur
Ausgabe  der  aktuellen  Datei	schickt  anstatt  die  Ausgabe selbst
vorzunehmen    (kann   man   auch   mit   Control-L.Shift-Alternate-P
erreichen).	Andererseits	 kann	  1st	Guide	selbst	 auch
CALCLOCK-Aufträge  bearbeiten,	d.h.  es  reagiert  auf entsprechende
Nachrichten  von  anderen  Applikationen mit dem Ausdruck von Dateien
und kann damit ein weiteres CALCLOCK-Accessory ersparen.

Der  oben  bereits  erwähnte Shareware-Editor 7UP von Michael Thänitz
unterstützt  dies  beispielsweise.  Ab	Version  2.1  wird  1st Guide
direkt	unterstützt,  bei  älteren  Versionen kann man sich mit einem
Patch behelfen (siehe oben).


4.4	1st Guide und das GEM-Clipboard
---------------------------------------

1st  Guide  unterstützt  den Datenaustausch mit anderen Applikationen
über  das  GEM-Clipboard.  Wenn  Sie ^C drücken, so wird die aktuelle
Datei	ins   Clipboard  kopiert,  sofern  ein	solches  gesetzt  ist
(anderenfalls  wird  nicht  die  Datei	in  das  fehlende  Clipboard,
sondern  eine  Fehlermeldung  auf den realen Bildschirm kopiert). Bei
Textdateien   werden   dabei   grundsätzlich  zwei  Dateien  erzeugt:
SCRAP.TXT   als   reine   ASCII-Datei	(bereinigt   von  eventuellen
Text-Attributen)    sowie   SCRAP.OUT	mit   eventuellen   Standard-
Textattributen.  Andere Dateiformate werden als SCRAP.IMG, SCRAP.GEM,
SCRAP.RSC,  SCRAP.SAM  bzw.  SCRAP.SND geschrieben. Befindet man sich
gerade	 im   Dump-Modus,  so  wird  schließlich  eine	Datei  namens
SCRAP.DMP erzeugt.

Wenn  man  mit dem Shareware-Editor 7UP arbeitet, kann man beispiels-
weise  unmittelbar  nach  der  Kopie  eines Hilfstextes ins Clipboard
diesen	in einen Text in 7UP einfügen, falls die GEM-Clipboard-Option
eingeschaltet ist.


4.5	1st Guide und andere Applikationen
------------------------------------------

Falls  Sie  selber  auch (GEM-)Programme schreiben, so können Sie 1st
Guide  über  die  implementierten  Kommunikations-Schnittstellen auch
aus eigenen Anwendungen heraus ansprechen.

Zunächst  wäre	da  der Nachrichtentyp VA_START. Durch Sendung dieser
Nachricht  an  1st  Guide (nach Ermittlung der Identifikations-Nummer
von  1st  Guide  mit Hilfe der Funktion appl_find) einschlie₧lich der
entsprechenden	 Parameter   (Pfadnamen)   kann   1st  Guide  bereits
aktiviert   und   zur  Fensteröffnung  veranla₧t  werden.  1st	Guide
informiert  dann  seinerseits  den  Absender  dieser  Nachricht  über
geöffnete  Fenster  bzw.  deren  Schlie₧ung (Meldungen AV_ACCWINDOPEN
und  AV_ACCWINDCLOSED). Falls das Programm diese Meldungen auswertet,
kann  es  mit  VA_DRAGACCWIND  Nachrichten an 1st Guide mit Bezug auf
eines	 dieser   Fenster   senden,   was   das   Überschreiben   des
Fensterinhalts zur Folge hat.

Je  nach Konfiguration von 1st Guide (siehe Kapitel 7) kann es jedoch
auch  sein,  daß  die  Dateien	bei  VA_START nicht in einem Fenster,
sondern auf ein Gerät ausgegeben werden.

Möchte	man unbedingt Dateien ausdrucken, so schickt man einfach eine
Standard-CALCLOCK-Message  (Nummer  100)  an  1st Guide. Dabei können
sogar  wie  bei  VA_START auch mehrere Dateien gleichzeitig angegeben
werden.

Schließlich  kann  man	sich auch die AC_HELP-Message zunutze machen,
um  1st  Guide	einen Begriff in einer Indexdatei suchen zu lassen um
daraufhin ein entsprechendes Fenster zu öffnen.

Noch  ein  Hinweis:  Rufen  Sie  appl_find immer erst unmittelbar bei
Aktivierung  eines  entsprechenden  Punktes  durch den Nutzer auf und
nicht  nur bei Programmbeginn. Seit der Existenz von "The Chameleon┐"
von    Karsten	 Isakovic   könen   Accessories   nämlich   dynamisch
nachgeladenen  werden,	so  da₧  bei Meldung eines nichtgeladenen 1st
Guide	 der   Nutzer	dieses	 anschlie₧end	nachladen   und   den
entsprechenden Punkt einfach nochmal anwählen könnte.


5.	Geräteausgabe
---------------------

Durch  Drücken	von  ^P können Sie die aktuelle Datei ausdrucken. 1st
Guide  benötigt  dazu  grundsätzlich  GDOS. Wenn Sie bereits ein GDOS
auf  Ihrem ST installiert haben (z.B. im Zusammenhang mit GEMINI oder
NVDI),	 können  Sie  sich  also  schon  mal  beruhigt	zurücklehnen,
ansonsten  werden  Sie	eine  Installation vielleicht im Zusammenhang
mit 1st Guide in Erwägung ziehen.

Falls  Sie  einen  passenden  GDOS-Treiber  für  Ihren Drucker haben,
können	Sie  problemlos  Image-  und  Meta-Dateien  über 1st Guide in
entsprechender	 Qualität   ausdrucken.  Bei  Text-Dateien  wird  die
Ausgabe  über die VDI-Funktion V_ALPHA_TEXT vorgenommen, die über den
GDOS-Treiber  Ausgaben	im  Textmodus  auf  den  Drucker  leitet  und
au₧erdem  Textattribute  in  standardisierter Form (OUT-Format, siehe
GEM-Profi-Buch	von  Gei₧/Gei₧) auswertet. 1st Guide wandelt nun auch
die  1st  Word Attribute sowie die der Link-Darstellung in diese Form
um,  so  da₧  Sie  auf Ihrem Drucker eine analoge Ausgabe wie auf dem
Bildschirm erhalten, und das ohne irgendeine PRINTER.CFG-Datei.

Bei   der   Text-Ausgabe  werden  die  eingeschränkten	Multitasking-
Fähigkeiten  des  AES  ausgenutzt,  d.h.  während  der	Ausgabe  kann
weitergearbeitet  werden,  wobei es allerdings zu 'Stockungen' kommen
kann.  Da 1st Guide mit geöffneten Dateien arbeitet, kann es außerdem
zu  ernsthaften (sprich bombigen) Problemen kommen, wenn ein Programm
beendet wird (außer unter MultiTOS!).

Wenn   Sie   während  der  Ausgabe  beide  Shift-Tasten  gleichzeitig
gedrückt  halten, können Sie diese abbrechen. Sicherheitshalber fragt
1st Guide nochmal nach.


6.	▌Rebuild▌UTIL\REBUILD▌-Funktion
------------------------

7.	Konfiguration
---------------------

Durch  Gedrückthalten  der  rechten  Maustaste	beim  Aktivieren oder
durch  Drücken	von  ^A  können  Sie  das  Verhalten von 1st Guide in
bestimmten  Punkten  Ihren  individuellen  Bedürfnissen  anpassen und
permanent  sichern.  Die  Parameter werden direkt im Datenbereich des
Programms  gespeichert,  so  daß  keine INF-Datei benötigt wird. Dazu
ist  es  erforderlich,	daß  das  Programm  den  Namen	1STGUIDE.AC*,
1STGUIDE.PRG,	1STGUIDE.APP   oder  1STGUIDE.GTP  hat	und  sich  in
demjenigen Pfad befindet, der beim Starten von 1st Guide aktuell war.

Folgende Parameter können eingestellt werden:

Standard-Ausgabe Fenster/Gerät
	steht normalerweise auf "Fenster". Wenn Sie "Gerät" einstel-
	len, werden die Dateien nicht in ein Fenster, sondern sofort
	auf das eingestellte Gerät ausgegeben. Sie können jederzeit
	die alternative Ausgabemöglichkeit verwenden, wenn Sie
	L.Shift-Alternate bei der Anwahl der Datei(en) gleichzeitig
	gedrückthalten. So können Sie in GEMINI z.B. schnell mal
	nebenbei Dateien ausdrucken, indem Sie sie auf das instal-
	lierte 1STGUIDE.ACC-Icon ziehen und beim Loslassen
	L.Shift-Alternate gedrückthalten.

Control-P-Ausgabe Intern/CALCLOCK
	steht standardmäßig auf "Intern". Geräteausgaben werden so
	von 1st Guide selbst vorgenommen. Stellen Sie den Schalter
	auf "CALCLOCK", so wird statt dessen eine Nachricht an ein
	CALCLOCK-Accessory geschickt, welches dann die Ausgabe über-
	nimmt. Vorsicht: Dies ist nur bei ASCII-Textdateien sinnvoll!
	Auch hierbei ist es möglich, durch zusätzliches Gedrückthal-
	ten von L.Shift-Alternate jeweils die alternative Form anzu-
	wählen.

Textfont-Einstellung Normal/VA_FILE
	Steht dieser Schalter auf "Normal", so wird beim Laden einer
	Textdatei immer der in 1st Guide aktuelle Font verwendet.
	Stellen Sie den Schalter auf "VA_FILE", so wird bei jedem
	Öffnen eines Textfensters automatisch der Font über das VA-
	Protokoll erfragt und eingestellt, falls ein entsprechendes
	Programm aktiv ist (z.B. GEMINI).

Doppelklick-Standard Neues Fenster/Überschreiben
	steht zunächst auf "Neues Fenster", d.h. beim Doppelklick auf
	ein Keyword wird ein neues Fenster geöffnet, falls nicht eine
	Shift-, Alternate- oder Controltaste gedrückt ist. Steht der
	Schalter auf "Überschreiben", so ist es genau andersherum.
	Außerdem ändert sich dadurch die Bedeutung des Fenster-
	Schließknopfes! Er bewirkt dann das Zurückgehen im Infopfad
	(entspricht UNDO, ESC) ähnlich wie bei Verzeichnishierarchien
	im Desktop. Möchte man trotzdem das Fenster schließen, so
	kann man zusätzlich die rechte Maustaste gedrückthalten.

Die Indexdatei kann in dem entsprechenden Textfeld eingetragen
	oder per Datei-Auswahl-Box gewählt werden.

Zusätzlich  können Sie Parameter für die Geräteausgabe festlegen, die
sich weitgehend selbst erklären (sollten).

Beim  Sichern  werden  neben  den  angegebenen	Parametern  noch  die
aktuelle  Fensterposition  (wird dann beim nächsten Öffnen des ersten
Fensters  wieder  verwendet)  sowie der aktuell eingestellte Textfont
gespeichert!  Die  Fensterkoordinaten  werden  dabei  in Promille der
aktuellen  Bildschirmausmaße gespeichert, so daß die Verhältnisse bei
verschiedenen Auflösungen gleich sind.

In  der  rechten  unteren  Ecke der Konfigurationsbox wird der größte
verfügbare  Speicherblock ("MEM:") sowie die Gesamtsumme aller freien
Speicherblöcke	angezeigt ("TOT:"). An der Differenz beider Werte ist
eine Speicherfragmentierung erkennbar.


8.	Grenzen
---------------

Fenster: 1st Guide kann theoretisch bis zu 32767 Fenster verwalten.
	Dies entspricht der Anzahl der gültigen Window-Handles. Wenn
	Sie mit TOS 1.04 arbeiten und das Programm WINX von Martin
	Osieka besitzen, können Sie bis zu 127 Fenster unter
	1st Guide verwenden (auch GEMINI kommt mit dieser Fensterflut
	zurecht). Unter MultiTOS konnte ich keine Beschränkung der
	offenen Fenster feststellen!

Textdateien werden mit bis zu 32767 Zeilen mit maximal 512 Zeichen
	unterstützt.

Pfadnamen dürfen maximal 127 Zeichen lang sein.

Argumente können sowohl über VA_START als auch bei Programmstart in
	beliebiger Anzahl verarbeitet werden. Bei Programmstart wird
	dabei zuerst nach xArg und dann nach ARGV gefahndet. Erst
	wenn dies nichts fruchtet, wird die (beschränkte) Standard-
	GEMDOS-Kommandozeile in der Basepage ausgewertet. Von mir
	gibt es dazu einen modifizierten Startcode, der das Scannen
	übernimmt und argc und argv für main entsprechend setzt, so
	daß keine Quelltext-Änderung notwendig ist (liegt auch als
	Source DDSTART.S bei).

Verzweigungen können nicht unbegrenzt geschachtelt werden.
	Zu jedem Fenster werden drei beschränkte Buffer angelegt:
	- 128 Byte für den Pfadnamen
	- 128 Byte für die Schlüsselkette (Fenstername)
	- 256 Byte "History-Buffer" (zum Ablegen von Informationen
	  für's Zurückverfolgen des Infopfades)
	10 Verschachtelungen sollten normalerweise drin sein, leider
	wird das Überlaufen der Buffer noch nicht gecheckt, so daß
	man es mit dem Verzweigen nicht allzusehr übertreiben sollte.
	Bei Gelegenheit werde ich natürlich noch einen Check einbauen
	oder aber gleich zu dynamischen Buffern übergehen.


9.	▌1st Index▌UTIL\1STINDEX▌
-------------------

10.	▌Neu in Version▌UTIL\VERSION▌
----------------------

11.	Referenz
----------------

Zunächst  möchte  ich  mich  herzlichst  bei den Brüdern Gei₧ für ihr
GEM-Profi-Buch	 bedanken,  ohne  das  dieses  Projekt	kaum  möglich
gewesen  wäre.	Ein  weiterer  Dank gebührt Stefan Eissing und Gereon
Steffens   für	 ihren	 kommunikationsfreudigen   und	kaum  Wünsche
offenlassenden	Desktop GEMINI, der eine bequeme Arbeit mit 1st Guide
erst  ermöglicht. Nicht zuletzt geht mein Dank an Borland München für
ihre   konkurrenzlos   komfortable   und   leistungsfähige   Purbo-C-
Programmier-Umgebung.

Bei 1st Guide handelt es sich um "Shareware"!

Wenn  Ihnen  dieses  Programm  gefällt,  Sie es benutzen und es Ihnen
hilft,	so  sollten Sie sich gegen eine Unterstützung von DM 20,- bei
untenstehender	Adresse  registrieren lassen. Sie können dann mit der
Zustellung  eines kompletten Info-Hypertext-Systems für den geplagten
ST-C-Programmierer   und   noch   geplanter  Weiterentwicklungen  des
Programms  rechnen.  Au₧erdem  werde  ich mich dann bemühen, evt. von
Ihnen  aufgespürte  Bugs  zu entfernen und Verbesserungsvorschläge zu
berücksichtigen, sofern Sie mich davon überzeugen können.

Sie  können  dieses Programm bedenkenlos weitergeben, aber achten Sie
bitte  darauf,	da₧  stets  alle  Dateien  zusammen  und  unverändert
kopiert werden.

Viel Erfolg bei der Anwendung des Programms wünscht Ihnen

	Guido Vollbeding
	Leitergasse 4 / 503
	D-O-4020 Halle

Bankverbindung:

	Guido Vollbeding
	Stadt- u. Saalkreis-Sparkasse Halle
	Kto. 486260725
	Blz. 800 537 62