#guidemission


#pagemain"GuideMission"#version"GuideMission.guide 1.07 (Jul-14-98)"
	#author"Jürgen Selle"

#lm"2"#rm"70"#center
GuideMission - Anleitung#line

Version 1.0 - Copyright (c) 97/98 Jürgen Selle.#line

Der ultimate Guide-Erzeuger für den Amiga!#line


#justify
#showcontents"12"

#showindex

#pageend


#pagesub"Einleitung"#contents#description"Warum das Ganze ?"


Haben Sie sich schon immer einmal gefragt, wie andere Leute ihre
mehr oder weniger hübsch aussehenden Guide-Files ge#- bas#- telt haben?
Mit den ganzen Links, dem Inhaltsverzeichnis, einem Index, und am
Ende sogar noch in Blocksatz!#line
Ich schon!#line
Und bevor ich nicht einen schönen Tages ein Tool in die Finger bekam,
das halbautomatisch ein Guide-File aus einem ASCII-Text erzeugte,
(wenngleich auch ohne Index und Blocksatz) habe ich immer einen großen
Bogen darum gemacht.#line
Da es kein völlig überzeugendes Tool gab, habe ich mich eines schönen
Tages daran gemacht, selbst ein solches zu programmieren. Und nach
etwa vier Monaten einigermaßen harter Program#- mier#- arbeit liegt
es nun vor: #bold GuideMission#normal#- .#line

GuideMission bietet all das, was ich mir schon immer gewünscht habe:#line
Inhaltsverzeichnis, Index, Blocksatz, Links, Gliederungshilfen und vieles
mehr.#line
Außerdem hohe Geschwindigkeit, eine (hoffentlich) benut#- zer#- freund#-
liche GUI und eine wunderschöne :) Doku#- men#- ta#- tion.
Und das Beste an allem: GuideMission ist FreeWare und damit kostenlos!


#pageend


#pagesubsub"Rechtliches"#contents#description"Das übliche Geschwafel"


#index"Copyright"#bold Copyright:#normal

Das Software-Paket sowie die begleitenden Texte sind Eigentum von
#link"Jürgen Selle" und durch die internationalen urheberrechtlichen
Copyright-Bestimmungen geschützt. Es gelten hierfür die grund#- legenden
Bestimmungen für Copyright-geschütztes Material.


#index"Garantie"#bold Beschränkte Garantie:#normal

Das Programm wird in vorliegender Form geliefert, ohne jegliche
Garantie für die Qualität und Einsatzfähigkeit für einen bestimmten
Zweck, weder in ausdrücklicher noch in implizierter Form.

Der Benutzer trägt das gesamte Risiko bezüglich der Qualität und der
der Leistung dieses Programmes.

Ich übernehme desweiteren keine Garantie dafür, daß die Leistungs#- merkmale
des Programms individuellen Ansprüchen ent#- sprechen oder die
Software unterbrechungs- und fehlerfrei arbeitet.


#index"Haftung"#bold Beschränkte Haftung:#normal

Es wird jede Haftung ausgeschlossen. Dazu gehören u.a. entgangener
Gewinn, Datenverluste oder sonstige Begleit- bzw. Folgeschäden, die
aufgrund der Benutzung bzw. des nicht korrekten Einsatzes dieses
Produktes enstehen, sowie Schadenersatzansprüche Dritter.


#index"Verbreitung"#bold Verbreitung:#normal

Dieser Text darf nur mit dem kompletten Archiv der unregistrierten
Version von GuideMission weitergegeben werden. Andere Arten der
Verwendung, auch auszugsweise, bedürfen schriftlicher Genehmigung
des Autors.

Die Version 1.0 von GuideMission darf #bold frei#normal (allerdings möchte
ich es niemandem verwehren, #link"Jürgen Selle""mir" einen angemessenen
Betrag für meinen Arbeit zu überreichen) kopiert werden,
WENN:#line
#list
	Das Verzeichnis <GuideMission> vollständig und unverändert wei#- ter#-
	gegeben wird.
#listend
#list
	Bei Veröffentlichung auf einer Disketten-/CD-Serie der Verkaufs#- preis
	pro Medium nicht über 5DM/25DM liegt, und der #link"Jürgen Selle""Autor"
	um Erlaubnis gefragt wird.
#listend
Anmerkung: GuideMission darf auf der Aminet-Serie veröffentlicht werden.

#pageend
 

#pagesubsub"Systemanforderungen"#contents#description"Was brauche ich?"


#bold Mindestens:#normal
#list
Hardware:#line
Ein Amiga :), Kickstart 1.3, 0.5MB Ram.
#listend
#list
(System)Software:#left
   Libs:diskfont.library,
   Libs:mathieeedoubbas.library.
#listend#justify

#bold Vorteilhaft:#normal
#list
Hardware:
#left Mehr Ram, 68020+.
#listend#justify
#list
	Software:#line
   AmigaGuide (für die Online-Hilfe),#line
   Installer (für das Install-Skript).
#listend

AmigaGuide, amigaguide.library#line
(c) Copyright 1991-93 Commodore-Amiga, Inc.  All Rights Reserved


Installer and Installer project icon
(c) Copyright 1995-96 Escom AG.  All Rights Reserved.
Reproduced and distributed under license from Escom AG.


Weder AmigaGuide noch Installer sind in diesem Programmpaket
ent#- halten. Sie sind zu finden auf den Workbench-Disketten der
Version 2.0 und höher, oder im Aminet (auch auf diversen CD-Roms)
unter 'text/hyper/amigaguide.lzh' / 'util/misc/Installer_43_3.lha'.


#bold Kein Problem (hoffentlich):#normal
#list#char" "
	Diverse Turbo-/Grafikkarten,#line
	Draco,#line
	zukünftige OS-Versionen.
#listend


Programmiert und getestet wird GuideMission mit:
Amiga 1200 im Infinitiv-Tower, Blizzard 1220, 6 MB Ram, 28 Mhz 68882,
540MB HD, Iomega ZipDrive, Quadspeed-CD-Rom, OS3.0 (Kick1.3), NEC 3D.

#pageend


#pagesubsub"Installation&Start""Installation und Start"#contents
#description"Jetzt geht's los!"#noindex


#index"Installation"#bold Installation:#normal#line
Es gibt zwei Möglichkeiten, GuideMission zu installieren:#line
Entweder mit dem Installer-Skript, alles weitere wird dabei erklärt;
oder per Hand, dazu muß nur (auf der Workbench) die GuideMission-Directory
an ihren Zielort gezogen werden, oder (im CLI) Directory und Info-File
an ihren Bestimmungsort kopiert werden, fertig.#line

#index"Start"#bold Programmstart:#normal#line
GuideMission kann von der Workbench per Doppelklick auf sein Icon,
vom CLI/SHELL oder von Programm-Launchern wie z.B. dem Tool-Manager
gestartet werden.#line
(GuideMission erzeugt einen eigenen Prozeß, ein 'run >NIL ...' ist
also nicht notwendig, schadet aber auch nicht.)#line
Falls Sie GuideMission mit einem Programm-Packer komprimieren möchten,
achten Sie bitte darauf, daß kein 'Hunk-Merging' durchgeführt wird !

#pageend


#pagesub"Bedienung"#contents#noindex

#pageend


#pagesubsub"Oberfläche"#contents#description"Was für'n Gadget?"


Ich für meinen Teil halte die Oberfläche von GuideMission zwar
für selbsterklärend, der Vollständigkeit halber kommt jetzt trotzdem
eine Anleitung:#line


#bold Dateien:#normal#line

#index"Quelle"Quelle ... : Shortcut : 'q'.
#list
	Mit Hilfe des #link"Filerequester""Filerequesters" legt man die
	Quelldatei fest.#line
	Bemerkung: Ist das Ziel noch undefiniert, so bekommt die Ziel#- datei
	den gleichen Namen, versehen mit der Endung '.guide', und dasselbe
	Verzeichnis wie die Quelldatei.#line
	Ist das Ziel dagegen schon definiert, so ändert sich nur der Name
	der Datei, nicht aber der Verzeichnisname!
#listend

#index"Ziel"Ziel ... : Shortcut : 'z'.
#list
	Hier kann man (wieder mit dem #link"Filerequester"#- )
	den Pfad und den Namen der Zieldatei festlegen.#line
	Bemerkung: Im Moment wird keine Rücksicht darauf genommen, ob die
	Zieldatei eventuell schon existiert, also aufgepaßt! (Siehe auch
	#link"Zukunft"#- .)
#listend


#bold Guide-Missionierung:#normal#line

#index"List-Gadget"List-Gadget : kein Shortcut.
#list
	Zeigt alle Fehler an, die bei der Übersetzung eventuell
	auf#- ge#- treten sind.
#listend

#index"Übersetzen"Übersetzen : Shortcut : 's'.
#list
	Erzeugt aus der Quelldatei die Zieldatei.
#listend

#index"Hilfe"Hilfe : Shortcut : <Help>.
#list
	Zeigt diesen Text an.
#listend

#index"Einstellungen"Einstellungen : Shortcut : 'e'
#list
	Hat im Moment noch keine Funktion.
#listend

#index"Verlassen"Verlassen : Shortcut : 'v'.
#list
	Das wunderbare Programm GuideMission wird verlassen.
#listend

#pageend


#pagesubsub"Befehle"#contents#description"Wie ging das doch gleich?"


Im Gegensatz zur #link"Oberfläche" ist die Syntax der .gm-Datei nicht
gerade selbsterklärend, deshalb folgt hier jetzt eine Auflistung und
Erläuterung der möglichen Befehle.#line
Bis ich Beispiele (siehe #link"Zukunft"#- ) entworfen habe, ist ein Blick
in die GuideMission.gm-Datei oft recht hilfreich.#line


#index"#guidemission"
#bold###- guidemission#normal
#list
	Muß am Textanfang stehen, ist die Kennung einer Quelldatei
	für GuideMission.
#listend

#index"#pagemain"
#bold###- pagemain #qu#- Titel#-#qu [###- version#qu#- text1#-#qu#- ]
	[###- author#qu#- text2#-#qu#- ]#normal
#list
	Titelseite, darf nur #italics einmal#normal auftauchen, #qu#- Titel#-#qu
	wird im Fenster#- titel dargestellt.
#listend
#listsub
	###- version: #qu#- text1#-#qu taucht im Versionsstring auf.
#listend
#listsub
	###- author: #qu#- text2#-#qu wird der zugehörige Text.
#listend

#index"#pagesub"
#bold###- pagesub{sub} #qu#- Name#-#qu [#-#qu#- Überschrift#-#qu#- ] [###- contents]
	[###- nosub]#line
[###- description#qu#- Text#-#qu#- ] [###- notitle] [###- noindex] #normal
#list
	(Unter-)Kapitel, mit Unterkapiteltiefe von bis zu 10.#line
	Achtung: Für die Schachtelung der Kapitel ist einzig und allein
	die Anzahl der sub's zuständig, die Kapitel an sich dürfen
	nicht geschachtelt werden!
#listend
#listsub
	#qu#- Name#-#qu erscheint bei contents/sub, ist gleichzeitig die
	Kapi#- tel#- über#- schrift, falls #qu#- Überschrift#-#qu nicht definiert ist.
#listend
#listsub
	###- contents: ein entsprechender Link taucht in der
	In#- halts#- an#- gabe auf.
#listend
#listsub
	###- nosub: am Ende des übergeordneten Kapitels erscheint
	#italics kein#normal Link auf dieses Kapitel.
#listend
#listsub
	###- description: die Beschreibung #qu#- Text#-#qu wird hinter dem
	Link in die Inhalts#- angabe geschrieben.
#listend
#listsub
	###- notitle: Kapitelnr. und Überschrift werden am Anfang des Kapitels
	#italics nicht#normal wiederholt.
#listend
#listsub
	###- noindex: das Kapitel wird #italics nicht#normal in den Index
	aufgenommen.
#listend

#index"#pageend"
#bold###- pageend#normal
#list
	Ende des (Unter-)Kapitels.#line
	Bemerkung: Fehlt dieser Befehl, so wird das Kapitel beim näch#- sten
	'###- pagesub...' beendet.
#listend

#index"#showcontents"
#bold###- showcontents #qu#- zahl#-#qu#normal
#list
	An dieser Stelle wird die Inhaltsangabe eingefügt.
#listend
#listsub
	#qu#- zahl#-#qu#- : Anzahl der Punkte zwischen Link und Beschreibung.
	Ist die Anzahl kleiner Null, so wird die entsprechende Menge an
	Leerzeichen eingefügt.
#listend

#index"#showindex"
#bold###- showindex#normal
#list
	an dieser Stelle wird ein Link auf den Index eingefügt.
#listend

#index"#index"
#bold###- index#qu#- Name#-#qu#normal
#list
	das Wort #qu#- Name#-#qu wird in den Index aufgenommen
#listend

#index"#link"
#bold###- link #qu#- Name#-#qu [#-#qu#- LinkName#-#qu#- ] [###- nospace]
	[###- width#qu#- zahl#-#qu#- ]#normal
#list
	an dieser Stelle wird ein Link eingefügt, der auf ein Kapitel mit
	dem Namen #qu#- Name#-#qu verweist.
#listend
#listsub
	#qu#- LinkName#-#qu#- : Name, der später im Link angezeigt wird, defi#-
	niert dabei #qu#- Name#-#qu über.
#listend
#listsub
	###- nospace: eventuell vorhandene Spaces rechts und links im Namen
	werden entfernt. <- noch nicht implementiert!
#listend
#listsub
	###- width#qu#- zahl#-#qu#- : der Link wird auf die Breite von #qu#- zahl#-#qu
	Zeichen gebracht.
#listend

#index"#list"
#bold###- list{sub} [###- size#qu#- zahl#-#qu#- ] [###- char#qu#- zeichen#-#qu#- ]#normal
#list
	der folgende Abschnitt wird um (Anzahl der sub's + 1) mal #qu#- zahl#-#qu
	eingerückt, das #qu#- zeichen#-#qu eingefügt.#line
	Achtung: Auch Aufzählungen werden #italics nicht#normal geschachtelt!
#listend
#listsub
	###- size#qu#- zahl#-#qu#- : es wird um #qu#- zahl#-#qu eingerückt, Default: 3.
#listend
#listsub
	###- listchar#qu#- zeichen#-#qu#- : #qu#- zeichen#-#qu ist das neue
	Markierungs#- zeichen, Default: #qu#- -#-#qu#- .
#listend

#index"#listend"
#bold###- listend#normal
#list
	Ende der Einrückung. Fehlt dieser Befehl, so wird die Einrückung
	spätestens am Ende des Kapitels beendet.
#listend

#index"#spaces"
#bold###- spaces #qu#- anzahl#-#qu#normal
#list
	fügt #qu#- anzahl#-#qu Leerzeichen ein, die umgebenden Leerzeichen sind
	darin noch nicht enthalten! #qu#- anzahl#-#qu muß größer gleich Null sein
	und kleiner gleich der Seitenbreite.
#listend

#index"#line"
#bold###- line#normal
#list
	fügt eine Leerzeile ein.
#listend

#index"#-"
#bold###- -#normal
#list
	setzt einen weichen Trenner, bzw. einen Trennvorschlag.
#listend

#index"##"
#bold###- ###normal
#list
	fügt ein #qu#- ###- #qu ein.#line
	Achtung: In Befehlen, wie z.B. ###- index#qu#- ###- link#-#qu#- ,
	reicht ein ein#- zel#- nes ###- !
#listend

#index"#qu"
#bold###- qu#normal
#list
	fügt ein einzelnes #qu ein. ('qu' steht für 'quotationmark'.)#line
	Bemerkung: Benutzt lieber ein #qu #- '#- #qu #- , sonst wird's kompliziert,
	wie man an dieser Stelle in der GuideMission.gm-Datei erkennen kann.
#listend

#index"#left"#index"#right"#index"#center"#index"#justify"
#bold###- left#line ###- right#line ###- center#line ###- justify#normal
#list
	bestimmt die Formatierung ab dieser Stelle, bis zum Ende der Datei.
	Default: ###- justify.
#listend

#index"#lm"#index"#rm"
#bold###- lm #qu#- [+/-]zahl#-#qu#line ###- rm #qu#- [+/-]zahl#-#qu#normal
#list
	setzt den linken und rechten Rand, gilt bis zum Ende der Guide.
	Default: 2/65. Der Abstand zwischen linkem und rechtem Rand muß
	mindestens fünf Zeichen betragen.
#listend
#listsub
	ist ein #qu#- + #-#qu /#qu#- - #-#qu vorhanden, wird der jeweilige Rand
	um diesen Offset geändert. <- Noch nicht implementiert!
#listend

#index"#normal"#index"#bold"#index"#under"#index"#italics"
#bold###- normal#line ###- bold#line ###- under#line ###- italics#normal
#list
	setzt den entsprechenden Fontstil.#line
	Anmerkung: Diese Befehle gelten nur für das jeweils aktuelle Kapitel,
	im nächsten Kapitel wird auf jeden Fall wieder mit dem Stil '###- normal'
	begonnen.
#listend

#pageend


#pagesub"Diverses"#contents#noindex

#pageend


#pagesubsub"FileRequester"


Mit Mausklick auf die Laufwerksauswahl erhalten Sie eine Liste der
verfügbaren Devices, Volumes und Assigns.#line

Die fünf Gagets darunter ('Name', 'Size', 'Date', 'Flags' und
'Comment') sortieren bei Betätigung die Einträge nach der
jewei#- ligen Kategorie.#line

Um in ein Unterverzeichnis zu gelangen, muß man einen Doppel#- klick(!)
auf den gewünschten Eintrag durchführen.

Der  Erste  Eintrag  eines  Unterverzeichnisses  (gekennzeichnet  mit
'/Parent')  bewirkt  bei  Doppelklick die Parent-Funktion,  d.h.  man
gelangt  ins  übergeordnete Verzeichnis.#line

Doppelklick auf den Dateinamen, <Return> im Namens(File)-Feld oder
'Okay' bedeuten Auswahl. 'Cancel' oder ein Klicken auf das Schließ#- gadget
links oben bedeuten Abbruch.

#pageend


#pagesubsub"Fortschrittsanzeige"#description"Wann ist es fertig?"


Die Fortschrittsanzeige wird in GuideMission immer dann eingesetzt,
wenn eine längere Zeit keine Benutzereingaben entgegengenommen
werden können.#line
Das Fenster das dazu geöffnet wird, erfüllt folgende Aufgaben:#line
#list
 Am wachsenden Balken kann man ungefähr die verbleibende Zeit
 abschätzen.
#listend
#list
 Die augenblickliche Aktion kann abgebrochen werden, indem man das
 Schließgadget des Fensters betätigt, oder 'Abbruch' anwählt
 (Shortcut : 'a'/<ESC>).
#listend
#list
 Die Aktion kann angehalten werden, indem man auf 'Pause' drückt
 (Shortcut : 'p').#line
 Der Requester, der sich dann öffnet, kann auf zwei Arten verlassen
 werden: Mit 'Weiter' (Shortcut : 'w'/<Return>) läuft alles weiter,
 als wäre nichts geschehen.#line
 'Abbruch' (Shortcut : 'a'/<ESC>) zieht die gleichen Konsequenzen
 wie 'Abbruch' in der Fortschrittsanzeige nach sich.
#listend

#pageend


#pagesubsub"Zukunft"#description"Wie geht es weiter?"


Diverse Ideen liegen bei #link"Jürgen Selle""mir" in der Schublade
und warten nur darauf, daß ich entweder genügend Zeit zur Verwirklichung
habe, oder die Nachfrage nach neuen Funktionen groß genug ist ( also ruhig
melden bei Wünschen / Verbesserungsvorschlägen / Bugs(: ).
#list
	Doppelklick auf Fehlerliste ruft Editor auf.#line
	Erzeugung eines ASCII-/HTML-Files.#line
	Prefs-Fenster programmieren.#line
	Diese Anleitung komplettieren - Beispiele und Fehlermeldungen.#line
	Weitere Funktionen integrieren.#line
	Sicherheitsabfragen bei verschiedenen Funktionen.#line
	Entfernung aller noch vorhandener Bugs.#line
	CLI-'Interface'
#listend

#pageend


#pagesubsub"Jürgen Selle""Adresse des Autors"#contents
#description"Wohin mit Lob und Anerkennung?"
#index"Adresse"

Ich bin erreichbar unter:#line

Post:
#list#char" "
  Jürgen Selle#line
  In der Servine 2#line
  D-58239 Schwerte#line
#listend
Telefon: 02304-42879#line

E-Mail: Zander.Mucha@t-online.de (Das ist nicht mein eigener
Account, also deutlich machen, daß Ihr *mich* haben wollt :) !#line

Tip: Bitte ruft mich nur in Notfällen über's Telefon an, da ich nur selten
zu Hause zu erreichen bin. Bevorzugt antworte ich auf E-Mails, ist auch
billiger als Telefon/Snail-Mail :).#line

P.S.: Bitte mailt mir und überhäuft mich mit Vorschlägen/Bugreports oder
ähnlichem, nur so kann ich feststellen, ob das Programm Gefallen findet
oder verschmäht wird.

#pageend


#pagesubsub"Danksagungen"


Dank geht an :#line
#list
 Maxon, für die Programmiersprache MaxonC++. (Schade drum, würde ich sagen :( )
#listend
#list
 Frank Dittmar, für die Genehmigung, die 'ResTools.lib'
 inklusive diverser Unter-Libs, sowie Auszüge seiner
 DosXS-Dokumentation zu verwenden.
#listend

Und natürlich an die Erbauer dieses einzigartigen Computers :).#line
(Wer auch immer das im Augenblick wohl sein mag...)

#pageend