        ***************************************************
        *                                                 *
        *    Bedienungsanleitung zu Parchi Version 3.00   *
        *           (c) Frank Heyne 1994 - 1995           *
        *                                                 *
        ***************************************************


                           Inhalt
                           ~~~~~~
          1. Vorwort
          2. Zweck des Programmes
          3. Voraussetzungen fr Parchi
          4. Der erste Start von Parchi
          5. Temporre Dateien
          6. Aufstellung der benutzten Funktionstasten
          7. Die Zwischenablagen
          8. Markierungen der Archiv-Eintrge
          9. Extrahieren von Eintrgen
         10. Bestimmungen zum Vertrieb
         11. Garantie und Haftung


1. Vorwort
~~~~~~~~~~
Obwohl mir das Programmieren wesentlich mehr Spa macht als das Erstellen
einer Programmbeschreibung, versuche ich hier mal, die Eigenschaften von
Parchi kurz zusammenzufassen. Dem fhigen Benutzer wird vielleicht auch der
zu jedem Menpunkt in der Statuszeile erscheinende Hilfetext gengen, aber
dessen Lnge ist begrenzt und hier gibt es etwas mehr Informationen.
Sollte jemand in diesem Dokument (oder im Programm) wichtige Eigenschaften
vermissen oder Fehler entdecken, so bitte ich um Mitteilung.


2. Zweck des Programmes
~~~~~~~~~~~~~~~~~~~~~~~
 Tglich werden in den verschiedensten Pascal-Brettern (oder -Newsgroups)
Sourcen von allgemeinem Interesse gepostet, die meistens sogar
funktionieren. Wenn man diese sammeln mchte, um sie bei Bedarf vorrtig
zu haben, wird das Ablegen in separaten PAS-Dateien irgendwann
unbersichtlich, wenn die Quellen in die Tausende gehen.
 Im Jahre 1993 haben in Amerika ein paar Leute damit begonnen, aus
verschiedenen Netzen meist recht ntzliche Pascal-Sourcen und -Tips zu
sammeln. Diese "Schnipsel" werden nach Themengebieten zusammengefat in
Archivdateien gesammelt. Die Leute, die das alles machen, nennen sich
SourceWare Archival Group (SWAG) und ihre Archivdateien haben die Endung
SWG. Das ganze Projekt ist Freeware und jedermann ist aufgerufen, seinen
besten Code der Allgemeinheit zur Verfgung zu stellen.
 Mittlerweile umfat das Archiv mehrere 1000 Eintrge und trotz des neuen
gepackten Formates z.B. auf meiner Festplatte ber 4 MB.
Mitgeliefert wird auch ein Reader zum Lesen und Extrahieren der Schnipsel.
sowie Zusatztools zum Lschen und Hinzufgen von Schnipseln.

 Wozu wird dann also Parchi bentigt?

Es ist ein komfortabler Ersatz fr den SWAG-Reader, mit vielfltigen
Bearbeitungsmglichkeiten:

  - Editieren und Hinzufgen von Eintrgen
  - Editieren der Eintragsheader und Suchkeys
  - Anlegen neuer Archivdateien
  - Kopieren von Eintrgen in andere Archive
  - ndern der Reihenfolge der Eintrge innerhalb einer Archivdatei
  - bersetzen der Eintrge gleich im Archiv, um grobe Fehler zu finden


3. Voraussetzungen fr Parchi
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Um mit Parchi arbeiten zu knnen, wird folgendes bentigt:

   1. PARCHI.EXE
   2. *.SWG - wenigstens 1 Datei, sonst ist Parchi hiflos
   3. TPC.EXE oder BPC.EXE zum bersetzen der Eintrge
   4. Rechner ab 80286 und 1 MB
   5. DPMI16BI.OVL, RTM.EXE usw.

Grund fr Punkt 5 ist, da Parchi im Protected Mode luft. Die bentigten
Dateien gehren zum Lieferumfang von BP. Wer nur TP hat, kann die Datei
BorDPMI.lzh saugen, die alle fr DPMI bentigten Sachen enthlt.


4. Der erste Start von Parchi
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Am besten kopiert man das Programm in einen in der Path-Anweisung
enthaltenen Pfad. Bei mir steht es im Verzeichnis \bp\bin neben bp.exe.
So lt es sich am besten in die IDE von BP einbinden.
Der erste Schritt bei dem "Jungfernlauf" des Programmes sollte das
Einstellen der Optionen in den entsprechenden Mens sein. Wichtig sind
die Pfadeinstellungen (Unterverzeichnisse knnen dabei auch gleich
angelegt werden), der Rest ist mit sinnvollen Werten voreingestellt.
Es ist aber zu beachten, da bei den Compileroptionen sparsam mit
Pfadangaben umgegangen wird. Bekanntlich ist die Lnge einer Kommando-
zeile begrenzt. Sollten viele Pfade bentigt werden, so empfiehlt es
sich, eine CFG-Datei fr den Kommandozeilencompiler anzulegen. (RTM)
Smtliche optionalen Einstellungen werden in der Datei Parchi.ini
abgelegt.


5. Temporre Dateien
~~~~~~~~~~~~~~~~~~~~
Whrend es arbeitet, legt Parchi verschiedene temporre Dateien an.
Diese haben alle eine Tilde (~) im Namen und werden gelscht,
falls das regulre Programmende erreicht wird.
Man sollte es tunlichst unterlassen, alle diese Dateien z.B. whrend
eines Ausfluges zu Dos (mit ALT+P D) zu lschen.


6. Aufstellung der benutzten Funktionstasten
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   F2          befrdert den aktuellen Eintrag in eine PAS-Datei im
               voreingestellten Pfad, zur Namensgebung siehe weiter unten

   Shift-F2    befrdert die markierten Eintrge in PAS-Dateien im
               voreingestellten Pfad, zur Namensgebung siehe weiter unten

   Strg-F2     kopiert den aktuellen Eintrag in ein anderes SWG-Archiv

   Alt-F2      kopiert die markierten Eintrge in ein anderes SWG-Archiv

   F3          schaltet in den Editormodus fr den aktuellen Eintrag

   Shift-F3    schaltet in die programmeigene Zwischenablage
               (nur im Editormodus)

   Strg-F3     schaltet in den Editmodus fr Betreff und Autor

   Alt-F3      Editormodus beenden und in den Betrachtermodus schalten

   F4          zeigt den aktuellen Eintrag (Betrachtermodus)

   Alt-F4      Feierabend
   Alt-X       Feierabend

   F5          Listet alle Archiveintrge der geffneten SWG-Datei auf

   Strg-F5     verschiebt den aktuellen Eintrag innerhalb des Archives
               an eine andere Position

   F6          anderes SWG-Archiv oeffnen

   Shift-F6    neues SWG-Archiv anlegen und den aktuellen Eintrag
               hineinkopieren

   Strg-F6     setzt die gewnschten Flags zurck

   Alt-F6      ndert die Archivbeschreibung

   F7          Suchfunktion
               - entweder nur im Betreff
                 oder in Betreff und Text
               - a) entweder in der aktuellen SWG-Datei
                 b) oder in allen SWG-Dateien des eingestellten Pfades
               - Suche wahlweise
                   neu:
                     bei a) werden eventuell vorhandene Markierungen
                            zu Beginn gelscht
                     bei b) wird eine neue Datei fr das Suchergebnis
                            erzeugt
                   erweiternd:
                     bei a) werden eventuell vorhandene Markierungen
                            zu Beginn nicht gelscht
                     bei b) wird eine anzugebende Datei um das
                            Suchergebnis erweitert
                   einschrnkend:
                     bei a) werden nur markierte () Eintrge durchsucht
                            und nicht zutreffende Markierungen gelscht
                     bei b) gibt es keinen Sinn und ist daher unmglich

   Shift-F7    Diese Taste ist nur im Betrachtermodus wirksam.
               Sie bewirkt, da das Wort, auf dem der Cursor gerade steht,
               in den Suchkey aufgenommen wird, wenn dort nicht schon
               vorhanden. Suchworte mssen mindestens 4 Buchstaben lang
               sein.

   F9          compiliert den aktuellen Eintrag zu Testzwecken mit dem
               eingestellten Kommandozeilencompiler

   F10         aktiviert die Menleiste

   F11         speichert alle bisher durchgefhrten nderungen in der
               SWG-Datei ab

   Alt-F11     verwirft alle bisher in der SWG-Datei durchgefhrten
               nderungen

Je nach Programmzustand ist ein Teil der Funktionstasten nicht verfgbar.
Wird eine gesperrte Taste gedrckt, so ertoent ein Warnton.

Weiterhin sind folgende Tasten anders als blich belegt, falls man sich
NICHT im Texteditor befindet:

  EINF      fgt neuen Eintrag ans Ende des geffneten Archives und
            verlangt im Datei-Suchmen nach der Eingabe oder Auswahl
            einer PAS-Datei. Das Quellverzeichnis lt sich unter
            Optionen | Allgemein einstellen.

  ENTF      markiert den gewhlten Eintrag als gelscht. Dieser kann
            daraufhin nicht mehr betrachtet werden. Das tatschliche
            Lschen erfolgt beim Archivwechsel oder bei Programmende.
            Sollte der Eintrag bereits gelscht sein, so wird die
            Lschmarkierung wieder entfernt.

  grau +    Wechselt zum nchsten nicht gelschten Eintrag.

  grau -    Wechselt zum vorhergehenden nicht gelschten Eintrag.

  grau /    Wechselt zum nchsten markierten Eintrag.

  grau *    Wechselt zum vorhergehenden markierten Eintrag.


Die folgenden Tasten sind anders als blich belegt, falls man sich
im Texteditor befindet:

  SHIFT+ALT+EINF  Fgt Text aus dem Windows-Clipboard ein, falls vorhanden.
                  Weitere Informationen siehe unter Zwischenablage.

  STRG+ALT+EINF   Fgt den markierten Text in das Windows-Clipboard ein,
                  falls Windows luft.
                  Weitere Informationen siehe unter Zwischenablage.


7. Die Zwischenablagen
~~~~~~~~~~~~~~~~~~~~~~
Parchi hat eine Zwischenablage fr den Texteditor, die mit den blichen
Tastenkombinationen benutzt werden kann. Eingefgt und ausgeschnitten
werden kann natrlich nur im Editormodus nach Bettigen der F3-Taste, aber
markierte Abschnitte kann man sogar aus dem Betrachtermodus (F4) in die
Zwischenablage kopieren.
Sollte das Programm unter Windows laufen, so steht zustzlich auch noch die
Windows-Zwischenablage fr Kopieren und Einfgen zur Verfgung. Dafr ist
nur noch zustzlich zu den gewohnten die ALT-Taste zu drcken.

WARNUNG:
>> STRG+ALT+ENTF bewirkt aber kein Ausschneiden, sondern wie gewohnt
>> einen Warmstart, falls Windows nicht luft.


8. Markierungen der Archiv-Eintrge
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
In der Regel wird es einige Abende dauern, bis ein greres SWG-Archiv
gesubert ist, d.h. bis doppelte Problemlsungen entfernt und fehlerhafte
Eintrge berichtigt oder gelscht sind. Dann ist es gut, ohne lange
Papierlisten zu wissen, wieweit man denn in der Bearbeitung letztens war.
Jeder Eintrag kann mit einer ganzen Reihe Markierungen (oder Flags)
versehen werden, von denen ein Teil optional mit dem Archiv gespeichert
werden kann. Mit Strg+F6 kann die Datei von ungewnschten Markierungen
gesubert werden.

Speicherbare Flags:

  '' = Ausgewhlter Eintrag
        Eintrge werden entweder mit der Leertaste in der Eintragsliste
        oder whrend einer Suche im Archiv ausgewhlt.

  'X' = Eintrag, der in der momentanen Sitzung extrahiert wurde.

  'x' = Eintrag, der in einer frheren Sitzung extrahiert wurde.

  'C' = Eintrag, der ohne Fehlermeldung bersetzt wurde.

  '?' = Eintrag, der mit Fehlermeldung bersetzt wurde.

Folgende Flags werden unabhngig von der eingestellten Option nicht mit
der Datei gespeichert:

  '+' = Neu hinzugefgter Eintrag

  '-' = Gelschter Eintrag  (kann noch widerrufen werden)

  'E' = Editierter, also bearbeiteter Eintrag


9. Extrahieren von Eintrgen
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Soll ein Eintrag mit F2 extrahiert werden, so ist die Angabe der
Dateiendung PAS berflssig. Auerdem schlgt Parchi einen mglichst
geeigneten Namen vor, der aber auch gendert werden kann. Der Name wird
wie folgt ermittelt:
        1. Ist ein Unitname vorhanden, so wird dieser benutzt.
        2. Trifft 1. nicht zu und ist ein Programmname vorhanden,
           so wird der Programname benutzt.
        3. Treffen 1. und 2. nicht zu, so wird die voreingestellte
           Namensgebung benutzt. Ist eine Datei gleichen Namens vorhanden,
           so wird die Nummerierung incrementiert, bis ein unbenutzter
           Dateiname gefunden wird.


10. Bestimmungen zum Vertrieb
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   Das Programm ist Postcardware, d.h. es darf 4 Wochen lang getestet
  werden. Dann mut Du Dich entscheiden: Entweder Du lschst es wieder
  von Deiner Festplatte oder Du sendest mir wenigstens eine Postkarte
  mit Foto von Deinem Wohnort. Meine Adresse steht unter Programm | Info
  und am Ende dieses Textes.
   Warum die Sache mit der Postkarte?
   Es war eine ganze Menge Arbeit, das Programm auf seinen jetzigen
  Stand zu bekommen. Ich habe auch Sachen implementiert, die ich selbst
  fast nie benutze. Ich knnte es als Shareware vertreiben, aber die
  knnen die Schler und Studenten sich oft nicht leisten. Ein oder zwei
  Postkarten wird aber jeder bezahlen knnen, ohne sich zu ruinieren.
  Es gibt mir ein interessantes Bild, wo Parchi berall eingesetzt wird
  bzw. in welchen Gegenden entweder offenbar besonders geizige Leute
  wohnen oder keiner SWAG benutzt (weie Flecken auf meiner Landkarte).
  Auerdem sehe ich so, da Parchi wirklich benutzt wird und gebe
  mir dann viel mehr Mhe, es noch besser zu machen ;-))

  Das Programm darf unter folgenden Bedingungen unbegrenzt kopiert,
  weitergegeben und in Mailboxen geladen werden:
       1. Die Weitergabe erfolgt kostenlos.
       2. Das Archiv PA300.zip bzw. smtliche darin enthaltenen Dateien
          wurden nicht verndert.

  Die neueste Version ist stets
  in der Augustus-Box (0351) 8014326   2:249/3010   (Fido-Light)
                                       2:2404/3010  (Fido-Classic)
  zu frequesten.

   Auerdem sind die deutsche und englische Version von Parchi
  per ftp bei ftp.inf.tu-dresden.de erhltlich.
   Die englische Version gibt es auch auf garbo.uwasa.fi.
  Mit dem Release der englischen Version 3.00 wird es allerdings
  noch ein Weilchen dauern.


11. Garantie und Haftung
~~~~~~~~~~~~~~~~~~~~~~~~
Dieses Programm wurde mit groesster Sorgfalt entwickelt.
Der Autor kann aber nicht dafr garantieren, dass das Programm
auf jedem Rechner fehlerfrei luft. Aus diesem Grunde wird bei
eventuell auftretenden Fehlern oder Schden, gleich welcher Art,
keine Haftung bernommen.

Verbesserungsvorschlge sind jederzeit willkommen.

*************************************************************************

Viel Spa mit SWAG und PARCHI wnscht

Frank Heyne
Zwickauer Strasse 127
D-01187 Dresden

email:
Parchi Bugmeldungen und Vorschlge: parchi@ufo.sax.de
ForPas Bugmeldungen und Vorschlge: forpas@ufo.sax.de
                         allgemein: fh@ufo.sax.de
