first commit - moved from local dev to git

tools/st-gui15/DE/st-guide/dok/hypfind.txt

@@ -0,0 +1,35 @@
+
+Syntax: hypfind [-q -c] -p <pattern> [hypertext...]
+q: keine Ausgaben machen
+c: nicht compilieren
+p: hier folgt DURCH EIN LEERZEICHEN GETRENNT der Suchbegriff; enth<74>lt
+   er Leerzeichen, so ist er durch Hochkommata einzuschlie<69>en, also
+   -p 'zwei Worte'
+
+Wird kein Hypertext angegeben, so werden alle aus PATHS durchsucht,
+ansonsten nur die angegebenen; die Hypertexte m<>ssen mit Pfad angegeben
+werden
+
+Erzeugt wird eine Datei Namens HYPFIND.STG im GUIDES Ordner, wurde das
+Pattern gefunden (und die Compilierung nicht abgestellt), so wird
+anschlie<EFBFBD>end gleich der hcp aufgerufen, um einen Hypertext Namens
+HYPFIND.HYP zu erzeugen. Diese Datei wird direkt beim Aufruf von hypfind
+gel<EFBFBD>scht(!)
+
+Erzeugt werden dabei Paare
+@{Datei, Node '<name>' link datei/node Zeile}
+: <Trefferzeile>
+
+Paare.
+
+Pnodes sowie Seiten mit dem Namen 'Index' werden nicht durchsucht.
+
+FEHLT:
+- evtl. sensitiv/insensitiv suchen
+- evtl. nur einen Treffer pro node ausgeben
+- evtl. auch Seitennamen mit Pattern vergleichen
+
+Viel Spa<70> beim Testen :-)
+
+
+

tools/st-gui15/DE/st-guide/dok/st-guide.chg

@@ -0,0 +1,317 @@
+
+Update-History des Hypertext Systemes
+
+2.12.96:
+---------
+ST-Guide : Iconify noch mal umgestrickt, sollte jetzt unter MagiC und
+           MTOS optimale Ergebnisse liefern
+ST-Guide : Probleme mit mehreren Bildern in einer Zeile i.Z. mit Fonts
+           kleiner 12 Pixel H<>he behoben
+ST-Guide : neue Variable NOREFBOX schaltet die bei der REF-Suche er-
+           scheinende Suchbox ab
+ST-Guide : Probleme mit dem Slider auf sehr langen Seiten behoben
+ST-Guide : Katalog-Icon erg<72>nzt
+ST-Guide : wenn Remarker nicht in der INF-Datei angemeldet ist und von
+           Hand nachgestartet wird, verschwand dessen Icon bei einem
+           Fontwechsel im ST-Guide
+ST-Guide : TOS-Programme werden jetzt unter MagiC ohne AV Server im
+           Fenster (VT 52) gestartet
+ST-Guide : "Stack l<>schen" ist wieder disabled, wenn der Stack leer ist
+ST-Guide : nach 'copy' bekommen alle laufenden Programme eine SC_CHANGED
+           Nachricht (im Mtasking)
+ST-Guide : bei externen Referenzen wird jetzt alles ab dem ersten '/' oder
+           '\\' als Titel angesehen, die Angabe von Pfaden zu den Dateien
+           ist also nicht mehr m<>glich (macht ohnehin nur Probleme), daf<61>r
+           aber die Verwendung der Pfadtrenner in Nodenamen
+           (siehe auch Option -k des hcp)
+ST-Guide : 'Marke setzen' und 'gehe zu Marke' sind zugunsten von 10 frei
+           definierbaren Marken per Funktionstaste entfernt worden; Setzen
+           erfolgt per Shift-Fx, Abrufen per Fx
+ST-Guide : neue Variable MARKFILE enth<74>lt Zugriffspfad zu der Datei, in der
+           die gesetzten Marken beim Schlie<69>en des ST-Guide automatisch
+           gespeichert und aus der sie beim <20>ffnen des ST-Guide automatisch
+           wieder geladen werden; hiermit ist insbesondere das Anlegen
+           einer Liste der "wichtigsten" Hypertextseiten m<>glich
+ST-Guide : neues Icon neben dem History-Icon <20>ffnet ein Popup mit allen
+           gesetzten Marken, Klick ruft sie ab, Shift-Klick setzt sie
+ST-Guide : Sicherheitsabfragen f<>r den Fall eingebaut, da<64> der Hypertext
+           defekt ist oder z.B. gel<65>scht wurde, w<>hrend ST-Guide ihn
+           anzeigt
+ST-Guide : kleinen Bug behoben, der bei Speicherknappheit auftrat
+ST-Guide : kann Bilder jetzt zentriert darstellen
+ST-Guide : Fenster kann nicht mehr kleiner als Iconleiste plus drei
+           Textzeilen gemacht werden, um Darstellungsfehler zu vermeiden
+ST-Guide : Positionierungsfehler bei Grafik-Objekten im Zusammenhang mit
+           Fonts, die schmaler oder breiter als der Systemfont sind,
+           behoben
+ST-Guide : Probleme mit Case sensitiven Filesystemen im Zusammenhang mit
+           anzuzeigenden Nicht-Hypertexten behoben
+ST-Guide : in den Dialogen sind jetzt die 3D-Flags gesetzt und ab 16 Farben
+           werden die Dialoge hellgrau unterlegt
+ST-Guide : Die Tasten PageUp und PageDown werden ausgewertet
+ST-Guide : neue Variable BACKWIND macht das Fenster im Hintergrund
+           bedienbar, getopped wird es dann mit Rechtsklick
+ST-Guide : Die Alertboxen 'XY konnte nicht ge<67>ffnet werden' haben jetzt
+           eine kontextsensitive Hilfe
+ST-Guide : Bug im Zusammenang mit @tree und Seiten die direkt mit einem
+           Attribut beginnen behoben
+ST-Guide : Scrolling ist jetzt auch im hintenliegenden Fenster flimmerfrei,
+           wenn der Arbeitsbereich ganz sichtbar ist, das Fenster also nicht
+           verdeckt wird
+ST-Guide : hoffentlich Workaround f<>r Probleme beim Dauerscrollen
+           (pl<70>tzliche Blockmarkierung) gefunden
+ST-Guide : Probleme des FileFinders mit langen Dateinamen behoben
+ST-Guide : neue Variable FORMFEED sorgt beim Ausdrucken daf<61>r, da<64> am Ende
+           ein FormFeed ausgegeben wird
+ST-Guide : zeigt jetzt Bilder mit bis zu 16 Farben an, ich denke das ist
+           ein guter Kompromiss, denn f<>r einen Hypertext sinnvolle
+           Grafiken lassen sich damit erstellen und solche Bilder halten
+           sich von der Gr<47><72>e her in Grenzen, so das die Hypertexte da-
+           durch nicht allzusehr aufgebl<62>ht werden
+ST-Guide : in Farbtiefen mit weniger als 16 oder mehr als 256 Farben
+           werden bunte Bilder in S/W angezeigt; ST-Guide dithert die
+           Bilder dazu mit einem speziell f<>r Snapshots von Dialogen o.<2E>.
+           optimierten Verfahren (Defaultmaske) oder der im .stg zum be-
+           treffenden Bild vorgegebenen Maske
+ST-Guide : neue Variable XFONT, mit der ein 2. Font f<>r die Fenster-
+           darstellung angegeben werden kann; umgeschaltet wird per CTRL-Z
+ST-Guide : Fehler beim Scrollen w<>hrend des Blockmarkierens in Farbe
+           behoben
+ST-Guide : der Suchen-Dialog ist jetzt unter MagiC auch ohne Let 'em Fly
+           Tastaturbedienbar
+ST-Guide : BCKCOLOR zugunsten von BCK3D entfernt
+HCP      : Zeilen l<>nger als 127 Zeichen (netto) werden jetzt immer um-
+           brochen
+HCP      : Fehler beim Recompilieren von XREF behoben
+HCP      : Warnung bei Benutzung undefinierter Variablen eingebaut
+HCP      : um die Zeichenfolge '@:' in den Text zu bekommen, ist '@@:'
+           zu schreiben
+HCP      : heftigen internen Fehler behoben, der beim <20>bersetzen von
+           Hypertexten zuweilen zu Abst<73>rzen oder defekten xref's f<>hrte
+HCP      : Probleme mit SEHR langen Zeilen (>256 Zeichen) jetzt
+           hoffentlich behoben
+HCP      : "verz<72>hlt" sich nicht mehr beim Laden der Bilder, zum Schlu<6C>
+           sollte in der Ausgabe jetzt immer 'none' stehen
+HCP      : Probleme mit unpaarigen indexon/indexoff behoben
+HCP      : '-j' funktionierte offenbar nicht als Parameter f<>r @options,
+           behoben
+HCP      : neue Option -k<value> zum Setzen von Flags
+HCP      : Erweiterung f<>r Bilder: zentrierte Darstellung durch Angabe
+           von 0 als X-Koordinate
+HCP      : beide '<27>' werden vom Autoreferenzer nicht als Worttrenner
+           benutzt, vorher funktionierte es mit dem einen '<27>' und mit dem
+           anderen nicht
+HCP      : einige Newlines entfernt, damit mehr auf den Bildschirm pa<70>t
+           (f<>r Consolefenster, die nicht zur<75>ckscrollen k<>nnen)
+HCP      : Fehler bei @if im Zusammenhang mit Zahl-Konstanten behoben
+HCP      : '+q' hebt '-q' jetzt auf, damit z.B. Voreinstellungen in
+           HCP_OPT lokal r<>ckg<6B>ngig gemacht werden k<>nnen
+HCP      : per +i1 kann jetzt ein "verteilter" Index erstellt werden, d.h.
+           eine eigene Seite f<>r jeden Buchstaben
+HCP      : Probleme mit @uses auf REF-Files und Benutzung dortiger @symbols
+           behoben
+HCP      : keine <20>berfl<66>ssigen Blanks mehr auf den Indexseiten
+HCP      : bei @image & @limage kann jetzt optional eine Dithermaske
+           angegeben werden, die der ST-Guide dann statt der Defaultmaske
+           zum Konvertieren bunter Bilder in S/W verwendet.
+HCP      : kleinen Bug im Zusammenhang mit @uses und pnodes behoben
+HCP      : Probleme bei @uses mit langen Dateinamen entfernt
+HCP      : Headerkennung f<>r Mac definiert (3), f<>r Hyperion
+HCP      : schreibt neuen OS-Header in REF-Files f<>r Hyperion
+HCP      : l<><6C>t jetzt ein Leerzeichen am Zeilenende drin, f<>r Hyperion
+HCP      : neue Kommandos @x, @{... x} und @os f<>r Hyperion
+
+31.07.95:
+---------
+ST-Guide : Fehler im Zusammenhang mit mehreren Bildern auf einer Seite
+           behoben
+ST-Guide : Fehler im Zusammenhang mit Bildern & pnodes auf der selben
+           Seite behoben
+ST-Guide : aktive Unterst<73>tzung des Font-Protokolles implementiert
+ST-Guide : 'Drucken' hei<65>t jetzt im Block-Popup auch wieder so...
+ST-Guide : AutoLocator sollte jetzt immer sichtbar werden, wenn ein
+           Zeichen eingegeben wird
+ST-Guide : wegen ungekl<6B>rter Probleme i.Z. mit Let 'em Fly wurden die
+           MagiC Shortcuts erstmal wieder ausgebaut; wer also mit
+           Let 'em Fly arbeitet, kommt jetzt wieder in den vollen Genu<6E>
+           dieses Tools
+ST-Guide : die REF-Suche kann jetzt durch Shift-Shift oder CTRL-ALT
+           abgebrochen werden
+ST-Guide : bei Auswahl von 'Remarker' im Menue bzw. ALT-R <20>ffnet sich
+           der Remarker jetzt direkt
+ST-Guide : Bug bei Shift-Home gefixt
+ST-Guide : Shift-Klick auf 'Copy' im BlockPopup bewirkt, da<64> der Block
+           ans Clipboard angeh<65>ngt wird; gleiches gilt f<>r den ent-
+           sprechenden Menuepunkt unter Extra, und nat<61>rlich bekommt
+           man den gleichen Effekt auch mit Shift-Ctrl-C
+ST-Guide : Probleme mit Tastendr<64>cken bei iconifiziertem Fenster behoben
+ST-Guide : Erkennung "AVSERVER" sicherer
+ST-Guide : Probleme beim Fuller behoben
+ST-Guide : Fehler i.Z. mit dem "kann nicht ge<67>ffnet werden" Alert
+           hoffentlich behoben
+ST-Guide : Der Abstand zwischen der ersten Textzeile und der Trennlinie
+           kann jetzt konfiguriert werden (Variable TXTOFFSET), default-
+           m<><6D>ig betr<74>gt er 6 Pixel
+ST-Guide : Probleme mit 'zur<75>ck' zu Seiten mit Bildern behoben
+ST-Guide : Probleme mit Referenzen hinter kursiven Passagen behoben
+ST-Guide : Icon im iconifizierten Fenster wird jetzt zentriert
+ST-Guide : auf Icons umgestellt, dadurch mehr Funktionen direkt auf
+           Knopfdruck
+ST-Guide : Funktionalit<69>t & Icon f<>r Querverweislisten implementiert
+ST-Guide : Seitenweise bl<62>ttern geht jetzt auch mit CTRL-LF/RT
+ST-Guide : jetzt toleranter gegen unpassende WINSIZE Angaben
+ST-Guide : Problem beim Fullen behoben, wenn der Inahlt hor. gescrollt
+           war
+ST-Guide : neues Icon neben "zur<75>ck" zeigt ein Popup mit den letzten
+           12 Seiten, zu denen auf diese Weise direkt zur<75>ckgekehrt
+           werden kann
+ST-Guide : beginnt der bei "system" angegebene Programmname mit einem
+           '$', so wird eine Variable dieses Namens in der ST-GUIDE.INF
+           gesucht, und das dort angegebene Programm ausgef<65>hrt
+ST-Guide : Iconify jetzt nach der (umst<73>ndlicheren) MTOS Methode
+           implementiert, die den unangenehmen Nebeneffekt hat, da<64> die
+           iconifizierten Fenster immer nach hinten gelegt werden.
+           ...angeblich funktionierte die bisherige Methode unter MTOS
+           nicht...
+ST-Guide : der Rechtsklick mu<6D> jetzt innerhalb des ST-Guide Fensters
+           ausgef<65>hrt werden, damit bei aktiviertem RIGHTBACK 'zur<75>ck'
+           ausgel<65>st wird
+ST-Guide : neue Variable PRINTER bewirkt, da<64> bei 'Drucken' die Seite
+           bzw. der Block ins Clipboard geschrieben und das in der Var.
+           angegebene Programm aufgerufen wird, hier kann also ein
+           externes Druckprogramm eingebunden werden
+ST-Guide : '<27>' sollte jetzt korrekt ausgedruckt werden
+HCP      : neues Kommando @xref f<>r Querverweislisten implementiert
+HCP      : Probleme mit *sehr* langen REF-Module (>64K) behoben
+HCP      : -w kann jetzt von einer Ziffer gefolgt werden (0/1/2) und
+           ist auch im @options Kommando m<>glich
+HCP      : meckert jetzt bei zu langen und unteilbaren Zeilen - extra
+           f<>r Leute, die Bin<69>rfiles <20>bersetzen wollen...
+HCP      : -m funktioniert wieder
+HCP      : neue Kommandos @indexon/@indexoff zum Ein/Ausschalten der
+           automatischen <20>bernahme der Seitennamen in den Index
+HCP      : Default-Zeilenl<6E>nge ist jetzt 75,  weil sich das
+           "eingeb<65>rgert" hat
+HCP      : die automatisch erzeugte Index-Seite wird jetzt nicht mehr
+           autoreferenziert
+HCP      : beim Kommando -l kann jetzt eine Filtermaske angegeben werden
+HCP      : Dokumentation <20>berarbeitet
+HCP      : ein paar Sicherheitsabfragen eingebaut, um den Versuch, einen
+           Hypertext erneut zu <20>bersetzen, zu vereiteln...
+STool    : Wird nur eine Index-Seite erzeugt, so erzeugt der hcp nicht
+           mehr auch noch einen, au<61>erdem hat der Hypertext auch wieder
+           ein Subject und der hcp meckert nicht mehr
+STool    : die Kombination +SHRINK, +INDEX f<>hrt jetzt nicht mehr
+           dazu, da<64> keine STG-Datei erzeugt wird
+STool    : neue Variable UPDATEREF schaltet das automatische
+           Aktualisieren der ALL.REF ein/aus
+STool    : Lesen der CFG-Datei ist jetzt weniger pingelig
+STool    : erzeugt jetzt @$VER: Kommando mit aktuellem Datum
+RefLink  : Probleme mit *sehr* langen REF-Modulen (>64K) behoben
+RefLink  : Namen der tempor<6F>ren Datei ge<67>ndert - damit's auch unter DOS
+           legal wird...
+
+
+28.04.95:
+---------
+ST-Guide : Probleme bei 'system' ohne Kommandozeile behoben
+ST-Guide : Probleme bei 'system' unter SingleTOS behoben
+ST-Guide : Probleme mit WinX Scrollboxes (hoffentlich) behoben
+ST-Guide : Dialoge sind unter MagiC jetzt auch ohne Let 'em Fly
+           tastaturbedienbar
+ST-Guide : Dialoge/Popups werden jetzt unter MagiC auch ohne Let 'em Fly
+           ohne Redraw-Nachricht vom Bildschirm entfernt
+ST-Guide : der "Dialog" f<>r die REF-Suche hat jetzt das <20>bliche Design
+           (Hallo Rene ;-)
+ST-Guide : Iconify eingebaut
+ST-Guide : wartet jetzt nach dem <20>ffnen von pnodes, bis die Maustaste
+           wieder losgelassen wird
+ST-Guide : Der Remarker-Eintrag wird beim Beenden desselben jetzt nicht
+           mehr disabled, wenn die entsprechende Variable gesetzt ist
+ST-Guide : Problem mit SEHR langen Hypertexten behoben (Hallo Manfred ;-)
+
+19.04.95:
+---------
+ST-Guide : jetzt wird das Fenster ggfls wieder ge<67>ffnet, wenn HypFind
+           fertig ist und der erzeugte Text angezeigt werden soll...
+ST-Guide : beim Starten von Programmen aus Hypertexten heraus sollte
+           der ST-Guide anschlie<69>end nicht mehr versuchen, die Datei
+           HypFind.hyp zu laden
+ST-Guide : der Aufruf des Fontselektors wird jetzt nicht mehr mit
+           wind_update geklammert (Hallo Dirk ;-)
+ST-Guide : keine Abst<73>rze mehr bei Auswahl eines neuen Fonts bei leerem
+           ST-Guide Fenster
+ST-Guide : jetzt sollte sich auch die Hintergrundfarbe des Fensters
+           einstellen lassen (Variable BCKCOLOR)
+ST-Guide : Font-Protokoll wird unterst<73>tzt, daher kann jetzt auch der
+           FONT_SEL von criss zur Auswahl des Fonts im ST-Guide verwendet
+           werden
+ST-Guide : Autolocator eingebaut; Eingabe: klar, Backspace: letztes Zeichen
+           l<>schen, Shift-Backspace: alle Zeichen l<>schen,
+           Insert: n<>chste Fundstelle;
+ST-Guide : hoffentlich letzten Darstellungsfehler im Zusammenhang mit
+           leeren Nodes behoben
+ST-Guide : der Umbruch bei ASCII-Files erfolgt jetzt beim letztm<74>glichen
+           Leerzeichen, so da<64> in den meisten F<>llen keine Zeichen mehr
+           verlorengehen
+ST-Guide : bei ASCII-Files ohne abschlie<69>endes Newline sollte die letzte
+           Zeile jetzt nicht mehr unterschlagen werden
+ST-Guide : Nachlaufverhinderung "ges<65>ubert"
+ST-Guide : neue Variable RIGHTBACK bewirkt, da<64> Rechtsklicks wie 'zur<75>ck'
+           behandelt werden, wenn das ST-Guide Fenster vorne liegt
+ST-Guide : Zorro's Wille geschehe... Nicht monochrome Bilder werden nicht
+           mehr angezeigt, wenn die Anzahl der Planes des Bildes nicht mit
+           der aktuellen Aufl<66>sung <20>bereinstimmt; stattdessen wird ein
+           Rahmen an den betreffenden Stellen gezeichnet
+ST-Guide : Die Endungen externer Dateien werden jetzt in Gro<72>buchstaben
+           umgewandelt, bevor sie in der INF Datei gesucht werden
+ST-Guide : die externen Viewer werden jetzt unter MagiC wirklich nachge-
+           startet, falls kein AV Server gefunden wird
+ST-Guide : f<>r die Berechnung der max. Fensterbreite wird jetzt die tat-
+           s<>chliche Breite des Bildes benutzt, nicht mehr die (oft
+           falsche) Angabe des Hypertextautors
+ST-Guide : Popup-Nodes haben jetzt automatisch einen oberen und unteren
+           Rand von halber Zeichenh<6E>he
+ST-Guide : Popupmenue umsortiert, Trennlinien eingef<65>gt und eingedeutscht
+ST-Guide : neues Shortcut ALT-D l<>dt den als DEFHYP angegebenen Hypertext
+ST-Guide : <20>berschneidungen von Bildern und Text bei Verwendung kleinerer
+           Fonts geh<65>ren jetzt der Vergangenheit an
+ST-Guide : Zusammenarbeit mit dem neuen Tool Remarker eingebaut
+           - neue Variable REMARKER=[!]<path>
+             -> beim <20>ffnen wird Remarker direkt mitgestartet (ohne '!')
+             -> bei ALT-R wird Remarker nachgestartet
+           - kleine Box links oben im Fenster zeigt den Zustand:
+             * unsichtbar: Remarker l<>uft nicht
+             * sichtbar: Remarker l<>uft, aber zur aktuellen Seite ex. keine
+               Notiz
+             * sichtbar und schwarz: zur aktuellen seite ex. eine Notiz
+           - ALT-R bzw. der betreffende Menuepunkt ruft Remarker (startet
+             ihn ggfls. nach, falls REMARKER definiert ist)
+ST-Guide : neue Variable REFONLY bewirkt, da<64> nur Mausklicks auf
+           Referenzen ausgef<65>hrt werden, Klicks auf "normale" Worte
+           werden also ignoriert
+ST-Guide : auch unter MagiC wird der Server nur noch erkannt, wenn die
+           Environment-Variable AVSERVER gesetzt ist
+HCP      : neues Kommando @limage (line image) als Erweiterung von @image
+           l<><6C>t den ST-Guide das Einf<6E>gen von Leerzeilen vollautomatisch
+           passend zum verwendeten Font durchf<68>hren
+HCP      : Blanks direkt hinter Variablennamen bleiben jetzt erhalten
+HCP      : @symbol in der ersten Zeile einer pnode ist jetzt erlaubt
+HCP      : beim Updaten der ALL.REF sollten jetzt keine Meldungen wegen
+           realloc Fehlern mehr vom hcp kommen
+HCP      : wartet jetzt bei allen Fehlermeldungen auf einen Tastendruck
+HCP      : "HypTree-Data" wird bei -l nicht mehr ausgegeben
+HCP      : undefinierte Variablen werden von @if als 0 behandelt
+HCP      : fehlende @endnode werden im Pass 2 jetzt wieder korrekt
+           behandelt
+HCP      : @include <name>.h wird jetzt 1:1 gelesen, wenn das Kommando
+           innerhalb einer Node steht
+RefLink  : Probleme beim L<>schen von Eintr<74>gen mit Extender sollten jetzt
+           behoben sein
+RefLink  : Bug bei -m gefixt
+
+
+
+
+
+