H„ufige Fragen & Probleme:
--------------------------
-> Der Aufruf des ST-Guide per appl_write() aus  meinem  Programm
   heraus funktioniert nicht. Woran liegt das?

Der ST-Guide kopiert die �bergebenen Strings zwar, aber  zwischen
dem Aufruf und dem Kopieren der Parameter  vergeht  eine  gewisse
Zeit. Das aufrufende Programm muž daher den  String  so  anlegen,
daž  er  zumindest  noch  eine  gewisse  Zeit  lang   unver„ndert
vorliegt, er darf also insbesondere nicht als lokale Variable auf
dem Stack liegen. Am besten ein globales  Array  verwenden,  dann
funktioniert es auch.

Beispiel (AV-Protokoll):

char HelpString[100];

Help(char *pattern)
{
    int msg[8], i;

    if ((i=appl_find("ST-GUIDE"))>=0) {
        msg[0] = VA_START;
        msg[1] = global[2];
        msg[2] = 0;
        sprintf(HelpString, "*:\\MYPROG.HYP %s", pattern);
        *(char **)&msg[3] = HelpString;
        msg[5] = 0;
        msg[6] = 0;
        msg[7] = 0;
        appl_write(i, 16, msg);
    }
}

Beispiel (PureC-Protokoll):

char HelpString[100];

Help(char *pattern)
{
    int msg[8], i;

    if ((i=appl_find("ST-GUIDE"))>=0) {
        msg[0] = AC_HELP;
        msg[1] = global[2];
        msg[2] = 0;
        strcpy(HelpString, Pattern);
        *(char **)&msg[3] = HelpString;
        msg[5] = 0;
        msg[6] = 0;
        msg[7] = 0;
        appl_write(i, 16, msg);
    }
}


-> ST-Guide soll Sounds, Bewegtbilder und meinen Kaffee-Automaten
   unterst�tzen.

Keine Chance. Der ST-Guide ist als reiner Hypertext-Viewer ausge-
legt und das wird auch so bleiben.  Bei  entsprechender  Resonanz
und ausreichend vielen  Spenden  kommen  vielleicht  mal  externe
Viewermodule, aber direkt eingebaut  werden  solche  Dinge  nicht
(ST-Guide soll so kurz wie m”glich bleiben).


-> Meine XIMG's werden vom Compiler nicht aktzeptiert.

Nach meinen Informationen unterscheiden sich IMG- und XIMG-Format
nur im Header. Eingene Tests mit  XIMG's  (von  1stView  erzeugt)
haben keinerlei Probleme ergeben.


-> ich finde die Handhabung des 1stGuide, jede Seite in einer ei-
   genen Datei zu haben viel besser, als alles in einer Datei  zu
   halten. Geht das mit dem ST-Guide auch?

Ja, nat�rlich. Man verwende den @include-Befehl.


-> Wenn der ST-Guide unter MTOS von einem anderen Programm aufge-
   rufen wird, meldet MTOS einen 'privileg violation error'.  Was
   soll das?

Unter MTOS mit entsprechendem Prozessor  unterliegt  jeder  Spei-
cherbereich einem gewissen,  definierbaren  Schutz.  Defaultm„žig
darf z.B. nur das Programm selbst und das AES den Speicher  eines
laufenden Prozesses lesen/schreiben. Wenn  ein  solches  Programm
eine Meldung an den ST-Guide sendet, dann kopiert das AES hiervon
nur die  Zeiger  auf  Pfade  und  Suchbegriffe,  nichtjedoch  die
Strings selbst, d.h. der Speicher, in dem sie sich befinden,  ge-
h”rt dem aufrufenden Prozess und auch ein  lesender  Zugriff  des
ST-Guide wird von MTOS angemeckert.
Anhilfe:
1. (Notl”sung): Die Flags des  Programmes  (NICHT  des  ST-Guide)
   auf private/readable setzen, hierzu eignet sich z.B. das  Pro-
   gramm GD_FLAGS von Gregor Duchalski.
2. (Beste L”sung): Das aufrufende Programm benutzt Mxalloc()  mit
   entsprechenden Parametern, um den Speicher f�r die zu  �berge-
   benden Strings anzufordern.
N„heres zu beiden L”sungen findet sich in der MTOS-Doku.


-> ST-GUIDE liest meine [X]Environment-Variablen nicht. Wieso?

Weil dieses Feature aufgrund breiter Ablehnung und diverser Probleme
ausgebaut wurde. Parameter werden jetzt nur noch aus der Datei
ST-Guide.inf im Wurzelverzeichnis des Bootlaufwerkes gelesen.

Sollte sich Ihr Problem jetzt noch nicht erledigt haben, so bitte
ich um Nachricht. Damit sie ber�cksichtigt werden  kann,  sollten
ihr folgende Informationen zu entnehmen sein:
1. Welche Version wird benutzt (evtl. in der Maus  OL  nachsehen,
   ob es bereits eine neuere gibt und ggfls. mit dieser noch  mal
   probieren)
2. mit welcher Komponente tritt das Problem auf
3. Wie „užert es sich; diesen Punkt so  ausf�hrlich  wie  m”glich
   behandeln, mit Meldungen wie "der Konverter  �bersetzt  meinen
   Text nicht." kann ich nichts anfangen!
4. Insbesondere bei Problemen  mit  dem  ACC  einmal  nur  dieses
   booten, also alle anderen ACC's und den  Autoordner  disablen.
   Wenn das Problem dann nicht mehr auftritt, dann durch schritt-
   weises mitbooten der anderen ACC's Auto-Prog's versuchen  her-
   auszufinden, mit welcher Kombination das Problem auftritt  und
   mir mitteilen.