-----------------------------------------------
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 und "Esc" 
wird zusammen mit dem nachfolgenden Zeichen ignoriert.

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.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!    :-)
----------------------------------------------------------------------------
