XMenu v1.4 --> erst lesen, dann starten! :-) ---------------------------------------------- XMenu ist ein Hilfsprogramm, um bis zu 16 Programme bersichtlich zusammen- gefažt und flexibel konfiguriert in einem Desktop-Icon unterzubringen, ohne dadurch Funktionalit„t einzubžen (sondern eher zu gewinnen ;-)). Es sollte auf allen ST/TT usw. laufen, mit allen (Single-)TOS-Versionen oder Mag!X 2.0 (mehr dazu am Ende). Lediglich in ST-Low gibt es Einschr„nkungen wegen der geringen Bildschirmbreite. So richtig Sinn macht das Programm erst, wenn man tats„chlich einen Desktop hat, auf dem man Programm-Icons ablegen kann. Allerdings kann es auch sonst ntzlich sein, irgendwo in entfernten Pfaden versteckte Programme an einer Stelle bequem starten zu k”nnen. Im brigen empfielt sich eine Festplatte, weil man sonst wohl kaum viele Programme an festen Pfaden liegen hat. Copyright --------- XMenu ist Freeware. Es darf beliebig kopiert und benutzt werden, solange alle Dateien unver„ndert weitergegeben werden und damit keine kommerziellen Interessen verbunden sind. Jegliche Haftung fr Sch„den, welcher Art auch immer, ist ausgeschlossen. Anleitung --------- Die gesamte Programmkonfiguration kann abgespeichert werden, und zwar ge- schieht dies direkt durch einen Patch der ausfhrbaren Programmdatei. Ich empfehle deshalb, bereits die ersten Versuche mit einer Kopie des Programms zu machen, denn eine einmal gepatchte Version kann nicht wieder in ihren ursprnglichen Zustand zurckversetzt werden. Dabei sollte man gleich einen sinnvollen Namen fr die Kopie vergeben, denn ber kurz oder lang h„ufen sich die XMenu-Programme (so jedenfalls meine Erfahrung...). Bei mir gibt es z.B. XMENUTXT.PRG fr Textprogramme/Editoren, XMENUARC.PRG fr Packer, XMENUDSK.PRG fr Disk-Utilities, u.a. Natrlich k”nnte man alle installierten XMenu-Programme wieder in einem XMenu zusam- menfassen, aber irgendwann sollte man auch ohne diesen Schritt gengend Ordnung auf dem Desktop geschaffen haben :-). Allgemeine Einstellungen ------------------------ Als ersten Schritt in einem neuen XMenu sollte man die allgemeinen Parameter festlegen. Dazu klickt man mit zus„tzlich gedrckter Shift-Taste auf den Fuller im Dialogfenster oder drckt Shift-Help. In der erscheinenden Dialogbox kann nun eine Titelzeile fr das Fenster eingegeben werden. Aužerdem wird hier ber den Knopf 'XMenu suchen' die eigene Programmdatei zum sp„teren Speichern der Konfiguration spezifiziert. Das kann man auch in dieser Box mit dem Knopf 'Speichern' tun. Der weitere Knopf 'Laden' erm”glicht das Laden einer Konfiguration aus einem anderen XMenu-Programm. Dies wurde implementiert, um bei Erscheinen einer neuen Programmversion nicht s„mtliche Einstellungen neu vornehmen zu mssen, son- dern diese einfach aus der alten Version zu laden. Programme konfigurieren ----------------------- Da sowohl Einfach- als auch Doppelklick fr das Starten der Programme reser- viert ist, muž auch hier zum Erreichen der Konfiguration eine Shift-Taste zus„tzlich festgehalten werden, w„hrend auf ein Anwahlfeld geklickt wird. Hier kann zun„chst ein beliebiger Anwahltext eingegeben werden, der somit wesentlich aussagekr„ftiger sein kann, als der Programmname selbst. Das Feld kann man auch erstmal leer lassen, es wird dann automatisch mit dem Programmnamen vorbesetzt. Der Knopf 'Programm suchen' dient dem Auffinden des gewnschten Programms. Die folgenden sieben Felder dienen der Aufnahme von Datei-Erweiterungen, sie k”nnen aber auch leer bleiben. Wenn eine beliebige Datei auf das XMenu-Pro- grammicon gezogen wird, wird anhand dieser Dateitypen entschieden, ob und ggf. welches Programm automatisch gestartet wird, ohne zuvor das Dialogfen- ster darzustellen. Folgende spezielle Dateitypen gibt es: - Die Tilde ~ wird verwendet, wenn man einem Programm Dateien zuteilen will, die gar keine Erweiterung haben. - Der * wird verwendet, um ein Programm zum Default-Programm zu machen, d.h. wenn die aktuelle Erweiterung in keinem Programm konfiguriert ist, wird dasjenige mit dem * gestartet. Seit v1.4 achtet XMenu darauf, ob doppelte Eintragungen fr Dateitypen vor- handen sind, denn dann kann es sich nicht entscheiden, welches Programm zu starten ist und zeigt das Dialogfenster zur Auswahl an. Sollte man XMenu einmal von Hand mit Parametern fttern oder mehrere Dateien gleichzeitig auf das Icon ziehen, so sollte man wissen, daž immer der letzte Parameter zur Bestimmung der Datei-Erweiterung herangezogen wird. Natrlich kann man XMenu auch mit Dateien fttern, deren Erweiterung nir- gends definiert ist. Dann wird das Dialogfenster dargestellt und der Datei- name in der Infozeile angezeigt. W„hlt man nun ein Programm aus, werden die Parameter durchgereicht. So, genug zu den Dateitypen. Das n„chste Feld nimmt zus„tzliche Parameter auf (wie im Desktop bei Anwendung anmelden). Wenn man z.B. einen Menpunkt zum Ansehen von LHarc-Archiven machen m”chte, kommt hier "v " hinein (man beachte das folgende Leerzeichen). Jetzt wird klar, daž es auch Sinn macht, ein Programm mehrmals (mit verschiedenen Parametern) einzutragen. Bei mir bernehmen z.B. drei Eintr„ge zum Ansehen und rekursiven Ein- und Auspacken von LHarc-Archiven die Aufgaben einer Packershell. Nun zu den Flags: - Ist 'GEM-Programm' gesetzt, so wird das Programm mit Maus und leerem Desk- top aufgerufen, anderenfalls ohne Maus, mit gel”schtem Bildschirm und ein- geschaltetem Textcursor (TOS). Unter Mag!X werden alle Programme parallel gestartet, wobei TOS/TTP-Programme ber VT52.PRG im Fenster ablaufen. - Der Schalter 'Programmpfad setzen' sollte zumindest immer dann gesetzt sein, wenn das Programm RSC-, INF- oder CFG-Dateien usw. ben”tigt, also wenn irgendwelche Dateien oder Ordner an bestimmter Stelle relativ zum Pfad des Programms ben”tigt werden. - Mit dem Schalter 'Parameter vor Name' wird bestimmt, ob die Zusatzparame- ter vor (gesetzt) oder hinter (nicht gesetzt) dem bergebenen Dateinamen geh”ren. Fr die n”tigen Leerzeichen hinter bzw. vor den Zusatzparametern hat man selbst zu sorgen - XMenu fgt keine Leerzeichen ein! - Bei gesetztem 'Parameter erfragen' k”nnen die Programmparameter in einer Dialogbox eingegeben werden, wenn keine Datei an XMenu bergeben wurde. Das Feld ist dann schon mit den konfigurierten Zusatzparametern vorbe- setzt. Luxuri”serweise kann man hier auch noch eine Datei mit dem Filese- lektor w„hlen, die dann mit der Kommandozeile verknpft wird. Dabei wird der Schalter 'Parameter vor Name' ebenfalls bercksichtigt. - Der Schalter 'auf Ende warten' ist nur unter MagiX relevant und deshalb anderenfalls hell dargestellt. Falls er gesetzt ist, wartet XMenu in jedem Fall zun„chst das Ende des Programms ab. Wenn 'XMenu wiederholen' einge- schaltet ist, wird das Dialogfenster also erst nach Programmende wieder ge”ffnet anstatt (durch die Parallelverarbeitung) sofort. Ist 'XMenu wie- derholen' ausgeschaltet, wird das Ende ebenfalls abgewartet, um z.B. noch eine Meldung ber den Ergebniscode machen zu k”nnen. - 'Eingabe anfordern' sollte z.B. bei diversen TTP-Programmen selektiert sein, welche enden, ohne auf eine Taste zu warten. Manchmal will man sich deren Ausgabe schliežlich noch in Ruhe ansehen. Aber auch bei GEM-Pro- grammen kann man sich mit einer Alertbox auf das Ende aufmerksam machen lassen. Unter Mag!X kann dies natrlich nur funktionieren, wenn entweder 'auf Ende warten' angeschaltet ist, oder wenn 'XMenu wiederholen' ange- schaltet und dessen Prozess noch nicht beendet worden ist. - Der Schalter 'Desktop aufr„umen' ist fr Programme bestimmt, die unsauber mit dem Bildschirm umgehen und diesen unter Mag!X nicht ordentlich hinter- lassen. Bei Programmen, die sich bis auf solche Unsauberkeiten noch gut parallel starten lassen, kann man sich so den manuellen Aufruf 'aufr„umen' im Mag!X-Men ersparen. Hier gilt natrlich dasselbe, wie eben: Das klappt nur, wenn der startende XMenu-Prozess noch aktiv ist, also vorzugsweise 'auf Ende warten' eingeschaltet ist. - Letztendlich bestimmt 'XMenu wiederholen', ob nach Beendigung eines Pro- gramms (bzw. unter Mag!X auch direkt nach dem Start) das Dialogfenster erneut erscheinen soll oder nicht. Der Knopf 'Speichern' erm”glicht das Speichern der gesamten Konfiguration. Er ist nur anw„hlbar, wenn die XMenu-Programmdatei vorher spezifiziert wor- den ist (s.o.). Es hat sich gezeigt, daž man bei gr”žeren Žnderungen lieber ”fter einmal speichern sollte, als erst am Ende. Denn schnell ist mal ein Programm gestartet - nur testweise - und anschliežend landet man nicht wie- der in XMenu und alle Žnderungen sind weg. Mit den letzten beiden Kn”pfen kann man (zugegeben: etwas unkomfortabel) die Meneintr„ge umsortieren. Der aktuelle Eintrag wandert jedesmal um ein Feld nach oben bzw. unten. Sonstiges --------- Sollte ein Programm mit einem Ergebnis-Code ungleich Null terminieren, so wird das angezeigt (unter Mag!X nur, wenn der startende XMenu-Prozess noch aktiv ist). Negative Werte werden als TOS-Fehlernummer interpretiert und einige davon auch im Klartext angezeigt. Wenn der Ergebniscode nicht Null ist, wird XMenu in jedem Fall wiederholt. Fr XMenu sollte man keinen Programm-Packer verwenden (wie z.B. PFX von Thomas Quester und Markus Fritze), da das Programm zwar noch l„uft, aber Žnderungen an den Parametern nicht mehr abgespeichert werden k”nnen. Da s„mtliche Dateinamen (auch der eigene Programmname) als absolute Pfade abgespeichert werden, sollte man vorsichtig mit dem Verschieben von Pro- grammen sein und die Eintr„ge ggf. gleich anpassen. Man sollte XMenu im Desktop so als Anwendung anmelden, daž der Pfad des aktuellen Fensters gesetzt wird. Mit dem Pfad des XMenu-Programms kann man in der Regel wenig anfangen, besonders wenn Meneintr„ge mit dem aktuellen Pfad konfiguriert werden. Einschr„nkungen --------------- Das ARGV-Verfahren wird nicht untersttzt. Dadurch ist die Kommandozeile auf maximal 124 Zeichen beschr„nkt. Sollte diese L„nge einmal nicht ausreichen, wird eine entsprechende Meldung ausgegeben und das Programm nicht gestartet. Mir pers”nlich hat die normale Kommandozeile in der Praxis noch immer ausge- reicht. Da sich also von mir aus keine Notwendigkeit ergibt, werde ich ARGV erst nach einigen Wunsch„užerungen einbauen. Es gibt keine besonderen Vorkehrungen, daž XMenu auch unter MultiTOS oder Mag!X < 2.x l„uft. Das liegt in erster Linie daran, daž ich es nicht zum Testen habe, und noch nicht weiž, inwieweit die Anpassungen fr Mag!X 2.0 auch schon < 2.0 oder unter MultiTOS kompatibel sind. Im Moment wird MultiTOS wie SingleTOS behandelt und sollte daher normal funktionieren (ohne Parallelstart). Die Sonderbehandlung fr Mag!X 2.0 tritt in Kraft, wenn der MagX-Cookie existiert, l„uft also unter Mag!X < 2.0 nur problemlos, wenn alle benutzten Features schon kompatibel existieren. Wer also diesbezglich noch Anpassungen wnscht - fr konstruktive Vorschl„ge habe ich immer ein offenes Ohr. Die Programmauswahl im Dialogfenster ist nicht tastaturbedienbar. Der Single-Mode von Mag!X wird nicht untersttzt (wie geht das?). Fr Pro- gramme, die nur im Single-Mode laufen, kann man sich XMenu v1.3 aufheben und die Programme dort eintragen. Das XMenu selbst muž dann im Single-Mode ange- meldet werden. Tasten im Dialogfenster ----------------------- - Help (= Fuller des Fensters): Info-Dialog - Shift-Help (= Shift-Fuller): Allgemeine Einstellungen - Control-Q } - Control-U } Schliežen des Dialogfensters und Programmende - Undo } Bugreports ---------- Fehlermeldungen, Verbesserungsvorschl„ge und sonstige Kommentare bitte an: Jens Brggemann Reuterdamm 122 D-30853 Langenhagen oder am besten via Mausnet an: Jens Brggemann @ H bzw. via Internet an: Jens_Brueggemann@h.maus.de