-----------------------------------------------
A n l e i t u n g   z u   B L I N E X   V 1 . 4
-----------------------------------------------


Umfang
------
Der Ordner BLINEX enthlt folgende Dateien:
  BLINEX.PRG  PRG-Version
  BLINEX.RSC  Resource-Datei hierzu
  BLINEX.TXT  Anleitung

Auf Aufrage ist beim Autor auch die alte TTP-Version sowie eine englische
Version erhltlich


Rechtliches
-----------
Autor: Christoph Bartholme, Ettlinger Strae 37, D-76137 Karlsruhe, Germany
                            EMail: Christoph_Bartholme@ka2.maus.de

BLINEX (Blank LINes EX) ist public domain und darf von jedermann/frau ange-
wendet und weitergegeben werden, jedoch mu stets der komplette Inhalt des
Ordners BLINEX kopiert werden. Krzungen und nderungen verletzen die
Copyright-Bestimmungen!

Der Autor ist nicht verantwortlich fr irgendwelche Schden, welche, wie
auch immer, durch Anwendung von BLINEX entstehen.


Sinn und Zweck
--------------
BLINEX dient zum Bearbeiten von ASCII-Textdateien.

Genauer?

1) BLINEX entfernt berflssige Leerzeilen.

2) BLINEX wandelt  "exotische" Zeilenendekennungen ins gebruchliche Format
(CR LF) oder in andere Kennungen um.

3) BLINEX entfernt auf Wunsch berzhlige Leerzeichen oder Tabulatoren am
Zeilenende.

4) BLINEX kann Texte beliebig zwischen den vier gebruchlichsten ASCII-
Zeichenstzen konvertieren oder in 7-Bit- oder LaTeX-Code wandeln.

Ein Beispiel zu Punkt 1):
Oft werden Anleitungen mit Leerzeilen so "gestreckt", da beim
Standard-Ausdruck (60 Zeilen pro Seite) die Seitenaufteilung nach
Vorstellung des Autors erfolgt. Wenn man nun aber solch einen Text mit
einer kleineren Schriftgre und daher einem kleineren Zeilenabstand
ausdruckt, sind diese Leerzonen berflssig, ja lstig.

Manchmal bentigt man auch beim Ausdrucken allein fr die letzte
Zeile(n) des Textes eine Extraseite, was durch den Verzicht auf
einige Leerzeilen verhindert werden kann.

  ************************************************************************
  *   ACHTUNG: Anleitungen und README-Dateien von PD- oder Shareware-    *
  *   Programmen drfen nur U N V E R  N D E R T weitergegeben werden!  *
  *       Modifikationen sind einzig zum eigenen Gebrauch erlaubt!       *
  ************************************************************************


Voraussetzungen
---------------
Blinex luft unter jeder Auflsung auf dem ST(E), Mega-ST(E), TT und Falcon.
In den niedrigsten Auflsungen (St-Low, TT-Low) knnen Fenster und Dialog-
boxen nicht komplett dargestellt werden.


Start
-----
Die Datei BLINEX.RSC mu sich auf gleicher Verzeichnisebene (Ordner)
befinden wie BLINEX.PRG. BLINEX kann auch als Anwendung auf eine bestimmte
Dateiart angemeldet werden. Bei lteren TOS-Versionen (1.0x) empfiehlt sich
hierbei der Einsatz des PD-Tools ALIBI. Ab TOS 2.0x, unter Gemini oder
hnlichen alternativen Desktops gengt es, wenn eine entsprechende Datei
mit der Maus auf das Icon von BLINEX gezogen wird.


Bedienung
---------
BLINEX besitzt eine Menzeile, ber welche die Accessories, eine kleine
Programminformation und ein Menpunkt zum Beenden zugnglich sind. Die
Bedienelemente des Programms befinden sich in einem Fenster, das frei
verschiebbar ist.

Mit dem Button "Textdatei..." wird die Arbeitsdatei bestimmt. Es erscheint
eine Fileselektbox, mit der Sie die gewnschte Datei auswhlen knnen.

"Hilfe" bringt eine kleine Gedchtnissttze fr die Optionen.

"INF sichern" erzeugt eine Datei BLINEX.INF, in der alle Einstellungen und
der Zugriffspfad der Arbeitsdatei abgelegt werden. Beim nchsten
Programmstart werden diese Parameter dann aus BLINEX.INF gelesen und
automatisch gesetzt.

Nach Anklicken von "Start" ldt BLINEX die gewhlte Arbeitsdatei und
speichert sie nach entsprechender Umformung wieder ab. Die Textformatierung
geschieht dabei vollstndig im Hintergrund. Sie knnen also whrenddessen zu
einem Accessory wechseln oder (unter MultiTOS, Mag!X o..) ein Programm
parallel ausfhren.

"Statistik" zeigt ein paar Informationen zur bearbeiteten Textdatei, nmlich
die Zeilenanzahl davor und danach sowie die Anzahl der entfernten Leerzeilen
und optimierten Zeilenenden.

Nach getaner Arbeit knnen Sie mit "-> IdeaList" die bearbeitete Textdatei
direkt an das Druckprogramm IdeaList bergeben, sofern ILIST.ACC installiert
ist oder IDEALIST.PRG parallel gestartet wurde.


Optionen
--------
"Zeilenenden optimieren": Blinex entfernt Leerzeichen und Tabulatorzeichen
(ASCII 9) am Zeilenende und spart so im Endeffekt einige Bytes ein. Beachten
Sie bitte, da Leerzeichen am Zeilenende manchmal durchaus sinnvoll (zur
weiteren Bearbeitung mit einem Texteditor) oder gar zwingend ntig
(DESKTOP.INF und NEWDESK.INF niemals optimieren!) sind.

"Backup anlegen": Die Arbeitsdatei wird vor der Bearbeitung als Backup mit
dem Extender "BAK" gesichert.

"Zeichen 1 - 31 filtern": Die Zeichen unterhalb des Leerzeichens sind von
System zu System verschieden definiert und dienen vor allem als
Druckersteuerzeichen, die in echten ASCII-Dateien eigentlich nichts zu tun
haben. Mit dieser Option werden solche Zeichen einfach ignoriert.
Ausnahmen:
- "CR" und "LF" werden natrlich als als Zeilenendemarkierung interpretiert.
- "Tab" wird in ein einzelnes Leerzeichen gewandelt.
- "Esc" wird zusammen mit dem nachfolgenden Zeichen ignoriert.
- "Backspace" wird zusammen mit dem nachfolgenden oder vorhergehenden
 Zeichen entfernt, je nachdem, um welches es sich dabei handelt. So werden
 nroff-Formatierungen in normale ASCII-Form gebracht.
 Beispiele: ("/" steht  fr Backspace = ASCII 8)): Aus "F/Fe/et/t" wird
 "Fett", aus "U/_n/_t/_e/_r/_" oder "_/U/_n/_t/_e/_r" wird "Unter".

BLINEX kennt vier Modi fr die Entfernung von Leerzeilen:

  - Keine Leerzeilen stehen lassen: der radikalste Modus, der die Gliede-
   rung des Textes ziemlich zerstrt.

  - Einfache Leerzeilen stehen lassen: Mehrfache Leerzeilen werden bis auf
   eine gelscht.

  - Einfache und doppelte Leerzeilen stehen lassen: Grere Leerzeilen-
   Bereiche werden bis auf zwei Leerzeilen entfernt. Bei diesem Modus bleibt
   die Gliederung des Textes weitgehend erhalten.

  - Alle Leerzeilen stehe lassen: Falls Sie nur die Zeilenende-Kennungen
   ndern oder die Zeilenenden subern wollen...


Zeilenenden
-----------
BLINEX erkennt automatisch diverse Arten von Zeilenende-Kennungen:
(CR = ASCII 13, LF = ASCII 10)
  - CR LF    (Standard fr Atari und DOS)
  - LF CR
  - CR       (Mac-Format)
  - LF       (Unix-Format)
  - CR CR LF (Absatzkennung im Tempus-Flietextformat)
  - Nullbyte (z.B. Textbereiche, die Binrdateien entnommen wurden)

Die Ausgabe erfolgt wahlweise als
  - CR LF
  - CR
  - LF
  - Nullbyte


Was gilt als Leerzeile?
-----------------------
Eine Leerzeile enthlt entweder kein Zeichen oder nur die Zeichen ASCII-32
(Blank), ASCII-9 (Tabulator) oder ASCII-12 (Formfeed).


Zeichensatz-Konvertierung
-------------------------
ASCII ist nicht gleich ASCII! Nicht nur die Zeilenendekennung kann von
System zu System unterschiedlich sein. Auch der Zeichensatz ist nicht auf
allen Rechnerplattformen einheitlich! Whrend die Zeichen von ASCII-32 bis
127 genormt sind (Zeichen unter ASCII-32 sind, bis auf diejenigen fr
Zeilen- und Seitensteuerung, gnzlich rechnerspezifisch und haben sowieso
nichts in ASCII-Texten zu suchen), gibt es bei den oberen 128 Zeichen groe
Unterschiede.

BLINEX kann zwischen vier gelufigen Zeichenstzen umformen (diese also
sowohl lesen als auch schreiben):
  - Atari
  - ANSI (auch Amiga, Archimedes, Windows)
  - Macintosh
  - PC (DOS)

Als fnfte Option kann BLINEX auch im 7-Bit-Code schreiben. Zeichen grer
als ASCII 127 (in Binrschreibweise ist das achte Bit gesetzt) werden (so
gut wie mglich) durch Zeichen aus dem 7-Bit-Bereich dargestellt.
Beispiele:  -> Ae,  -> oe,  -> ss, a mit Akzent -> a

Schlielich gibt es noch die Mglichkeit, die Umlaute, das Eszet und die
franzsischen Doppelquotes so zu wandeln, da der Text anschlieend von
LaTex mit dem german.sty gelesen werden kann.
Beispiele:  -> "A,  -> "o,  -> "s,  -> "<

Wenn Sie keine Konvertierung wnschen, so stellen Sie einfach Lese- und
Schreib-Zeichensatz identisch ein.

Zeichen, die in einem System partout nicht dargestellt werden knnen, werden
als "*" dargestellt. Die PC-Blocksatz-Grafikzeichen werden in "+", "-" und
"|" konvertiert. Nicht schn, aber lesbar...

Die Konvertierung geschieht brigens nicht ber den Umweg des Atari-
Zeichensatzes, sondern BLINEX verwendet fr jede Kombination zweier
Zeichenstze eine eigene Tabelle.


nderungen
----------
V1.42:
- Entfernen von "Backspace" bei Option "Zeichen 1-31 filtern"

V1.40:
- Option: 7-Bit-Code schreiben
- Option: LaTeX-Code schreiben
- Option: Zeichen 1 - 31 filtern
- Statistikanzeige

V1.33:
- Bugfix bei Hintergrundbedienung unter Mag!X und MultiTOS

V1.32:
- Balkenanzeige whrend der Umwandlung
- Bugfix bei der Konvertiertabelle Atari-Mac

V1.30:
- Zeichensatz-Konvertierung zwischen den Systemen Atari, ANSI, Mac und PC

V1.20:
- Option: Zeilenenden optimieren
- Option: keine Leerzeilen entfernen
- Textformatierung im Hintergrund
- Erzeugte Zeilenende-Kennungen whlbar
- Als Zeilenendekennung wird auch das Nullbyte (ASCII 0) erkannt
- Resourceverwaltung gendert
- Kommandozeilenbehandlung gendert

V1.14:
- Einlese-Fehler entfernt
- Anpassungen an MultiTOS und TOS 4.0x

V1.10: Erste Version mit GEM-Oberflche













Preisfrage
----------
Warum ist diese Zeile so weit nach unten gerutscht?        Viel Spa!    :-)
----------------------------------------------------------------------------