README zu mars_e: 29-Sep-95

mars_'e' ist ein kleiner, einfach zu bedienender Editor in
deutscher Sprache fuer diverse Unix'e, Dos, Windows, OS2.

einige Highlights

- benutzerbezogene Picklisten speichern bis zu 15 Dateien.
- spaltenkopieren
- umschaltbar OEM (IBM) / ANSI Zeichensatz.
- pipefaehig (Pager)
- im ASCII-Modus leichte Terminalanpassung mit oder
  ohne Terminfo/Termcap Unterstuetzung.

unter Linux kann der Editor sowohl als ASCII-Editor
als auch als X11-Editor verwendet werden, abhaengig
vom Setzen der DISPLAY Variablen.

'e' fuer LINUX (bin) ist entsprechend der LINUX-Philosophie Freeware.
Jede Weitergabe von 'e' muss jedoch diese README Datei beinhalten.
====================================================================
* 'e' fuer DOS, Windows, OS2, USL-Unix und diversen anderen UNIX'e *
* ist gegen folgende Gebuehren erhaeltlich.                        *
*                                                                  *
* DOS/WINDOWS-Paket (real, protected, windows)   99,00 DEM         *
* USL-UNIX V4.2     (text+Xwindows)             199,00 DEM         *
* Sinix MX300       (text)                       99,00 DEM         *
*                                                                  *
* fuer OS2 oder diverse andere Unixe auf Anfrage.                  *
*                                                                  *
* M. Stover                 Fax:    +49 6421 93082                 *
* SW-Entwicklung            email:  mstover@Kool.f.EUnet.de        *
* Am Krappen 4                                                     *
* 35037 Marburg                                                    *
====================================================================
Beschreibung der zugehoerigen Dateien.
Beispieldateien im Verzeichnis examples.

'e'           : Executable

falls 'e' umbenannt wird, muessen auch die Zusatzdateien
'e.hlp' u. 'e.cfg' umbenannt werden.

'm_a_r_s.cfg' : generelle-Konfigurationsdatei.  (nicht notwendig)

'e.hlp'       : Hilfedatei.      (sinnvoll, aber nicht notwendig)
'e.cfg'       : Grundkonfiguration des Editors. (nicht notwendig)
'e.fil'       : Konfiguration Lese / Schreibfilter. (nicht notwendig)

'$TERM.tty'   : Terminal Beschreibungsdatei. Wird unter Xwindows
                nicht verwendet und ansonsten beim 1. Start des
                Editors automatisch angelegt.
                im Text-Modus kann die Datei neu aufgebaut bzw.
                veraendert werden durch Starten des Editors
                mit Parameter -I.

generelles zum Datenpfad dieser Dateien.

Damit das Programm auf programmbezogene Dateien
zugreifen kann, muss es den Pfad kennen, wo sich diese
Dateien befinden. Das Programm verwendet folgenden
Algorithmus.

1. Ist die Env-Variable 'DMARSCONF' gesetzt, wird
   der Inhalt dieser Variable als 1. Pfad verwendet.
   Ist die Variable nicht gesetzt, verwendet das
   Programm als 1. Pfad den Programmpfad, d.h. als
   Pfad das Verzeichnis, in dem sich das Programm
   befindet.

2. Das Programm schaut im 1. Pfad nach der
   Datei 'm_a_r_s.cfg', die generelle Konfigurationsdatei.
   Ist diese Datei mit dem entsprechenden Eintrag vorhanden,
   wird das dort hinterlegte Verzeichnis als
   endgueltiger Programmdatenpfad verwendet.

=========================================================================

Probleme   FAQ's
================
Q: Beim Starten von 'e' im ASCII Modus wird Bildschirm 'zerkloppt'.
A: 1. Ist vielleicht Env-Variable LINES bzw. COLUMNS auf zu gross gesetzt.
   2. In der $TERM.tty Datei die Eintraege 300 .. 310 ueberpruefen.

Q: Nur leider klappt die Bildausgabe auf der normalen Terminalebene
   von Linux nur fehlerhaft. Zum Beispiel fehlt der Balken, um sich
   in den Menues nach oben und unten zu bewegen. Auch die sonst fett
   dargestellten Buchstaben der Menues fuer den Kurzaufruf, werden nur
   normal dargestellt. Was mache ich falsch.
A: Je nach terminfo bzw. ncurses Version sind die terminfo
   Eintraege fehlerhaft bzw. unvollstaendig. In diesem Fall
   muss $TERM.tty Datei von Hand geaendert werden. Fuer die wichtigsten
   Bildschirmattribute sind das die Eintraege  261..266, im konkretem
   Fall der Eintrag REVERSE (Balken im Menue) und der Eintrag
   BOLDREVERSE (die sonst fett dargestellten Buchstaben).
   Falls ein Eintrag nicht gefuellt ist, wird Attribut NORM verwendet,
   ausser bei Attribut BOLDREVERSE, dort wird ab V4.08 dann BOLD
   verwendet.
   folgende Eintraege sind ein Beispiel.
   261:  27 "[0;10m"  #NORM
   262:  27 "[1m"     #BOLD
   263:  27 "[7m"     #REVERSE
   264:  27 "[0;1;7m" #BOLDREVERSE
   265:  27 "[4m"     #UNDERLINE
   266:  27 "[5m"     #BLINK

Q: Eine Datei ist immer r/o, obwohl ich vom Betriessystem her die
   Schreibrechte babe.
A: Da gibt es folgende Moeglichkeiten.
   1. Die Datei kann nicht gelockt werden.
      Vielleicht auf anderem Bildschirm in Bearbeitung.

   2. Die Datei ist in der Pickliste durch ein
      vorheriges r/o Oeffnen als r/o gekennzeichnet.
      e mit -l starten und die Datei mit der <F5> Taste
      von r/o nach r/w toggeln oder e mit -w starten.
=========================================================================

Mailinglist
===========

Beitreten zur Mailing-List:
email an "mars_e-request@Kool.f.EUnet.de"
mit dem Subject "subscribe"

Verlassen der Mailing-List:
email an "mars_e-request@Kool.f.EUnet.de"
mit dem Subject "unsubscribe"

Posting's an die Mailing-List:
email an "mars_e@Kool.f.EUnet.de"

Fuer Anregungen und Kritik bitte email an Mailinglist
mars_e@Kool.f.EUnet.de

Viel Spass mit mars_'e'.

Martin Stover
(mstover@Kool.f.EUnet.de)


Bedanken moechte ich vor allen bei
  akool@Kool.f.EUnet.de (Andreas Kool)
Er hat mir viele Anregungen gegeben und 'e' immer wieder
_gnadenlos_ getestet. Ausserdem machte er mir das Internet
schmackhaft und half mir bei der Distribution von 'e' auf
demselbigen.





