
KOLUMBUS   Helpdatei FI.HLP      V2.20 (c) 1989-1994 J.Otte
---------------------------------------------------------------------

Kurzbeschreibung der Control Keys im File Menü :
----------
^N    - Erzeugen eines Editorfensters ohne Inhalt (new) .

^V    - Laden  einer  Datei  in  den Editor. Sie kann nicht verändert
        werden.
^S    - Abspeichern des obersten Fensters (save) .
^E    - Export des obersten Fensters in fenster,Clipboard oder Datei.

Q    - Zunächst  Abspeichern  aller  Fenster. Dann wird das Programm
        mit Returncode=1 beendet.

^Q    - Beenden  des  Editors  ohne  die geänderten Fensterinhalte zu
        sichern. Es erfolgt jedoch für jedes geänderte Fenster vorher
        eine Sicherheitsabfrage.


Ausfürliche Beschreibung des File Menü :
----------
New         ^N - Mit  'New'  wird  ein  Editorfenster ohne Inhalt er-
                 zeugt.  Das erzeugte Fenster kann mit 'Save As' spä-
                 ter  gesichert  werden.  Diese Funktion ist auch von
                 der Tastatur mit ^N erreichbar.

                 Ein   derart  geöffnetes  Fensters  kann  auch  her-
                 vorragend  für  ein  Kopier-  oder Move- Puffer ver-
                 wendet  werden.  Als  Pfadname wird der Pfadname des
                 zuletzt  aktiven  Fensters  verwendet. Der Dateiname
                 wird mit NONAME voreingestellt.


Open           - Mit  'Open' wird eine vorhandene Datei in den Editor
                 geladen.  Die  Datei  kann mit 'Save' unter gleichem
                 Namen  oder  mit  'Save  As' unter neuen Namen abge-
                 speichert werden.


View...     ^V - Mit  'View' wird eine vorhandene Datei in den Editor
                 geladen.  Im  Unterschied  zu  'Load' kann sie nicht
                 verändert werden. Ein Viewfenster ist durch die
                 Infozeile "Read Only" erkennbar.


Import...      - Dieser  Menüpunkt  ist  dafür  gedacht,  Dateien von
                 fremden  Text-  und/oder  fremden Rechnersystemen in
                 den  KOLUMBUS Editor einzulesen. Dabei kann optional
                 eine Filtertabelle verwendet werden.

                 Neu in V2.11: Ab dieser Version erkennt KOLUMBUS
                 automatisch, wenn de Zeilenendekennung nicht der Norm
                 entspricht. CR,und LF werden nun automatisch in CRLF
                 umgewandelt. Fuer diesen Zweck kann also jetzt die
                 Filtertabelle entfallen.

                 Es  erscheint  eine Dialogbox mit folgenden Wahlmög-
                 lichkeiten:


                 merge : Die  zu  importierende  Datei  wird  vor der
                         Cursorzeile eingefügt. Bei Binärdateien wird
                         dieses  Flag allerdings ignoriert, d.h. hier
                         wird  immer  ein  neues Fenster zum Einlesen
                         geöffnet


             use filter: Es  soll  eine  Filtertabelle zum Import be-
                         nutzt werden.


                 File..: Es  erscheint  eine Dateiauswahlbox. Hiermit
                         wird die zu importierende Datei selektiert.


          Binary File..: Hiermit  können  Dateien, die Nullbytes ent-
                         halten,  eingelesen und editiert werden. Die
                         Nullen  werden durch '\0' auf dem Bildschirm
                         dargestellt. Ein '\' wird durch '\\' auf dem
                         Bildschirm dargestellt.
                         Bei Binaerdateien kann kein Filter verwendet
                         werden.

              Clipboard: Hiermit  wird  die Datei scrap.txt vom Clip-
                         board eingelesen.


                 Standartmä₧ig  wird  beim  Import  kein  Filter ver-
                 wendet,d.h.  die  Datei wird unverändert eingelesen.
                 Mit der bereits erwähnten Ausnahme bei Binärdateien.
                 Hier  werden  Nullen  durch  '\0' und '\' durch '\\'
                 ersetzt.   Beim  Abspeichern  werden  diese  Zeichen
                 automatisch wieder rückverwandelt.

                 Aber Achtung :

                 Beim Editieren einer Binärdatei mu₧ beachtet werden,
                 da₧  '\\'  bzw.  '\0' immer als ein einziges Zeichen
                 anzusehen  sind  und  gegebenfalls immer beide geän-
                 dert,gelöscht  oder  einzufügen  sind  !!!! KOLUMBUS
                 macht diesbezüglich keine Plausichecks.

                 Verwendung einer Filtertabelle:

                 Es mu₧ die option "use filter" selektiert werden.

                 Mit einer Filtertabelle kann jedes gelesenes Zeichen
                 durch  einen  beliebigen  String  ersetzt werden. Zu
                 diesem  Zweck  wird zunächst ein 'Importfenster' ge-
                 öffnet.

                 Beispiel eines Importfensters:

                 Beim  Einlesen  sollen alle "Ä" und "ä" in "Ae" bzw.
                 "ae"  umgewandelt  werden:  Der  folgende Dreizeiler
                 zeigt den Inhalt des zugehöhrige 'Importfensters':

                 .import
                 ä=ae
                 Ä=Ae

                 Das  Zeichen  '#' dient als Einleitung einer Kommen-
                 tarzeile im Importfenster. Soll dieses Zeichen umge-
                 wandelt  werden so wird das folgenderma₧en geschrie-
                 ben:

                 .import
                 \#=▌

                 In  diesem  Fall  wird  also # durch ▌ ersetzt. Alle
                 Zeichen  des  Ersatzstring  können  auch zweistellig
                 hexadezimal  angegeben  werden  in dem ebenfalls ein
                 'backslash' vorangestellt wird. Beispiel:

                 .import
                 ö=\6F\65
                 Ö=\4F\65

                 Hiemit wird ö in oe und Ö in Oe umgewandelt.


Save        ^S - Mit  'Save'  wird eine geladene Datei unter gleichem
                 Namen auf Platte zurückgeschrieben. Die Funktion ist
                 auch  von  der Tastatur mit ^S erreichbar. Wurde das
                 Fenster mit ^N aufgemacht, so wird der Fensterinhalt
                 unter dem Namen "NONAME" abgespeichert.


Save As...     - Mit  'Save  As' wird das oberste Fenster unter neuen
                 Namen  abgespeichert.  es öffnet sich eine Dateiaus-
                 wahlbox in der der veränderte Name eingetragen wird.
                 Das Fenster erhält anschliessend den Namen der
                 neuen Datei.
                 Wenn ein Zeilenblock im Fenster selektiert ist
                 ändert sich das Verhalten wie folgt:
                 Es werden nur die selektierten Zeilen geschrieben.
                 Der Fenstername bleibt unverändert.

Abandon        - Die Datei im obersten Fenster wird neu geladen, d.h.
                 alle Änderungen werden somit rückgängig gemacht.

Export      ^E - Diese  Funktion  ist  das  Gegenstück  zur  Funktion
                 "Import".  Allerdings  wird  hier  auch  ohne Angabe
                 einer   Filterfunktion   bereits  standartmä₧ig  ein
                 Defaultfilter   verwendet,  das  sich  jedoch  durch
                 vorgabe eines eigenen Filters umdefinieren lä₧t.

                 Es   erscheint  eine  Dialogbox  mit  den  folgenden
                 Funtionen:


                 selected : Nur  die selektierten Zeilen des obersten
                            Fensters werden exportiert.

               use filter : Es soll ein eigenes Exportfilter verwendet
                            werden.  Es mu₧ dann zwingend ein "Export-
                            fenster" geöffnet sein.

                  Printer : Das  oberste Fenster wird auf den Drucker
                            ausgegeben.  Das  Kontrollzeichen für den
                            Pseudotrenner  (Alt/Ctrl'-')  wird unter-
                            drückt  bzw.  am Zeilenende wird es durch
                            '-'  ersetzt. Alle anderen Kontroll- oder
                            Steuerzeichen    (Druckersteuersequenzen)
                            bleiben  erhalten.  Alternativ  dazu kann
                            ein   eigenes   Exportfenster   definiert
                            werden.


                  File... : Das  oberste  Fenster  wird in eine Datei
                            exportiert  (geschrieben).  Dabei  werden
                            alle   Kontrollzeichen   unterdrückt.  Am
                            Zeilenende  wird  das  Pseudotrennzeichen
                            durch '-' ersetzt.

                            Alternativ kann ein eigenes Exportfenster
                            definiert werden.


                   Window : Das  oberste  Fenster  wird  in ein neues
                            Fenster   exportiert.  Das  neue  Fenster
                            bekommt  den  Namen "Export Window". Soll
                            dieses    "Export   Window"   als   Datei
                            abgespeichert  werden so geht das nur mit
                            "Save  As...".  Die  Behandlung  der Kon-
                            trollzeichen erfolgt wie unter 'File...'.

                            Alternativ kann ein eigenes Exportfenster
                            definiert werden.

                Clipboard : Export  wie  unter File..., nur dass hier
                            Dateiname  (scrap.txt)  und Pfad fest auf
                            das Clipboard zeigen.

                 Anmerkung:  Der Menupunkt 'Export' ersetzt den alten
                 Menupunkt  'Print'  aus  KOLUMBUS  Version  <= 1.00.
                 Teilbereiche  (oder  auch  alle  Zeilen) einer Datei
                 können  nach  wie  vor  mit  '^p'  gedruckt  werden.
                 Hierbei  erfolgt  grundsätzlich  keine Unterdrückung
                 von Kontrollzeichen.

                 Das  Defaultfilter für die Exortfunktion löscht alle
                 Zeichen  mit  einem  Wert  <  32 au₧er '' (Horizon-
                 taltabulator)  und  ''  (Pseudoblank) (diese werden
                 jeweils durch einem echten Blank ersetzt).

                 Beispiel eines Exportfensters:

                 Beim Datei Speichern sollen alle "Ö" und "₧" in "Öe"
                 bzw.   "ss"   umgewandelt   werden:   Der   folgende
                 Dreizeiler   zeigt   den   Inhalt   des  zugehöhrige
                 'Exportfensters':

                 .export
                 Ö=Oe
                 ₧=ss

                 Der  Aufbau  eines Exportfensters unterscheidet sich
                 zu dem eines Importfensters also nur durch die erste
                 Zeile.

Help           - Mit  'Help' wird diese Datei in ein Fenster geladen.
                 Sie kann nicht verändert werden.

Quit(1)     Q - Mit  'Quit(1)' werden alle veränderten Fenster abge-
                 speichert.  Dann  wird das Programm mit Returnkode=1
                 beendet.   Wurde   KOLUMBUS   von  einer  Shell  her
                 gestartet,    so    kann   diese   daraufhin   einen
                 Compilerlauf starten. Wird KOLUMBUS mit Quit oder ^Q
                 verlassen,  so  beendet  sich  KOLUMBUS  stehts  mit
                 Returncode=0.

                 Diese  Funktion  wird  auch  über  Tastatur  mit  Q
                 erreicht.

                 Anmerkung:  in der Regel wird man einen Compilerlauf
                 nicht  mit ^O sondern ohne Verlassen des Editors mit
                 M   starten.   Durch   M   wird   das   eingebaute
                 Make-Utility   aktiviert.   Dieses  durchsucht  alle
                 offenen  Fenster  nach  einer  Make-Steuerdatei  und
                 führt diese aus. Siehe Menupunkt "Extra.Make".

Quit        ^Q - Mit 'Quit' wird der Editor beendet ohne die geänder-
                 ten  Fenster zu sichern. Es erfolgt jedoch für jedes
                 geänderte Fenster vorher eine Sicherheitsabfrage.

                 Diese  Funktion  wird  auch  über  Tastatur  mit  ^Q
                 erreicht.

