home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / wp_dtp / most145.lha / Most / Docs / Most.dok < prev    next >
Text File  |  1993-04-20  |  30KB  |  1,164 lines
  1.                       Dokumentation zu Most V1.45
  2.  
  3.                          Datum: 20. April 1993
  4.  
  5.                             Autor: Uwe Röhm
  6.  
  7.       Most ist ein Textanzeiger ähnlich Less, More oder MuchMore.
  8.  
  9.    Most bietet
  10.  
  11.    -     beliebig viele Textfenster
  12.  
  13.    -     verteiltes Prozeßsystem
  14.  
  15.    -     Suchfunktion
  16.  
  17.    -     frei konfigurierbar
  18.  
  19.    -     Kopiermöglichkeit ins Clipboard
  20.  
  21.    -     Einladen von Dateien per Doppelklick
  22.  
  23.    -     Fontsensitive Oberfläche
  24.  
  25.    -     PubScreen, eigenen Bildschirm oder Workbench
  26.  
  27.    -     AppWindow, AppIcon
  28.  
  29.    -     ARexx Unterstützung
  30.  
  31.    -     Sprachanpassung per locale.library
  32.  
  33.    -     `XPK' Unterstützung
  34.  
  35.    -     Verwendung mit Pipes
  36.  
  37.    -     Hilfe per AmigaGuide
  38.  
  39.    -     benötigt Kickstart 2.0 oder höher!
  40.  
  41.  
  42. Most V1.45
  43. ***********
  44.  
  45.                       Dokumentation zu Most V1.45
  46.  
  47.                 Datum: 20. April 1993  Autor: Uwe Röhm
  48.  
  49.  
  50. Copyright
  51. **********
  52.  
  53.    Am Anfang standen Schweiss und Mühe. Also sprach der Programmierer:
  54. Es werde Giftware! Und so war es.
  55.  
  56.    Most 1.45 ist Giftware und darf frei kopiert und benutzt werden. Ich
  57. würde mich aber über Geschenke jeglicher Art von den Benutzern, die
  58. Most regelmäßig verwenden, *sehr* freuen.
  59.  
  60.    Davon abgesehen behalte ich mir mein Copyright aber vor, also:
  61.  
  62.                    Copyright (C) 1992/1993 Uwe Röhm
  63.  
  64.    Ich verbiete ausdrücklich, daß Most kommerziellen Produkten ohne
  65. meine Zustimmung beigelegt wird. Insbesondere darf Most *nicht* für
  66. militärische Zwecke im weitesten Sinne verwendet werden. Im weitesten
  67. Sinne heißt, daß ich auch den Verwaltungen und sonstigen Büros
  68. solcher Firmen die Verwendung untersage, die militärische Produkte
  69. auch nur planen oder unterstützen (Hersteller sowieso).
  70.  
  71.    Most darf in PD Sammlungen aufgenommen werden, solange jene nicht
  72. mehr als umgerechnet 10 DM kosten. Das ist das absolute Maximum! Ich
  73. verlange aber, daß Most immer vollständig, also insbesondere immer
  74. zusammen mit der Dokumentation verbreitet wird. Das gilt auch für
  75. jeden normalen Benutzer! Leute, denkt an die Doku - ohne die ist ein
  76. Programm nur die Hälfte wert!
  77.  
  78.  
  79. Prinzip
  80. ********
  81.  
  82.    Ich habe Most geschrieben, da ich eine Textanzeiger haben wollte, der
  83. auf der Workbench aufgeht und sowohl über die Tastatur als auch die
  84. Maus vollständig zu bedienen ist. Außerdem sollte er möglichst
  85. flexibel sein und insbesondere auch mit wenig Speicher auskommen.
  86.  
  87.    Deshalb arbeitet Most *immer* mit einem Fenster, in dem der Text
  88. angezeigt wird. Wer will, kann jenes aber auch auf anderen Bildschirm
  89. öffnen lassen. Most kann sogar einen eigenen Bildschirm öffnen.
  90. Wieviele Fenster Most aufhat, wo jene liegen (welcher PubScreen) und
  91. welche Texte darin zu sehen sind hängt nur vom Speicher und dem
  92. Benutzer ab :-)
  93.  
  94.    Jeder Text hat nicht nur sein eigenes Fenster, sondern dahinter
  95. steht auch ein eigener Prozeß. Damit sind die Textfenster voneinander
  96. völlig autonom. Insbesondere können ARexx Befehle an verschiedenen
  97. Texte gleichzeitig gesendet werden und es ist immer möglich, neue
  98. Fenster zu öffnen, auch wenn die bereits geöffneten gerade
  99. "beschäftigt" sind. Dazu gibt es einen Most Hauptprozess, der die Texte
  100. verwaltet und einige globale ARexx Befehle behandelt (see Der ARexx
  101. Port).
  102.  
  103.    Um den Speicherverbrauch unter Kontrolle zu haben, arbeitet Most
  104. immer mit einem Puffer. Kleinere Texte, die vollständig in den Puffer
  105. passen, werden in einem Aufwasch eingelesen. Als Nebeneffekt wird die
  106. Textdatei nun nicht mehr benötigt und kann z.B. sofort weiter
  107. verändert werden. Zu große Texte werden pufferweise gelesen. Das spart
  108. Speicherplatz (man wähle kleine Puffergrößen), bringt aber weniger
  109. Komfort (sprich Zeiteinbuße) beim Scrollen und Suchen. Außerdem
  110. blockiert Most nun den Text, so daß er nicht verändert werden kann,
  111. solange Most in anzeigt.
  112.  
  113.    Dieses "Paging" großer Dateien ist sehr nützlich, wenn man wenig
  114. Speicher oder übergroße Dateien hat. Wer es nicht haben will braucht
  115. nur die Puffer- größe sehr sehr groß machen (sagen wir mal 4 MB),
  116. womit wohl alle normalen Textdateien auf einen Schwung einlesbar sind.
  117. Keine Angst, Most verwendet dann natürlich nur soviel Speicher, wie
  118. die Datei groß ist :-))
  119.  
  120.    Eine Ausnahme des Pagings sind `XPK'-gepackte Dateien, die der
  121. Einfachheit halber immer vollständig eingelesen werden. Für sie gibt
  122. es also *kein* Paging! (see XPK Schnittstelle)
  123.  
  124.    Natürlich kann Most Texte mit allen ANSI-Steuersequenzen anzeigen.
  125. Dafür habe ich das Rad nicht noch einmal erfunden, sondern auf
  126. Bewährtes zurückge- griffen: Das console.device. Als Nebeneffekt kann
  127. man Textstellen markieren und in das Clipboard kopieren. Leider hat
  128. dies auch drei Nachteile:
  129.    -  Man kann nur innerhalb der sichtbaren Seite markieren
  130.  
  131.    -  Das Scrollen ist auf Amigas ohne 680x0 (x >=2) relativ langsam ;-)
  132.  
  133.    -  Binäre Dateien sollte man NICHT einladen. Das gibt Chaos....
  134.  
  135.  
  136. Konfiguration
  137. **************
  138.  
  139.    Most konfiguriert sich in der Reihenfolge
  140.  
  141.   1. Interne Vorgabewerte
  142.  
  143.   2. Environmentvariablen `Most/Most' und `Most/FileReq' (Bei Aufruf in
  144.      einer Shell werden lokale Variable zuerst eingelesen)
  145.  
  146.   3.      Bei Shell-Start: Shellparameter auswerten
  147.           Bei WB-Start   : Icon-Tooltypes auswerten
  148.  
  149.    Folgende Optionen sind jeweils in 2.) und 3.) erlaubt:
  150.  
  151.  
  152. FILES
  153. ======
  154.  
  155. Verwendung
  156.      Eine Liste von Dateien (nur beim Start aus einer Shell). Es
  157.      können die bekannten AmigaDOS Wildcards verwendet werden.
  158.  
  159.  
  160. PUBSCREEN
  161. ==========
  162.  
  163. Verwendung
  164.      Zur Angabe eines Bildschirms, auf dem Most sein Fenster öffnet.
  165.  
  166.  
  167. PORTNAME
  168. =========
  169.  
  170. Verwendung
  171.      Name des globalen ARexx Ports von Most (see Der ARexx Port).
  172.  
  173. Vorgabewert
  174.      MOSTPORT
  175.  
  176.  
  177. STARTUP
  178. ========
  179.  
  180. Verwendung
  181.      Arexx Skript das beim Starten von Most ausgeführt wird (Achtung:
  182.      Dieses Skript wird auch beim Öffnen jedes weiteren Textfensters
  183.      ausgeführt!!) (see Der ARexx Port).
  184.  
  185.  
  186. WINDOWX
  187. ========
  188.  
  189. Abkürzung
  190.      WX
  191.  
  192. Verwendung
  193.      Zur Angabe der X-Koordinate der Most-Fenster.
  194.  
  195.  
  196. WINDOWY
  197. ========
  198.  
  199. Abkürzung
  200.      WY
  201.  
  202. Verwendung
  203.      Zur Angabe der Y-Koordinate der Most-Fenster. -1 zentriert die
  204.      Fenster.
  205.  
  206.  
  207. WINDOWW
  208. ========
  209.  
  210. Abkürzung
  211.      WW
  212.  
  213. Verwendung
  214.      Die Breite der Fenster angeben.
  215.  
  216. Vorgabewert
  217.      600
  218.  
  219.  
  220. WINDOWH
  221. ========
  222.  
  223. Abkürzung
  224.      WH
  225.  
  226. Verwendung
  227.      Zur Angabe der Fensterhöhe.
  228.  
  229. Vorgabewert
  230.      400
  231.  
  232.  
  233. SCREENMODE
  234. ===========
  235.  
  236. Abkürzung
  237.      SM
  238.  
  239. Verwendung
  240.      Der Name einer Bildschirmauflösung, die dem Betriebssystem
  241.      bekannt ist (Most verwendet keine fest einprogrammierte
  242.      Namensliste). Eine Liste dieser Namen sieht man zum Beispiel im
  243.      Fenster des `Prefs/ScreenMode' Programms. Wird ein gültiger Modus
  244.      angegeben, so öffnet Most einen eigenen Bildschirm (Name: Most),
  245.      auf dem seine Fenster liegen. *Achtung*: Je nach Version der
  246.      Monitordateien ändern sich eventuell die Namen der Auflösungen.
  247.  
  248. Beispiel
  249.              SCREENMODE "Pal:HighRes"
  250.  
  251.  
  252. FONT
  253. =====
  254.  
  255. Verwendung
  256.      Der Name des gewünschten Zeichensatzes für den Text inklusive
  257.      der Endung ".font". Achtung mit Proportionalfonts!
  258.  
  259. Beispiel
  260.              FONT "helvetica.font"
  261.  
  262.  
  263. FONTHEIGHT
  264. ===========
  265.  
  266. Verwendung
  267.      Hiermit kann die Höhe des eigenen Zeichensatzes angegeben werden.
  268.      Wird die Höhe nicht explizit angegeben, so wird die Höhe des
  269.      Standard-System-Fonts kopiert. Diese Option wirkt nur in
  270.      Zusammenhang mit der Option FONT.
  271.  
  272.  
  273. APPICON
  274. ========
  275.  
  276. Verwendung
  277.      Das AppIcon von Most wird mit diesem Schalter angeschaltet. Wird
  278.      diese Option ohne weitere Dateinamen angegeben, so startet Most im
  279.      Hintergrund nur mit dem AppIcon.
  280.  
  281.  
  282. ICONX
  283. ======
  284.  
  285. Verwendung
  286.      Die X-Koordinate vom APPICON auf der Workbench.
  287.  
  288.  
  289. ICONY
  290. ======
  291.  
  292. Verwendung
  293.      Die X-Koordinate für das APPICON auf der Workbench.
  294.  
  295.  
  296. BUFLEN
  297. =======
  298.  
  299. Verwendung
  300.      Hiermit läßt sich die maximale Länge des Lesespeichers angeben.
  301.      Für kleiner Dateien wird nur ein Puffer von der Länge der Datei
  302.      allokiert. Dadurch kann mit sehr großen Puffergrößen erzwungen
  303.      werden, alle Dateien vollständig einzuladen.
  304.  
  305. Vorgabewert
  306.      50 000 Bytes
  307.  
  308.  
  309. PIPELEN
  310. ========
  311.  
  312. Verwendung
  313.      Most kann auch aus einer Pipe lesen. Normalerweise werden dann
  314.      fest BUFLEN/10 Bytes zum Lesen belegt. Mit dieser Option kann man
  315.      die Speichergröße für Pipes explizit setzen.
  316.  
  317. Beispiel
  318.              PIPELEN 8192
  319.  
  320.  
  321. QUOTES
  322. =======
  323.  
  324. Verwendung
  325.      Hiermit wird eine Folge von Trennzeichen definiert. Der Sinn
  326.      dahinter ist die Möglichkeit, mit Doppelklick auf ein Wort, das
  327.      *zwischen* den hiermit angegebenen Trennern steht, einen Text mit
  328.      dem entsprechenden Namen zu laden. Das ist besonders für
  329.      Programmierer gedacht, die somit leicht die Inklude--Dateien in
  330.      ihren Sourcen anspringen können.
  331.  
  332. Vorgabe
  333.      "'<>(){}[]
  334.  
  335.  
  336. DIRS
  337. =====
  338.  
  339. Verwendung
  340.      Hiermit können mehrere Pfade angegeben werden, die der Reihe nach
  341.      durchsucht werden, wenn Most nach einem Doppelklick in den Text
  342.      Inklude--Dateien einzuladen versucht (siehe QUOTES). Die einzelnen
  343.      Pfade werden durch das Zeichen `|' voneinander getrennt.
  344.  
  345. Beispiel
  346.              DIRS "Include:|TexInputs:|LC:Include/"
  347.  
  348.  
  349. ENDS
  350. =====
  351.  
  352. Verwendung
  353.      Endungen, die automatisch an Inklude-Dateien (der Reihe nach)
  354.      angehängt    werden (vgl. DIRS, QUOTES).
  355.  
  356. Beispiel
  357.              ENDS ".c.h.tex"
  358.  
  359.  
  360. Tastenbefehle
  361. **************
  362.  
  363.    Grundsätzlich werden alle von More her bekannten Tastenkommandos
  364. unterstützt. Die Befehle unterteilen sich in folgende Bereiche:
  365.  
  366.  
  367. Scrollen
  368. =========
  369.  
  370. eine Zeile tiefer
  371.      `CURSOR RUNTER' `ZIFFERBLOCK 2' `RETURN' `ENTER'
  372.  
  373. eine Zeile hoch
  374.      `CURSOR HOCH' `ZIFFERBLOCK 8' `DELETE'
  375.  
  376. eine Seite weiter springen
  377.      `SHIFT CURSOR RUNTER' `SPACE' `PAGE DOWN'
  378.  
  379. Eine Seite zurück springen
  380.      `SHIFT CURSOR HOCH' `BACKSPACE' `PAGE UP' `b'
  381.  
  382. Zum Textanfang springen
  383.      `HOME' `<'
  384.  
  385. Zum Textende springen
  386.      `END' `>'
  387.  
  388. Eine Spalte nach rechts
  389.      `CURSOR RECHTS' `ZIFFERBLOCK 6'
  390.  
  391. Eine Spalte nach links
  392.      `CURSOR LINKS' `ZIFFERBLOCK 4'
  393.  
  394. 8 Spalten nach rechts
  395.      `SHIFT CURSOR RECHTS'
  396.  
  397. 8 Spalten nach links
  398.      `SHIFT CURSOR LINKS'
  399.  
  400.  
  401. Suchbefehle
  402. ============
  403.  
  404. Bisherigen Suchbegriff weiter suchen (vorwärts)
  405.      `n'
  406.  
  407. Suchen ohne auf Groß/Kleinschrift zu achten
  408.      `.'
  409.  
  410. Suchen mit Unterscheidung nach Groß/Kleinschrift
  411.      `/'
  412.  
  413. Das Suchfenster öffnen
  414.      `f' `s'
  415.  
  416.  
  417. Laden
  418. ======
  419.  
  420.    Neuen Text laden mit `l' (Dateiauswahlfenster erscheint).
  421.  
  422.  
  423. Informationsfenster
  424. ====================
  425.  
  426.    Neben dem üblichen Copyright stehen hier nähere Informationen zum
  427. aktuellen Text: Der Dateiname, die Dateigröße, die Zeilenzahl und die
  428. davon gerade sichtbaren Zeilen, sowie der Name des `XPK' Packers (oder
  429. einfach nur "---" wenn die Datei ungepackt ist). Hier erscheint auch
  430. entweder die Meldung, daß der Text komplett eingelesen wurde, oder die
  431. Größe des benutzten Lesespeichers.
  432.  
  433.    Das Informationsfenster öffnen Sie mit `h'.
  434.  
  435.  
  436. Hilfe
  437. ======
  438.  
  439.    Wenn Sie `HELP' drücken, wird der AmigaGuide mit der Beschreibung
  440. von Most gestartet. Dazu muß natürlich der AmigaGuide installiert
  441. sein. Wenn Most die amigaguide.library nicht öffnen kann, dann
  442. erscheint stattdessen das Informationsfenster.
  443.  
  444.    Der AmigaGuide sucht seine Dokumente im aktuellen Verzeichnis und in
  445. allen Pfaden, die in der Environment Variablen AMIGAGUIDE/PATH
  446. aufgelistet sind.
  447.  
  448.  
  449. Editieren
  450. ==========
  451.  
  452.    Wenn Sie `e' drücken, wird der Text in einen Editor geladen. Der
  453. Editor wird asynchron gestartet. Den Namen des Editors erwartet Most in
  454. der Environmentvariablen EDITOR.
  455.  
  456.  
  457. Beenden
  458. ========
  459.  
  460.    Das Textfenster wird mit `ESCAPE', `CTRL-C' oder `q' geschloßen.
  461.  
  462.  
  463. Menus
  464. ******
  465.  
  466.    Es gibt folgende Hauptmenüs in Most:
  467.  
  468.  
  469. Projekt
  470. ========
  471.  
  472. `Neu...'
  473.      Öffnet ein neues Fenster und fragt per Dateiauswahlfenster nach
  474.      einer neuen Datei. Wenn der Dateiauswahlfenster abgebrochen wird,
  475.      so wird das Fenster wieder geschloßen.
  476.  
  477. `öffnen...'
  478.      Per Dateiauswahlfenster den Namen einer neuen Textdatei auswählen
  479.      und in das aktuelle Fenster laden. Die Ausmaße, Koordinaten und
  480.      das Pattern des Dateiauswahlfensters können im Einstellungen
  481.      Menü abgespeichert werden.
  482.  
  483. `editieren...'
  484.      Startet den Editor mit dem aktuellen Text (per RUN). Der Name des
  485.      Editors muß in der Environment Variable EDITOR stehen.
  486.  
  487. `Info...'
  488.      Öffnet ein Informationsfenster, in dem neben dem üblichen
  489.      Copyright einige wichtige Informationen zum aktuellen Text stehen:
  490.      Name, Dateilänge, Zeilenzahl, sichtbare Zeilennummern,
  491.      `XPK'-Packername und entweder die Meldung, daß der Text komplett
  492.      eingelesen wurde, oder die Größe des benutzten Puffers.
  493.  
  494. `Ende'
  495.      Beendet den aktuellen Text und -- falls es der letzte Text ist --
  496.      auch ganz Most.
  497.  
  498.  
  499. Bewegen
  500. ========
  501.  
  502.    Verschiedene Menüpunkte zum zeilen- und seitenweisen Springen im
  503. Text, bzw. um gezielt die letzte oder erste Seite anzuspringen.
  504.  
  505.    Mit dem Menü "zu Zeile ..." kann man in einem Dialogfenster eine
  506. bestimmte Zeilennummer eingeben, zu der man im Text Springen möchte.
  507. Most macht nichts, wenn die eingegebene Nummer ungültig ist (kleiner 1
  508. oder zu groß).
  509.  
  510.  
  511. Suchen
  512. =======
  513.  
  514. `suchen...'
  515.      Das Suchfenster wird geöffnet und aktiviert dessen
  516.      Texteingabefeld. Bei bereits offenem Requester ist dieser
  517.      Menüpunkt inaktiviert.
  518.  
  519. `vorwärts/rückwärts'
  520.      Suchen des eingegebenen Suchtextes in die jeweilige Richtung.
  521.      Beide Punkte sind anwählbar, wenn das Suchfenster geöffnet ist.
  522.  
  523.  
  524. Extras
  525. =======
  526.  
  527. `Bild neu aufbauen'
  528.      Initialisiert die Console neu und baut die aktuelle Seite noch
  529.      einmal vollständig auf.
  530.  
  531. `Skript starten...'
  532.      Öffnet einen Dateiauswahlfenster, mit dem ein ARexx Makro
  533.      ausgewählt werden kann, das anschließend ausgeführt wird.
  534.  
  535.  
  536. Einstellungen
  537. ==============
  538.  
  539. `sichern'
  540.     `global'
  541.           Speichern der momentanen Einstellungen in Env: und EnvArc: in
  542.           ein Unterverzeichnis `Most' (das automatisch erzeugt wird).
  543.           Es werden alle von der Kommandozeile bekannten Optionen
  544.           gespeichert. Zusätzlich werden in einer extra Variablen die
  545.           Maße, die Position und das Pattern des Dateiauswahlfensters
  546.           abgespeichert.
  547.  
  548.     `lokal'
  549.           Speichern der Einstellungen in zwei lokale Shell Variablen
  550.           namens MOST/MOST und MOST/FILEREQ (sorry wegen den Namen...).
  551.           Diese Option funktioniert natürlich nur, wenn Most von einer
  552.           Shell aus gestartet worden ist!
  553.  
  554.  
  555. Das Textfenster
  556. ****************
  557.  
  558. Titelzeile
  559.      Links steht der Dateiname, möglichst weit rechts wird die
  560.      aktuelle Spalten- und Zeilennummer der obersten (sichtbaren) Zeile
  561.      angegeben. Format:
  562.            <Dateiname>                               <Spalte>/<Zeile>
  563.  
  564. Symbole
  565.      Neben den bekannten Systemsymbolen zum Schließen, Verkleinern usw.
  566.      gibt es drei weitere Symbole am rechten Fensterrand, mit denen im
  567.      Text gescrollt werden kann. Der Scrollbalken kann sowohl frei
  568.      bewegt, als auch durch hineinklicken seitenweise benutzt werden.
  569.      Die Balkenposition gibt die Position im Text, seine Größe das
  570.      Verhältnis der sichtbaren Seite zum ganzen Text an. Die beiden
  571.      Pfeilsymbole darunter dienen zum zeilenweisen Auf- und Abscrollen.
  572.  
  573. Maussteuerung
  574.      Wir mit der Maus in das Fenster doppelt geklickt, so wird an der
  575.      entsprechenden Stelle nach einem Dateinamen zwischen den
  576.      konfigurierten Trennzeichen (see QUOTES) gesucht. Ist dort eine
  577.      solche Textstelle vorhanden (z.B. in C-Sourcen ein "#include
  578.      <exec/exec.h>" mit dem Dateinamen exec/exec.h zwischen "<" und
  579.      ">"), dann wird jener in allen konfigurierten Verzeichnissen (vgl.
  580.      DIRS) gesucht und sofern gefunden in einem eigenen Fenster
  581.      angezeigt.
  582.  
  583. Clipboard
  584.      Es kann aus den Fenstern durch das einfache Anklicken des Textes
  585.      und dem anschließenden Bewegen der Maus (*ohne* den linken Knopf
  586.      loszulassen!) ein Textbereich im Fenster markiert werden. Der
  587.      markierte Textbereich kann dann mit `AMIGA-C' kopiert werden.
  588.  
  589. AppWindow
  590.      Jedes Most--Textfenster ist ein sogenanntes AppWindow, in das
  591.      jederzeit eines oder auch mehrere Icons gezogen werden können.
  592.      Die erste Datei wird dann in das aktuelle Fenster eingeladen und
  593.      für alle weiteren Dateien werden eigene Fenster geöffnet.
  594.  
  595.  
  596. Das Suchfenster
  597. ****************
  598.  
  599.    Im Suchfenster kann ein Suchbegriff eingegeben, sowie die drei
  600. Suchoptionen eingestellt werden. Dies geht sowohl mit der Maus als auch
  601. per Tastatur. Die entsprechenden Buchstabenabkürzungen sind in den
  602. Symboltexten unterstrichen. Außerdem hat man im Suchfenster die
  603. gleiche Funktionalität wie im zugehörigen Textfenster:
  604.  
  605.    - Es sind dieselben Menüs und deren Shortcuts vorhanden. Lediglich
  606.      der Menüpunkt Suchen ist abgeschaltet und dafür die Punkte
  607.      vorwärts/rückwärts suchen zugelassen.
  608.  
  609.    - Neben den speziellen Tastenbefehlen für die Symbole des
  610.      Suchfensters werden *alle* Tastenbefehle des Textfensters
  611.      weiterhin unterstützt. Insbesondere kann man also bei aktiviertem
  612.      Suchfenster mit den Cursortasten im Textfenster scrollen!!!
  613.      (Achtung: Das geht nur bei inaktivem Texteingabefeld)
  614.  
  615.  
  616. Das AppIcon
  617. ************
  618.  
  619.    Das AppIcon erlaubt zwei Funktionen:
  620.  
  621. `Doppelklick'
  622.      Ein Dateiauswahlfenster erscheint, in dem eine Datei ausgewählt
  623.      werden kann. Ist nur noch das AppIcon von Most aktiv (das heißt
  624.      keine Textfenster offen) und wird nun das Auswahlfenster
  625.      abgebrochen, so wird damit Most beendet (vorher kommt natürlich
  626.      noch eine Sicherheitsabfrage)!
  627.  
  628. `Icons'
  629.      Werden Piktogramme auf das AppIcon gezogen, so werden jene
  630.      angezeigt.
  631.  
  632.    Bemerkungen:
  633.      Most verwendet immer das eigene Piktogramm als APPICON! Ein
  634.      eingebautes Bild bzw. ein explizit angegebenes werden nicht
  635.      angeboten/unterstützt. Die Koordinaten des AppIcons werden im
  636.      Menü Einstellungen mit abgespeichert. Mit den Optionen ICONX und
  637.      ICONY können explizite Koordinaten angegeben werden.
  638.  
  639.  
  640. XPK Schnittstelle
  641. ******************
  642.  
  643.    Die Schnittstelle zum `XPK' Standard ist absolut transparent, um
  644. nicht zu sagen, unsichtbar gehalten. Ist eine Datei mit einem `XPK'
  645. Packer gepackt und ist das `XPK' Packet korrekt installiert, so
  646. entpackt Most die Datei automatisch und zeigt sie dann an. Im
  647. Informationsfenster erscheint nun hinter "`XPK'-Packer:" nicht mehr wie
  648. üblich "---", sondern der Name des verwendeten Packers. Einzige
  649. Besonderheit: Die Datei wird vollständig eingeladen, ein "Paging"
  650. findet nicht statt!
  651.  
  652.    Trifft Most auf eine mit `XPK' verschlüsselte Datei, dann öffnet
  653. er erst ein Passwort--Dialogfenster, in dem man sein Passwort angeben
  654. kann. Aber Vorsicht: Man hat nur diese eine Gelegenheit! Gibt man ein
  655. falsches Passwort an, sieht man den verschlüsselten Kauderwelch und
  656. muß den Text erneut laden.
  657.  
  658.    Most kann ohne Probleme auch ohne `XPK' verwendet werden. Die
  659. xpkmaster.library ist also nicht nötig, um mit Most Texte anzuzeigen.
  660. Ohne sie werden `XPK' gepackte Texte dann natürlich auch nicht
  661. entpackt...
  662.  
  663.  
  664. Pipe Verwendung
  665. ****************
  666.  
  667.    Neuerdings unterstützt Most auch Pipes. Diese Option ist aber immer
  668. noch wenig getest. Bitte meldet mir alle Fehler.
  669.  
  670.    Wurde Most zum Beispiel mit
  671.      type xyz | Most
  672.    gestartet, dann öffnet es ein Textfenster Namens `<Pipe Inhalt>'
  673. und zeigt den Inhalt der Pipe an. Ist jener kleiner als die
  674. konfigurierte Puffergröße, dann kann ganz normal darin gescrollt
  675. werden (editieren funktioniert aber nicht!). Ist der Puffer zu klein
  676. und scrollt man über den Puffer hinaus, so wird zwar weitergelesen,
  677. ein zurück zum Dateinanfang gibt es jetzt aber nicht mehr. Wie üblich
  678. kann man Most natürlich einen größeren Puffer mitgeben...
  679.  
  680.    Kleine Einschränkungen:
  681.  
  682.    Der Puffer wird mit einer Größe von  BUFLEN / 10 angelegt (wie
  683. soll man einer Pipe entlocken, wieviel sie enthält/enthalten wird?).
  684. Mit der Option PIPELEN kann man explizit die Speichergröße für Pipes
  685. festlegen.
  686.  
  687.    `XPK' aus einer Pipe ist nicht möglich.
  688.  
  689.  
  690. Der ARexx Port
  691. ***************
  692.  
  693.    Neben dem globalen ARexx-Port MOSTPORT (bzw. der durch die Option
  694. PORTNAME angegebene Name) des Hauptprozesses von Most besitzt jedes
  695. Textfenster seinen eigenen ARexx Port. Um einen spezielles Textfenster
  696. anzusprechen, sendet man an den globalen ARexx Port zuerst den Befehl
  697. GetFileList, der eine Liste aller geöffneten Texte und deren Portnamen
  698. zurückgibt. Anhand jener Liste kann dann das gewünschte Fenster direkt
  699. addressiert werden. Während man an die Ports der einzelnen Fenster
  700. *alle* Arexx-Befehle senden kann, "versteht" der Hauptport nur die
  701. ersten 6 Befehle GetFileList, GetScreenName, Quit, OpenNew, Set und
  702. Request.
  703.  
  704.    Most setzt in RC eine Fehlernummer von
  705.    *    0, wenn der Befehl korrekt ausgeführt wurde.
  706.  
  707.    *    5, wenn Open oder OpenNew fehlschlugen
  708.  
  709.    *    10, bei Fehlern in den Parametern zu einem Befehl.
  710.  
  711.    *    20, falls ein unbekanntes Befehlswort gesendet wurde.
  712.  
  713.    Folgende ARexx Befehle werden unterstützt:
  714.  
  715.  
  716. GetFileList
  717. ============
  718.  
  719. Aufruf
  720.      GetFileList
  721.  
  722. Resultat
  723.      In RESULT wird eine Liste aller vorhandenen Textfenster und ihrer
  724.      Portnamen zurückgegeben. RESULT hat den Aufbau: {<Fenstername>
  725.      <Portname> }^+ (das heißt mindestens einmal aber beliebig viele)
  726.  
  727. Beispiel
  728.              GetFileList
  729.              RESULT: "Most.dok MOST.0 Most.doc MOST.1"
  730.  
  731.  
  732. GetScreenName
  733. ==============
  734.  
  735. Aufruf
  736.      GetScreenName
  737.  
  738. Resultat
  739.      RESULT enthält den Schirmnamen
  740.  
  741. Wirkung
  742.      Liefert den Namen des Bildschirms, auf dem Most den aktuellen Text
  743.      darstellt.
  744.  
  745. Beispiel
  746.              GetScreenName
  747.              RESULT - "Workbench"
  748.  
  749.  
  750. Quit
  751. =====
  752.  
  753. Aufruf
  754.      Quit
  755.  
  756. Wirkung
  757.      Beendet Most und schließt *alle* Fenster. Das AppIcon von Most   
  758.      wird auch entfernt -- sofern vorhanden.
  759.  
  760. Beispiel
  761.              Quit
  762.  
  763.  
  764. Request
  765. ========
  766.  
  767. Aufruf
  768.      Request TITLE/K/A TEXT/K/A GADGETS/K/A
  769.  
  770. Resultat
  771.      RESULT enthält Nummer des gedrückten Gadgets:
  772.  
  773.     0
  774.           das am weitesten rechts (meist Abbrechen)
  775.  
  776.     1 bis n-1
  777.           die restlichen von links durchnummeriert
  778.  
  779. Wirkung
  780.      Eine einfache Möglichkeit einer Benutzerabfrage per Dialogfenster.
  781.      Titel und Text sind einfache Strings. Mit GADGETS werden die Texte
  782.      der Gadgets angegeben, durch '|' getrennt.
  783.  
  784. Beispiel
  785.              Request TITLE "Test" TEXT "Klaro?" GADGETS "JA|Nein"
  786.              RESULT - 1 wenn JA gewählt wurde, sonst 0
  787.  
  788.  
  789. Set
  790. ====
  791.  
  792. Aufruf
  793.      Set CASE/S WORD/S BACK/S
  794.  
  795. Wirkung
  796.      Durch das Angeben eines der Schlüsselworte wird die entsprechende
  797.      Option angeschaltet, während die Optionen, die nicht angegeben
  798.      wurden, implizit ausgeschaltet werden. Die Parameter bedeuten
  799.  
  800.     CASE
  801.           casesensitives Suchen an
  802.  
  803.     WORD
  804.           wortweises Suchen an
  805.  
  806.     BACK
  807.           Rückwärtssuchen an
  808.  
  809. Beispiel
  810.              Set WORD ON
  811.              Das wortweise Suchen wird an-, die anderen beiden Suchoptionen ausgeschaltet.
  812.  
  813.  
  814. OpenNew
  815. ========
  816.  
  817. Aufruf
  818.      OpenNew FILE/K
  819.  
  820. Wirkung
  821.      In ein eigene Fenster einen neuen Text laden. Die Angabe eines
  822.      Dateinamens ist optional. Wird er weggelassen, so wird ein
  823.      Dateiauswahlfenster geöffnet.
  824.  
  825.      Es braucht vorher kein aktuelles Fenster gewählt worden sein. Das
  826.      Kommando kehrt erst zurück, wenn der Text beendet wurde!
  827.  
  828. Beispiel
  829.              OpenNew FILE Most.dok
  830.  
  831.  
  832. Open
  833. =====
  834.  
  835. Aufruf
  836.      Open FILE/K
  837.  
  838. Wirkung
  839.      In das aktuelle Fenster eine neue Datei einladen. Die Angabe eines
  840.      Dateinamens ist optional. Wird er weggelassen, so wird ein
  841.      Dateiauswahlfenster geöffnet. Das Kommando kehrt erst zurück,
  842.      wenn der Text beendet wurde!
  843.  
  844. Beispiel
  845.              Open FILE Most.dok
  846.  
  847.  
  848. Close
  849. ======
  850.  
  851. Aufruf
  852.      Close
  853.  
  854. Wirkung
  855.      Schließt das aktuelle Fenster.
  856.  
  857.  
  858. ToFront
  859. ========
  860.  
  861. Aufruf
  862.      ToFront
  863.  
  864. Wirkung
  865.      Holt das aktuelle Fenster nach vorne, so daß es vollständig
  866.      sichtbar wird. Dazu wird auch der Bildschirm, auf dem sich das
  867.      Fenster befindet, nach vorne geholt und aktiviert.
  868.  
  869.  
  870. GetWindowDims
  871. ==============
  872.  
  873. Aufruf
  874.      GetWindowDims
  875.  
  876. Resultat
  877.      In RESULT steht `<xpos> <ypos> <breite> <höhe>'
  878.  
  879. Wirkung
  880.      Liefert die Ausmaße des akt. Fensters in RESULT
  881.  
  882. Beispiel
  883.              GetWindowDims
  884.              RESULT - "40 40 600 180"
  885.  
  886.  
  887. Edit
  888. =====
  889.  
  890. Aufruf
  891.      Edit
  892.  
  893. Wirkung
  894.      Editieren des Textes des aktuellen Fensters  (Editor starten).
  895.  
  896.  
  897. Info
  898. =====
  899.  
  900. Aufruf
  901.      Info
  902.  
  903. Wirkung
  904.      Öffnet das Informationsfenster zum aktuellen Text.
  905.  
  906.  
  907. FirstPage
  908. ==========
  909.  
  910. Aufruf
  911.      FirstPage
  912.  
  913. Wirkung
  914.      Die erste Seite des Textes anzeigen
  915.  
  916.  
  917. LastPage
  918. =========
  919.  
  920. Aufruf
  921.      LastPage
  922.  
  923. Wirkung
  924.      Die letzte Seite des Textes anzeigen.
  925.  
  926.  
  927. NextPage
  928. =========
  929.  
  930. Aufruf
  931.      NextPage
  932.  
  933. Wirkung
  934.      Nächste Seite des aktuellen Textes anzeigen.
  935.  
  936.  
  937. PrevPage
  938. =========
  939.  
  940. Aufruf
  941.      PrevPage
  942.  
  943. Wirkung
  944.      Springt zur vorherigen Seite im Text.
  945.  
  946.  
  947. NextLine
  948. =========
  949.  
  950. Aufruf
  951.      NextLine
  952.  
  953. Wirkung
  954.      Eine Zeile weiterscrollen
  955.  
  956.  
  957. PrevLine
  958. =========
  959.  
  960. Aufruf
  961.      PrevLine
  962.  
  963. Wirkung
  964.      Eine Zeile zurückscrollen
  965.  
  966.  
  967. NextColumn
  968. ===========
  969.  
  970. Aufruf
  971.      NextColumn
  972.  
  973. Wirkung
  974.      Eine Spalte nach rechts scrollen
  975.  
  976.  
  977. PrevColumn
  978. ===========
  979.  
  980. Aufruf
  981.      PrevColumn
  982.  
  983. Wirkung
  984.      Eine Spalte nach links scrollen (bis maximal zum Textanfang)
  985.  
  986.  
  987. NextTab
  988. ========
  989.  
  990. Aufruf
  991.      NextTab
  992.  
  993. Wirkung
  994.      Um 8 Spalten nach rechts scrollen
  995.  
  996.  
  997. PrevTab
  998. ========
  999.  
  1000. Aufruf
  1001.      PrevTab
  1002.  
  1003. Wirkung
  1004.      Um 8 Spalten nach links scrollen (bis maximal zum Textanfang)
  1005.  
  1006.  
  1007. Goto
  1008. =====
  1009.  
  1010. Aufruf
  1011.      Goto LINE/K/N/A COLUMN/K/N
  1012.  
  1013. Wirkung
  1014.      Als Argument *muß* eine Zeile und optional kann die Startspalte  
  1015.       angegeben werden. Die Zeilennummer wird als neuer Seitenbeginn
  1016.      genommen.
  1017.  
  1018. Beispiel
  1019.              Goto LINE 142
  1020.  
  1021.  
  1022. Search
  1023. =======
  1024.  
  1025. Aufruf
  1026.      Search TEXT/K
  1027.  
  1028. Wirkung
  1029.      Ohne Argument: Das Suchfenster öffnen, bzw. bereits eingegebenen
  1030.      Text weitersuchen
  1031.  
  1032.      Mit Suchbegriff: Als neuen Suchbegriff einsetzen und suchen.
  1033.  
  1034. Beispiel
  1035.              Search TEXT huhu
  1036.  
  1037.  
  1038. Bekannte Fehler
  1039. ****************
  1040.  
  1041.    - Verschiedene Kontrollsequenzen zum Setzen des Cursors sorgen für
  1042.      Chaos in der Anzeige.
  1043.  
  1044.  
  1045. Kritiken - Ideen
  1046. *****************
  1047.  
  1048.    Most ist noch nicht ganz fertig. Es gibt ein paar Ecken und Kanten,
  1049. die ich noch abschleifen will. Der ARexx Port ist noch unvollständig
  1050. und die Einstellungen will ich noch teilweise mit Dialogfenstern
  1051. versehen (zum Beispiel für den Zeichensatz). Außerdem weicht Most
  1052. (also ich) in einigen Stellen von den Richtlinien des Style Guides ab:
  1053.  
  1054.    -    Keine Paste Option obwohl Copy möglich ist
  1055.  
  1056.    -    Menüstruktur
  1057.  
  1058.    -    keine Tastenbefehle mit `CTRL' oder `ALT'
  1059.  
  1060.    -    Speicherung der Einstellungen als pseudo Kommandozeile
  1061.  
  1062.    Ich bin sehr an Anregungen und auch jeglicher Kritik und Bugreports
  1063. interessiert! Schreibt mir, ruft mich an oder kommt vorbei, nur teilt
  1064. es mit mit :-)
  1065.  
  1066.    Meine Adresse:
  1067.         Uwe Röhm
  1068.         Wörthstr. 18
  1069.         8390 Passau
  1070.  
  1071.    EMail:
  1072.         bugs@roemer.adsp.sub.org
  1073.  
  1074.    Fido:
  1075.         2:246/200.5
  1076.  
  1077.  
  1078. aktuelle Version
  1079. *****************
  1080.  
  1081.    Die aktuellste Most Version ist immer per ftp auf `ftp.uni-passau.de'
  1082. (132.231.1.10) in  `pub/amiga/local/UweR'  zu beziehen. Tip: In dem
  1083. Verzeichnis `pub/amiga/local' liegen noch ganz andere interessante
  1084. Programme :-)
  1085.  
  1086.    Ich werde versuchen, die aktuellen Releases immer auf AmiNet
  1087. hochzuspielen.
  1088.  
  1089.  
  1090. Danksagungen
  1091. *************
  1092.  
  1093.    Besonderen Dank an meine Betatester
  1094.  
  1095.        David, Uli, Holger, Stefan und Stefan ;-)
  1096.        sowie Karl, den Unermütlichen
  1097.  
  1098.    Außerdem ein Dankeschön an Urban für seine Mühe und `XPK'. Und
  1099. natürlich ein herzliches Dankeschön an alle, die mir Bugreports und
  1100. Vorschläge geschickt haben, allen voran Tron!
  1101.  
  1102.  
  1103. Index
  1104. ******
  1105.  
  1106.  
  1107.  
  1108.  XPK                                    XPK Schnittstelle
  1109.  AINSI Sequencen                        Prinzip
  1110.  aktuelle Version                       aktuelle Version
  1111.  AmigaGuide                             Hilfe
  1112.  Anregungen                             Kritiken - Ideen
  1113.  AppIcon                                Das AppIcon
  1114.  AppWindow                              Das Textfenster
  1115.  ARexx                                  Der ARexx Port
  1116.  Aufruf von Most                        Konfiguration
  1117.  Autor                                  Kritiken - Ideen
  1118.  Bewegen                                Bewegen
  1119.  Copyright                              Copyright
  1120.  Danksagungen                           Danksagungen
  1121.  Editieren                              Editieren
  1122.  Einstellungen                          Einstellungen
  1123.  Environment Variablen                  Konfiguration
  1124.  Extras                                 Extras
  1125.  Fehler                                 Bekannte Fehler
  1126.  Fenster                                Das Textfenster
  1127.  Fensterverwaltung                      Prinzip
  1128.  gepackte Dateien                       XPK Schnittstelle
  1129.  Giftware                               Copyright
  1130.  Hilfe                                  Hilfe
  1131.  Ideen                                  Kritiken - Ideen
  1132.  Includedateien anspringen              Das Textfenster
  1133.  Informationsfenster                    Informationsfenster
  1134.  Konfiguration                          Konfiguration
  1135.  Kritik                                 Kritiken - Ideen
  1136.  Makros                                 Extras
  1137.  Markieren                              Das Textfenster
  1138.  Maussteuerung                          Das Textfenster
  1139.  Menus                                  Menus
  1140.  Merkmale                               Konfiguration
  1141.  Paging                                 Prinzip
  1142.  Parameter                              Konfiguration
  1143.  Pipe Verwendung                        Pipe Verwendung
  1144.  Prinzip                                Prinzip
  1145.  Projekt                                Projekt
  1146.  Prozeße                               Prinzip
  1147.  Shell Aufruf                           Konfiguration
  1148.  Skripte                                Der ARexx Port
  1149.  Speicherverwaltung                     Prinzip
  1150.  Suchbefehle                            Suchbefehle
  1151.  Suchen                                 Suchen
  1152.  Suchen                                 Das Suchfenster
  1153.  Suchfenster                            Das Suchfenster
  1154.  Symbole                                Das Textfenster
  1155.  Tastenbefehle                          Tastenbefehle
  1156.  Textfenster                            Das Textfenster
  1157.  Titelzeile                             Das Textfenster
  1158.  ToolTypes                              Konfiguration
  1159.  Variablen                              Konfiguration
  1160.  verschlüsselte Dateien                XPK Schnittstelle
  1161.  Vorgabewerte                           Konfiguration
  1162.  Workbench Start                        Konfiguration
  1163.  
  1164.