------------------------
Anleitung zu Blinex V1.6
------------------------


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 und
franzsische Version erhltlich


Rechtliches
-----------
Autor: Christoph Bartholme, Dietrichstrae 9, D-76227 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.

5) Blinex kann Tabulatoren in Leerzeichen expandieren.

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.


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!C 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 ILIST.PRG 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.

"Tabs  expandieren":  Tabulatorzeichen  (ASCII 9) werden, je nach Position in
der Zeile und angegebenem Wert, in Leerzeichen gewandelt.

"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 8s): Aus "F/Fe/et/t" wird
 "Fett", aus "U/_n/_t/_e/_r/_" oder "_/U/_n/_t/_e/_r" wird "Unter".

Blinex kennt fnf 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.

  - Einfache  bis  dreifache  Leerzeilen stehen lassen: wie zuvor, nur werden
   auch dreifache Leerzeilen unverndert gelassen.

  - Alle  Leerzeilen  stehen  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.


Batchmodus
----------
Blinex  kennt  einen  Batchmodus,  in  dem  es  die  beim  Start  bergebenen
Textdateien der Reihe nach konvertiert und danach endet.
Der   Batchmodus   wird   aktiviert,  indem  entweder  beim  Start  eine  der
Shift-Tasten gedrckt wird oder in der Kommandozeile der Parameter "-B" (ohne
Anfhrungszeichen) angegeben wird. Wenn Sie einen Desktop verwenden, der ARGV
untersttzt,  etwa  Gemini, knnen Sie Blinex mit beliebig vielen Textdateien
aufrufen;  einfach  durch  Ziehen  der  Icons auf das Blinex-Icon und Drcken
einer Shift-Taste.


nderungen
----------
V1.60:
- Batchmodus
- Option: Tabs expandieren

V1.51:
- kleine interne nderungen

V1.50:
- Popupmens
- Option: einfache bis dreifache Leerzeilen stehen lassen

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