home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: OtherApp / OtherApp.zip / 4desy140.zip / 4desy2.dok < prev    next >
Text File  |  1994-12-09  |  38KB  |  928 lines

  1.  
  2.       **************************************************************
  3.  
  4.   *** an english documentation is contained in the file 4DESY2.DOC ***
  5.  
  6.       **************************************************************
  7.  
  8.  
  9.  
  10.  
  11.                             4Desy/2
  12.  
  13.                         - For-Desy-Too -
  14.  
  15.                           Version 1.40
  16.  
  17.  
  18.  
  19.  
  20.           ein komfortabler Description-Editor fuer 4OS2
  21.  
  22.  
  23.  
  24.          geschrieben im Januar/November 1994 von Wolfram Koerner.
  25.  
  26.              Internet: koerner@cip.informatik.uni-wuerzburg.de (bevorzugt)
  27.                  oder: koerner@wok.incubus.sub.org
  28.  
  29.              FIDO    : Wolfram Koerner@2:2490/5100.8
  30.  
  31.            CompuServe: 100430,1064
  32.  
  33.              Sackpost: Wolfram Koerner
  34.                        Friedenstrasse 5a
  35.                        97072 Wuerzburg
  36.                        GERMANY
  37.  
  38.  
  39.  
  40.  
  41.  
  42.      Inhalt:
  43.      -------
  44.             * Die Highlights in Kuerze
  45.  
  46.             * Was ist 4OS2 und was sind Descriptions ?
  47.  
  48.             * Was macht nun 4Desy/2 ?
  49.  
  50.             * Die Kommandozeilen-Parameter
  51.  
  52.             * Der Bildschirm von 4Desy/2
  53.  
  54.             * Die Tasten von 4Desy/2
  55.  
  56.             * "OK, watt koss' dat Teil ?"  - CARDWARE
  57.  
  58.             * HAFTUNG und Co.
  59.  
  60.             * Copyrights und Trademarks
  61.  
  62.             * Noch ein Hinweis
  63.  
  64.             * Credits
  65.  
  66.  
  67.  
  68.  
  69.             Die Highlights in Kuerze:
  70.             -------------------------
  71.  
  72.             * Bis zu 512 Dateien pro Directory editierbar
  73.  
  74.             * HPFS-lange Datei/Verzeichniss-Namen erlaubt
  75.  
  76.             * Beschreibungen bis zu 511 Zeichen lang
  77.  
  78.             * Konfigurierbarer Name für DESCRIPT.ION (z.B. FILES.BBS)
  79.  
  80.             * Interne Zwischenablage zum Kopieren von Beschreibungen
  81.  
  82.             * Suchen von Eintraegen oder Dateinamen, die bestimmte
  83.               Suchtexte enthalten.
  84.  
  85.             * Interaktives Wechseln von Laufwerken und Verzeichnissen
  86.  
  87.             * Verschiedene Betrachter koennen abhaengig von der
  88.               Erweiterung der aktuellen Datei mit F3 aufgerufen werden
  89.  
  90.             * F4 editiert die aktuelle Datei, F9 startet einen
  91.               Kommandoprozessor
  92.  
  93.             * F8 löscht die aktuelle Datei.
  94.  
  95.             * Freie Farbeinstellungen moeglich
  96.  
  97.             * Setup wahlweise ueber Kommandozeilenschalter oder
  98.               ueber eine 4DESY2.INI-Datei im Verzeichniss von 4Desy/2
  99.  
  100.             * Automatisches Speichern (auf Wunsch)
  101.  
  102.             * Arbeitet mit variabler Zeilenzahl
  103.                 -  25 bis 102 Zeilen, wenn PM-Fenster
  104.                 -  25 bis  60 Zeilen, wenn Vollbild-Textmodus
  105.               (die Zeilenzahl muss vor Start mit MODE 80,yyy gesetzt sein)
  106.  
  107.             * Viele gewohnte Editor-Tasten verfuegbar
  108.  
  109.  
  110.  
  111.      Was ist 4OS2 und was sind Descriptions ?
  112.      ----------------------------------------
  113.      4OS2 ist ein Ersatz fuer den etwas spartanisch ausgefallenen
  114.      Kommandoprozessor von OS/2, den CMD.EXE.   4OS2.EXE  ersetzt
  115.      diesen komplett und haelt unzaehlige Verbesserungen bereit.
  116.      z.B.   Tippt  man  nur  den Anfangsteil eines Verzeichnisses
  117.      oder einer Datei, mit der  man gerade etwas "anstellen" will
  118.      und dann der Druck auf die TAB-Taste und  4OS2  komplettiert
  119.      die  Namen.   4OS2  hat  in  der   aktuellen   Version   die
  120.      Versionsnummer  2.00  und  ist  als  Shareware eigentlich in
  121.      jeder gut sortierten  OS/2-Mailbox  und natuerlich ueber ftp
  122.      auf cdrom.com zu bekommen.
  123.  
  124.      Unter   den   unzaehligen   Verbesserungen   sind  auch  die
  125.      File-Descriptions.  Man kann mit dem Befehl "DESCRIBE" jeder
  126.      Datei und  jedem  Verzeichniss  eine  Beschreibung ankleben.
  127.  
  128.      Die Beschreibungen aller Dateien werden im Verzeichniss,  wo
  129.      die  beschriebenen  Dateien  sind  in einem versteckten File
  130.      namens  "DESCRIPT.ION"  von   4OS2   (und   auch  von  4DOS)
  131.      gespeichert.
  132.  
  133.      Wird  nun  diese  Datei  unter  4OS2 kopiert, geloescht oder
  134.      verschoben,  dann  werden  die  Descript.ion-Dateien  in den
  135.      verschiedenen Verzeichnissen  automatisch angepasst.   Files
  136.      die   auf  Festplatte  beschrieben  und  dann  auf  Diskette
  137.      verschoben wurden, werden auch dort ihre Beschreibung haben.
  138.  
  139.      Die Beschreibungen werden bei einem ganz normalen DIR-Befehl
  140.      angezeigt.  Wenn die Festplatte mit den beschriebenen  Files
  141.      allerdings  mit  HPFS unter OS/2 formatiert ist, so wird der
  142.      meiste Platz fuer  die  langen  Dateinamen reserviert.  Dann
  143.      muss man 4OS2 Mit dem Befehl  "DIR  /z"  dazu  zwingen,  das
  144.      Verzeichniss  im  FAT-Format anzuzeigen und dann werden auch
  145.      die Dateibeschreibungen wieder angezeigt.
  146.  
  147.      Es ist halt ein Unterschied, ob eine Diskette, die man schon
  148.      1 Jahr im Schrank hat so aussieht:
  149.  
  150. [c:\]dir a:
  151.  
  152.   Volume in drive A is unlabeled
  153.   Directory of  a:\*.*
  154. bdesk234.arj   145109  14.07.92  23.41
  155. descript.ion      392  16.10.92  16.24
  156. resmast1.zip    47964  14.03.92   5.20
  157. sabdu120.arj    51041  14.07.92  23.43
  158. sprbar11.arj    46583  29.07.92  12.22
  159. tngeb200.arj   261453  16.07.92  23.48
  160. wed13b.arj     214750  31.03.92  15.00
  161. winfr171.exe   256389   9.05.92  14.49
  162. winq200a.arj   252653  25.07.92  13.29
  163.    1.438.892 bytes in 10 file(s)         1.440.768 bytes allocated
  164.          16.896 bytes free
  165.  
  166.  
  167.      oder ob die Diskette sich eben so praesentiert:
  168.  
  169.  
  170. [c:\]dir a:
  171.  
  172.   Volume in drive A is unlabeled
  173.   Directory of  a:\*.*
  174. bdesk234.arj   145109  14.07.92  23.41 BigDesk (virtueller Bildschirm) Win3.1
  175. descript.ion      392  16.10.92  16.24
  176. resmast1.zip    47964  14.03.92   5.20 Resource-Master 1.00 f. WIN
  177. sabdu120.arj    51041  14.07.92  23.43 Disketten kopieren/formatieren f. WIN
  178. sprbar11.arj    46583  29.07.92  12.22 Superbar f.WIN (Hot-Icons f.Apps)
  179. tngeb200.arj   261453  16.07.92  23.48 TechNoir Geburtstags-Planer (gut!)
  180. wed13b.arj     214750  31.03.92  15.00 Programmierer-Editor (ANSI) f. WIN
  181. winfr171.exe   256389   9.05.92  14.49 Win-Fractale 1.71
  182. winq200a.arj   252653  25.07.92  13.29 Windows-Offline-QWK-Reader
  183.    1.438.892 bytes in 10 file(s)         1.440.768 bytes allocated
  184.          16.896 bytes free
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.      Was macht nun 4Desy/2 ?
  193.      -----------------------
  194.  
  195.      Mit dem 4OS2-Kommando "DESCRIBE" sind die Beschreibungen nur
  196.      sehr  umstaendlich  zu  bewerkstelligen.   Jedes  File  wird
  197.      einzeln  behandelt,  man  kann  nicht  noch  mal  eben einen
  198.      Tippfehler verbessern oder bereits  geschriebenenes  nochmal
  199.      verwenden.
  200.      Hier springt nun 4Desy/2 als komfortabler Description-Editor ein.
  201.      Obwohl 4Desy/2 zum Ablaufen KEIN 4OS2 benoetigt, machen die
  202.      huebschen DESCRIPT.ION-Dateien eben doch nur mit installiertem
  203.      4OS2 einen Sinn !
  204.  
  205.  
  206.  
  207.  
  208.      Die Kommandozeilen-Parameter
  209.      ----------------------------
  210.      Die Reihenfolge der Parameter spielt *KEINE* Rolle !
  211.      Gross- und Kleinschreibung ist ebenso egal.
  212.  
  213.      Normalerweise will 4Desy/2  die Beschreibungen des aktuellen
  214.      Verzeichnisses im aktuellen Laufwerk  editieren.   Man  kann
  215.      jedoch  ein  ein bestimmtes Laufwerk und/oder ein bestimmtes
  216.      Unterverzeichniss festlegen, das editiert werden soll:
  217.  
  218.         4DESY2.EXE [Laufwerk:][pfand\pfad\pfad]
  219.  
  220.      Zum Beispiel wenn das aktuelle Verzeichniss irgendwo auf der
  221.      Festplatte ist, so kann man 4Desy/2 so starten:
  222.  
  223.          4DESY2.EXE a:
  224.  
  225.      und  es  wird  das  aktuelle  Verzeichniss  der  Diskette A:
  226.      bearbeitet werden.
  227.  
  228.      Andere moegliche Beispiele:
  229.  
  230.         4DESY2.EXE a:\
  231.         4DESY2.EXE a:\verzeich
  232.         4DESY2.EXE \os2\install
  233.         4DESY2.EXE subdir\verzeich
  234.  
  235.  
  236.      Weitere Kommandozeilen-Parameter:
  237.  
  238.      Schalter     Funktion
  239.      ------------------------------------------------------------------
  240.      /?           "HILFE !!!"
  241.  
  242.                   Zeigt vor dem Start eine kurze Uebersicht ueber
  243.                   die moeglichen Schalter. Nach Tastendruck wird dann
  244.                   das Programm normal aufgerufen.
  245.                   Beispiel:
  246.  
  247.                   4DESY2.EXE /?
  248.  
  249.      /H           gleiche Funktion wie /?
  250.  
  251.  
  252.      /A           "AUTOMATISCHES SPEICHERN"
  253.  
  254.                   wird dieser  Schalter  mit  angegeben, so fragt
  255.                   4desy/2  wenn  noetig  nicht  mehr   nach,   ob
  256.                   gespeichert  werden  soll,  sondern speicher in
  257.                   folgenden Situationen einfach automatisch, wenn
  258.                   es Veraenderungen zu Speichern gibt:
  259.                     - Verlassen des Programms
  260.                     - Wechseln des Verzeichnisses(ENTER auf <DIR>)
  261.                     - Wechseln des Laufwerkes (Alt-D)
  262.                   Wenn 4Desy/2  laeuft,  kann  der AutoSave-Modus
  263.                   mit Alt-A an- und ausgeschaltet werden.
  264.                   (siehe Beschreibung von Taste Alt-A)
  265.                   (siehe Beschreibung der 1.Bildschirmzeile)
  266.  
  267.  
  268.      /Caxxx       "Farbeinstellungen"
  269.                   (Colorsetting)
  270.                   Das kleine 'a'  hinter  dem Schalter steht fuer
  271.                   das Bildschirmelement,  dessen  Farbwert  folgt
  272.                   und kann einer dieser Buchstaben sein:
  273.                   T  : 1.Bildschirmzeile (Statuszeile)
  274.                   B  : letzte Bildschirmzeile (Attribute, Datum,Zeit)
  275.                   F  : normale Dateizeile
  276.                   D  : normale Verzeichnisszeile
  277.                   E  : aktuelle Zeile, die bearbeitet wird
  278.                   H  : Hilfebildschirm
  279.                   C  : Verzeichnissanzeige im Hilfsbildschirm
  280.                   W  : Warnungen/Fehlermeldungen
  281.  
  282.                   Die drei 'xxx'stehen fuer einen Farbwert von
  283.                   0 bis  127.   In  der  Zahl  werden Vorder- und
  284.                   Hintergrundfarbe fuer das  Element  festgelegt.
  285.                   Das    Hilfsprogramm  "4COLORS.EXE"   aus   dem
  286.                   4DESY-Archiv   zeigt   die    Werte   mit   den
  287.                   entsprechenden Farben an.
  288.                   Beispiel:
  289.                   4DESY2.EXE /CT12
  290.                   legt  die  Farbe  der  oberen  Statuszeile  auf
  291.                   Hintergrund SCHWARZ und Zeichenfarbe HELLROT
  292.  
  293.  
  294.      /E           "EDITOR-Modus" anstatt POS1-Modus
  295.  
  296.                   Schaltet 4Desy/2 nach dem Start direkt in den Editormode.
  297.                   Im Editor-Mode benimmt sich das  Programm  eben
  298.                   wie  ein  Editor.   Wenn  mit Cursor-Runter von
  299.                   einer Zeile zur  naechsten  gegangen wird, dann
  300.                   wird die Cursor-Position beibehalten, sofern in
  301.                   der  naechsten   Zeile   an   dieser   Position
  302.                   ueberhaupt  noch ein Zeichen steht.  Steht dort
  303.                   kein Zeichen  mehr,  dann  wird  auf das letzte
  304.                   Zeichen der naechsten  Zeile  gesprungen.   Ist
  305.                   die  naechste  Zeile  leer, wird auf Position 1
  306.                   gegangen.  Die "alte"  Position wird aber nicht
  307.                   "vergessen".  Sondern wenn  man  nur  ein  paar
  308.                   leere   Zeilen  ueberspringen  will,  und  dann
  309.                   wieder zu  einer  Zeile  mit ausreichend wielen
  310.                   Zeichen gelangt, dann wird  dort  die  gemerkte
  311.                   Position auch wieder angesteuert.
  312.  
  313.                   Im  Normal-Fall  befindet sich 4Desy/2 naemlich
  314.                   im POS1-Mode.   Wenn  im  POS1-Mode  eine Zeile
  315.                   irgendwie     verlassen     wird     (BildRauf,
  316.                   Cursor-Runter...),  dann  wird   in   der   neu
  317.                   angesprungenen  Zeile  immer auf die 1.Position
  318.                   gegangen.
  319.                   Welchen  Modus  man  nun  leiber  hat,  ob  den
  320.                   Editor-Modus   oder    den    POS1-Modus,   ist
  321.                   eigentlich persoenliche Geschmacksache...
  322.  
  323.                   Fuer Unentschlossene sei  die  Taste  Alt-E  im
  324.                   Editor  genannt.  Diese schaltet zwischen den 2
  325.                   Modi um.
  326.                   Beispiel:
  327.  
  328.                   4DESY2.EXE /e
  329.  
  330.  
  331.      /F3aaaaaa    "Standard F3-Betrachter"
  332.                   normalerweise wird beim  Drücken  der  F3-Taste
  333.                   auf  einer Datei das Kommando "LIST" mit dieser
  334.                   Datei  ausgeführt.   Wenn  ein  anderer  Lister
  335.                   bevorzugt wird, kann  er hier angegeben werden.
  336.                   Betrachter   für   Dateien    mit    bestimmten
  337.                   Erweiterungen  koennen  in der 4DESY2.INI-Datei
  338.                   festegelgt werden.  So  können auch ZIP-archive
  339.                   odfer GIF-Bilder oder WAV-Dateien  von  4Desy/2
  340.                   aus betrachtet werden.  Der F3-Schalter bezieht
  341.                   sich nur auf den Betrachter, der genommen wird,
  342.                   wenn  fuer  die Erweiterung der aktuellen Datei
  343.                   kein Spezial-Betrachter definiert wurde.
  344.                   Beispiel:
  345.                   4DESY2.EXE /F3c:\mytools\myview.exe
  346.                   4DESY2.EXE /F3listos2
  347.  
  348.      /F4aaaaa     "F4-editor Befehl"
  349.                   4Desy/2 startet  normalerweise  den OS/2-editor
  350.                   E.EXE, wenn F4 auf einer Datei gedrueckt  wird.
  351.                   Wenn  man  einen  anderen  Lieblingseditor hat,
  352.                   kann dieser her angegeben werden.
  353.                   Beispiel:
  354.                   4DESY2.EXE /F4c:\apps\qedit\q.exe
  355.                   4DESY2.EXE /F4epm.exe
  356.  
  357.  
  358.      /K           "Unterverzeichniss merken"
  359.                   (KEEP last subdir)
  360.  
  361.                   wenn dieser Schalter  von  der Kommandzeile aus
  362.                   aktiviert wird, so merkt sich 4Desy/2 den Namen
  363.                   des letzen Unterverzeichnisses.   Wenn  nun  zu
  364.                   einem  Oberverzeichniss  gewechselt wird (Durch
  365.                   Drücken von ENTER auf einem ".."-Verzeichniss),
  366.                   dann wird nach  Einlesen  des neuen Directories
  367.                   *NICHT* zum ersten Eintrag gesprungen,  sondern
  368.                   es wird auf die Zeile mit dem Unterverzeichniss
  369.                   gesprungen, aus dem hierher gewechselt wurde.
  370.                   Ohne  diesen  Schalter wird immer zum 1.Eintrag
  371.                   in einem Verzeichniss gewechselt.
  372.                   (siehe auch Taste ALT-K)
  373.  
  374.      /Lxxx        "LAENGE von Zeilen"
  375.  
  376.                   Hinter dem Schalter /L kommt immer noch eine 2
  377.                   oder 3-stellige  Ziffer.   Mit  diesem Schalter
  378.                   wird die  maximale  Laenge  einer  Beschreibung
  379.                   festgelegt.      Normalerweise     haben    die
  380.                   Beschreibungen eine Max.-Laenge von 40 Zeichen.
  381.                   Diese 40 Zeichen passen bei einem FAT-Directory
  382.                   naemlich gerade  noch  so  hinter  die uebrigen
  383.                   Angaben wie Filename und Datum (...).  Seit der
  384.                   neuen 4OS2-Version 2.50 (und auch in 4DOS)
  385.                   werden aber  Beschreibungslaengen  von  bis  zu
  386.                   511 Zeichen auch noch angezeigt.
  387.  
  388.                   Laesst  man  diese  Angabe  weg,  so werden von
  389.                   4Desy/2   maximal   40    Zeichen   pro   Zeile
  390.                   angenommen.
  391.                   Wenn eine  Beschreibung  nun  laenger  als  der
  392.                   Maximalwert  ist, so koennen hier keine Zeichen
  393.                   mehr   dazugeschrieben,    sondern   nur   noch
  394.                   geloescht werden.
  395.                   Fuer die Maximallaenge einer Zeile  gilt,  dass
  396.                   sie von 20 bis 511 gehen darf.
  397.                   20 <= m <= 511  - fuer Mathematiker ...
  398.                   (siehe auch Taste Alt-L)
  399.                   Beispiel:
  400.  
  401.                   4DESY2.EXE /L60
  402.                                   legt eine Max.laenge von 60
  403.                                   Zeichen pro Beschreibung fest.
  404.  
  405.  
  406.  
  407.  
  408.      /M          "MONOCHROM"
  409.  
  410.                  4Desy/2 benutzt beim Bildschirmaufbau keine Farben
  411.                  sondern   nur  den  monochrome-Modusschwarz  und
  412.                  weiss und  grau.   Ich  hoffe,  dass  dann  auch
  413.                  Notebook-Besitzer,  die  OS/2  fahren  auf ihren
  414.                  LC-Display noch  was  sehen  koennen.
  415.                  (Bitte  um  Erfahrungsberichte,  da  ich  keinen
  416.                  Notebook mein Eigen nennen darf...)
  417.  
  418.      /N:cccccccc "DESCRIPT.ION NAME"
  419.                  Standardmaessig werden die Dateibeschreibungen aus
  420.                  der Datei mit dem Namen DERSCRIPT.ION gelesen und
  421.                  auch wieder in diese geschrieben. Seit der Version
  422.                  2.5 von 4OS2 (und 4DOS 5.0) kann der DESCRIPT.ION
  423.                  Name in der Datei 4OS2.INI geaendert werden.
  424.                  (mit der INI-Direktive: DescriptionName=.......)
  425.                  Dem hat sich 4Desy/2 mit diesem Schalter angepasst.
  426.                  Zum Beispiel koennen Sysops von Mailboxen den Namen
  427.                  mit /N:FILES.BBS umbenennen.
  428.                  Der aktuelle Name in dem die Beschreibungen be-
  429.                  arbeitet werden wird im Hilfefenster (F1) ange-
  430.                  zeigt.
  431.  
  432.                  Beispiel:
  433.                            4DESY2.EXE /N:FILES.BBS
  434.  
  435.                  BEMERKUNG:
  436.                  Mit dem aendern des Beschreibungsnamens wird NICHT
  437.                  das Dateiformat (für lesen oder schreiben) geaendert.
  438.                  Wenn also FILES.BBS Dateien vorliegen, die die
  439.                  Beschreibung ueber mehrere Zeilen umbrechen, so werden
  440.                  hier die nachfolgenden Zeilen abgeschnitten !
  441.  
  442.  
  443.  
  444.      /O          "OVERWRITE"-Modus
  445.  
  446.                  Im Normalfall startet 4Desy/2 im Einfuege-(=Insert)
  447.                  Modus.    Wer  lieber  immer  im  Ueberschreibe-
  448.                  (Overwrite-) Modus arbeiten  will,  der kann mit
  449.                  diesem Schalter 4Desy/2 davon in Kenntnis setzen.
  450.  
  451.  
  452.  
  453.      /Q          "QUIET"-Modus
  454.                  Wer es nach der 3.Beendigung von 4Desy/2 langsam
  455.                  gerafft hat, dass das Programm CARDWARE ist, der
  456.                  kann den kleinen Erinnerungs-Bildschirm am  Ende
  457.                  von 4Desy/2 damit unterdruecken.
  458.  
  459.                  ABER NUR WENN DIE KARTE SCHON IM KASTEN IST  ;-)
  460.  
  461.  
  462.      HINWEIS:
  463.      --------
  464.      Weichen die  persoenlichen  Lieblingsparameter  von  den Grund-
  465.      Einstellungen ab, so sollte  man  sich  ein  Alias  unter  4OS2
  466.      definieren,  dass  bei  jedem  Start die gewuenschten Parameter
  467.      einstellt. z.Beispiel:
  468.  
  469.      alias 4des=c:\tools\4os2\4desy2.exe /e /o /l200 /q
  470.  
  471.      diese Alias-Zeile kann  man  dann  noch in die 4START.CMD-Datei
  472.      schreiben, die 4OS2 zu Beginn immer auswertet  und  schon  kann
  473.      man 4Desy/2 von ueberall aus bequem mit
  474.           4DES<enter>
  475.      aufrufen.
  476.      Da die Alias-Definitionen bei 4OS2 im RAM gehalten werden, sind
  477.      sie  natuerlich  schneller  als  jede  Batch  ..- Verzeihung-..
  478.      CMD-Datei !
  479.  
  480.  
  481.  
  482.  
  483.  
  484.      Der Bildschirm von 4Desy/2
  485.      --------------------------
  486.  
  487. ┌─4DESY/2─V1.40───┤F1=Help│ESC=Exit├───AKI1┤C 27│M 40│Entry   2 of   6├─────┐
  488. │..           <DIR>                                                          │
  489. │4desy2.doc      10760  english documentation for 4Desy/2                    │
  490. │4desy2.dok      10760  deutsche Anleitung zu 4Desy/2                        │
  491. │4desy2.exe      85952  4Desy/2 -a comfortable DescriptionEditor             │
  492. │DESCRIPT.ION       68                                                       │
  493. │history.txt      2581  A brief history of 4Desy/2                           │
  494. │                                                                            │
  495. │                                                                            │
  496. │                                                                            │
  497. │                                                                            │
  498. │                                                                            │
  499. │                                                                            │
  500. │                                                                            │
  501. │                                                                            │
  502. │                                                                            │
  503. │                                                                            │
  504. │                                                                            │
  505. ├────────────────────────────────────────────────────────────────────────────┤
  506. │4desy2.doc                                               ---A 27.01.94 18:36│
  507. └────────────────────────────────────────────────────────────────────────────┘
  508.  
  509.      Die erste Zeile:
  510.      ----------------
  511.  
  512.      Hinter |ESC=Exit| beginnt die Status-Information:
  513.  
  514.      A   bedeutet : "Autospeichern" aktiv
  515.                     Wird  jetzt  das  Programm  beendet, oder das
  516.                     Verzeichniss  gewechselt  oder  das  aktuelle
  517.                     Laufwerk gewechselt, so werden Veraenderungen
  518.                     an dcen  Beschreibungen  automatisch und ohne
  519.                     weitere Rueckfragen gespeichert.
  520.                     (siehe Taste Alt-A)
  521.                     (siehe Kommandozeilenschalter /A)
  522.  
  523.      K   bedeutet : "SubDir-merken"-Modus ist aktiv.
  524.                     Zum ein- und aus-schalten ALT-K druecken.
  525.                     (siehe Taste ALT-K)
  526.                     (siehe Schalter /K)
  527.  
  528.      I   bedeutet : Insert(Einfuege)-Modus
  529.      O   anstelle des I bedeutet Overwrite(Ueberschreib)-Modus
  530.          (siehe Taste INS/Einfg)
  531.          (siehe Schalter /O)
  532.  
  533.      1   bedeutet : POS1-Modus bei Zeilenwechsel wird immer
  534.          an die 1.Position einer Beschreibung gesprungen
  535.      E   anstelle der 1 bedeutet "Editor-Modus" die Cursor
  536.          Position wird ueber einen Zeilenwechsel hinaus
  537.          beibehalten
  538.          (siehe Taste Alt-E)
  539.          (siehe Schalter /E)
  540.  
  541.      |C 27| bedeutet, dass der Cursor sich auf dem 27.Zeichen
  542.             der aktuellen Beschreibung befindet
  543.             (C fuer Column)
  544.  
  545.      |L 40| bedeutet, dass momentan eine maximale Beschreibungs-
  546.             Laenge von 40 Zeichen pro Zeile vorgegeben ist.
  547.             (siehe Schalter /L)
  548.  
  549.      |Entry 6 of 6| bedeutet, dass im aktuellen Verzeichniss 6 Eintraege
  550.                     gefunden wurden, die man beschreiben kann.
  551.                     Der Cursor befindet sich gerade auf dem 2.File, also
  552.                     auf "4desy2.doc"
  553.  
  554.      --  am Ende der Titelzeile bedeutet, dass nach der letzen Sicherung
  555.           mit F2 noch Aenderungen an den Beschreibungen vorgenommen wurden,
  556.           die noch nicht gespeichert sind.
  557.           Wenn das Programm gerade gestartet wurde, oder wenn man gerade
  558.           mit F2 gespeichert hat, dann ist dort kein Sternchen zu sehen.
  559.  
  560.  
  561.     Die letzte Zeile
  562.     ----------------
  563.  
  564.     Unter OS/2 koennen Dank des neuen Dateisystem HPFS Dateinamen
  565.     bis zu 256 Zeichen lang sein.  Dann passen natuerlich nicht mehr
  566.     alle Zeichen eines Namens in eine Bildschirmzeile.  Darum werden
  567.     von  4Desy/2  immer  nur  die  ersten  12  Zeichen  eines  Names
  568.     angezeigt.  Ist  ein  Name  laenger,  so  folgt  ihm  ein "" um
  569.     anzudeuten, dass da-> noch was kommt...
  570.  
  571.     Wenn man nun tatsaechlich laengere Namen benutzt, dann sollte
  572.     man ab-un-zu auch  mal  in  die  letzte  Zeile  des  Bildschirms
  573.     schauen.   Denn  dort  wird  das  aktuell  gewaehlte  File etwas
  574.     ausfuerlicher dargestellt.  Der  Name  wird  hier  erst nach dem
  575.     59.Zeichen abgeschnitten.   Wer  tatsechlich  256-Zeichen  lange
  576.     Namen verwendet gehoert eben bestraft...  ;-)
  577.     Außerdem werden  in  dieser  Zeile  noch  Datum  und Uhrzeit des
  578.     letzten schreibenden Zugriffes auf diese Datei dargestellt.
  579.     Hinter dem Dateinamen stehen  die  momentanen  Attribute  der
  580.     Datei:
  581.         R - "readonly" Nur-Lesen
  582.         H - "hidden"   Versteckt
  583.         S - "system"   System-Datei
  584.         A - "archive"  Archivierungs-Attribut
  585.     Ist  ein Attribut nicht gesetzt, so wird an dessen Stelle ein
  586.     Minus "-" ausgegeben.  Direkt  hinter den Attributen wird das
  587.     Filedatum  und  die  Urzeit  des   letzten   Schreibzugriffes
  588.     dargestellt. Dies geschieht im Format: TT.MM.JJ SS:MM
  589.  
  590.     Manchmal erscheinen  hier  auch  Warnhinweise,  wenn  z.B.   das
  591.     Programm  oder  das akt.Verzeichniss verlassen werden soll, ohne
  592.     dass die  Beschreibungen  gesichert  sind.   Und manchmal werden
  593.     hier auch Eingaben verlangt, wie zum Beispiel vor dem Suchen ein
  594.     Suchtext.
  595.  
  596.  
  597.  
  598.  
  599.     Die Tasten von 4Desy/2
  600.     ----------------------
  601.  
  602.     Hat man den Editor erfolgreich mit  den  benoetigten  Parametern
  603.     gestartet,  so  liest  dieser zunaechst den Inhalt des aktuellen
  604.     Directories  ein  und  wenn   vorhanden   auch  den  Inhalt  der
  605.     DESCRIPT.ION-Datei des Verzeichnisses.
  606.     Nun kann man die Beschreibungen wild editieren,  wobei  folgende
  607.     Tasten mit allerlei nuetzlichen Funktionen belegt sind:
  608.  
  609.     Taste  Funktion
  610.     ------------------------------------------------------------------
  611.     F1     Blendet ein Hilfe-Fenster ein, in dem kurz die wichtigsten
  612.            Tasten erklaert sind.
  613.            Ausserdem  kann  man diesem Fenster entnehmen, in welchem
  614.            Pfad und auf welchem Laufwerk man sich momentan befindet.
  615.  
  616.     F2     speichert die aktuelle Beschreibung in der Datei
  617.            DESCRIPT.ION auf Dauer. Nach verlassen des Programms
  618.            und bei betrachten des Directories mir DIR bzw.
  619.            DIR   /Z   werden   die   Beschreibungen   unter  4OS2
  620.            angezeigt.
  621.  
  622.     F3     Die aktuelle Datei soll betrachtet werden.
  623.            Wurde in  der  4DESY2.INI  fuer  die  Erweiterung  der
  624.            aktuellen  Datei  ein spezieller Betrachter definiert,
  625.            wird dieser gestartet.   Andernfalls  wird der mit dem
  626.            Schalter /F3aaaaa definierte Betrachter gestartet, und
  627.            sonst (wenn mit /F3 nichts defniert  wurde)  wird  das
  628.            4OS2 Kommando LIST ausgefuehrt.
  629.  
  630.     F4     startet  den  Editor,  der  mit  dem  Schalter  /F4aaaaa
  631.            festgelegt wurde mit der  aktuellen Datei.  Wurde kein
  632.            spezieller F4-Editor festgelegt,  so  wird  E.EXE  von
  633.            OS/2 mit der aktuellen Datei gestartet.
  634.  
  635.     F8     Wenn der aktuelle Eintrag eine Datei und kein Verzeichnis
  636.            ist, dann wird die Datei vom Datenträger gelöscht, sofern
  637.            die anschließende Sicherheitsabfrage mit "Y"es beantwortet
  638.            wurde.
  639.  
  640.     F9     Rufe OS/2-Kommandozeilen-Interpreter
  641.            Es  wird  der  Interpreter  ausgefuehrt,  der  in  der
  642.            CONFIG.SYS-Datei mit SET COMSPEC=.... defniert wurde.
  643.            Mit EXIT<enter> gelangt man zurueck zu 4Desy/2
  644.  
  645.     ESCape Beendet das Programm
  646.            Bei Bedarf, das heisst, wenn nicht vorher mit f2 ge-
  647.            speichert wurde, erscheint die folgende Sicherheitsabfrage:
  648.  
  649.           ┌──────────────────────────────────────────────────────────────────┐
  650.           │WARNING:Descriptionfile not saved.Save before exit?(Yes/No/Cancel)│
  651.           └──────────────────────────────────────────────────────────────────┘
  652.            Antwortet  man  hier mit "Y" so wird gespeichert und dann
  653.            das  Programm verlasse.            Bei   "N"  wird  nicht
  654.            gespeichert und trotzdem  verlassen   und  bei  "C"  wird
  655.            nicht   gespeichert   und  auch  nicht  das Programm  be-
  656.            endet - logo !
  657.  
  658.     Alt-X  ebenfalls: finito !
  659.  
  660.  
  661.     Alt-A  Schaltet den AutoSave-Modus ein und aus.
  662.            Beschreibung des AutoSave-Modus: Siehe  Kommandozeilen
  663.            schalter /A und Beschreibung der 1.Bildschirmzeile.
  664.  
  665.     Alt-E  Schaltet zwischen dem Editor- und dem POS1-Modus um
  666.            (Erlaeuterungen siehe Schalter /e)
  667.  
  668.     Ins    Die Insert (Einfuege)-Taste schaltet zwischen Einfuege-
  669.            und dem Ueberschreibe-Modus um.
  670.  
  671.  
  672.     <---   Die Backspace-Taste loescht das Zeichen links von Cursor
  673.  
  674.     Del    Die Delete(Entfernen)-Taste loescht das Zeichen recht
  675.            vom Cursor.
  676.  
  677.     Ctrl+  Ctrl-Del loescht ab der Cursorposition bis zum Ende der Zeile
  678.     Del
  679.  
  680.  
  681.    Cursor  Die Cursor und die BildRauf/BildRunter Tasten haben die
  682.    & Bild  gleichen Funktionen wie eigentlich in jedem Editor:
  683.    -Tasten Sie bewegen den Cursor. Speziell zu erwaehnen vielleicht:
  684.  
  685.    Ctrl+   Bewegt den Bearbeitungsbalken auf die vorige LEERE
  686.    Crsr-   Beschreibung, um sich schnell zwischen einigen fehlenden
  687.    Rauf    Beschreibungen hin-und-her zu bewegen.
  688.  
  689.    Ctrl+   Bewegt den Bearbeitungsbalken auf die naechste LEERE
  690.    Crsr-   Beschreibung, um sich schnell zwischen einigen fehlenden
  691.    Runter  Beschreibungen hin-und-her zu bewegen.
  692.  
  693.  
  694.    Ctrl+   Bewegen den Cursor zwischen Wortanfaengen hin- und her
  695.    <- / ->
  696.  
  697.     Pos1   Bewegen den Cursor auf das 1./letzte Zeichen einer Zeile
  698.     Ende
  699.  
  700.     Ctrl+  Zum ersten Eintrag der auf dem Schirm sichtbar ist
  701.     Pos1
  702.  
  703.     Ctrl+  Zum letzten Eintrag der auf dem Schirm sichtbar ist
  704.     Ende
  705.  
  706.     Ctrl+  Ctrl-BildRauf geht auf den ersten Eintrag ueberhaupt
  707.     PgUp
  708.  
  709.     Ctrl+  Ctrl-BildRunter geht auf den letzten Eintrag ueberhaupt
  710.     PgUp
  711.  
  712.  
  713.     Enter  Die Taste Enter hat 2 Funktionen.
  714.            1.)
  715.            Steht  man   mit   dem   Bearbeitungs-Balken   auf  einem
  716.            Verzeichniss,   dann   wird   zu   diesem    Verzeichniss
  717.            gewechselt.   Hat  man  den  Inhalt  der Beschreibung des
  718.            aktuellen Verzeichnisses noch  nicht gespeichert, so wird
  719.            eine Sicherheitsabfrage vorgeschaltet.
  720.  
  721.            2.)
  722.            Die 2.Funktion der Entertaste funktioniert nur auf reinen
  723.            Dateien (nicht auf Verzeichnissen).   Es wird einfach zum
  724.            naechsten Eintrag auf Position 1 gesprungen.
  725.  
  726.     Alt-D  Wechselt das Laufwerk.
  727.            Das  Programm  fordert  zum  Eintippen  eines   gueltigen
  728.            Laufwerkbuchstabens  auf  und  wechselt  zum  angegebenen
  729.            Laufwerk  und dort ins Wurzelverzeichniss.  Mit ENTER auf
  730.            Verzeichnissen kann  man  sich  dann  zu dem Verzeichniss
  731.            bewegen, in dem man die Descriptions editieren will.
  732.  
  733.     Alt-R  Der Inhalt des aktuellen Verzeichnisses wird erneut
  734.            eingelesen.  Dies ist zum Beispiel dann  noetig,  wenn
  735.            ein anderer, parallel zu 4Desy/2 laufender, Prozess den
  736.            Inhalt  des  aktuellen Verzeichnisses veraendert haben
  737.            sollte.     Die    Beschreibungen     sollten   vorher
  738.            gespeichert  werden.    Andernfalls   erscheint   eine
  739.            Warnmeldung.
  740.  
  741.     Alt-K  schaltet den "SubDir-merken"-Modus ein und aus.
  742.            fuer genauere  Beschreibung  siehe  Erlaeuterungen zum
  743.            Kommandozeilenschalter /K.
  744.            Wenn der "SubDir-merken"-Modus aktiv ist, wird in  der
  745.            Statuszeile   am   oberen   Bildschirmrand   ein   "K"
  746.            eingeblendet.
  747.  
  748.     Alt-C  Kopiert den kompletten Inhalt der aktuellen Beschreibung
  749.            in die 4Desy/2-Zwischenablage.
  750.  
  751.     Alt-U  Verschiebt den kompletten Inhalt der aktuellen Beschreibung
  752.            in die 4Desy/2-Zwischenablage. Die aktuelle Beschreibung
  753.            wird geloescht.
  754.  
  755.     Alt-P  Loescht erst die aktuelle Beschreibung und fuegt dann den
  756.            Inhalt der Zwischenablage ein. Der Editierbalken wird zum
  757.            naechsen Eintrag bewegt.
  758.  
  759.     Alt-Y  Loescht eine Beschreibung OHNE sie anschliessend in
  760.            die Zwischenablage zu kopieren (wie Alt-U).
  761.            Der Editierbalken wird zum naechsen Eintrag bewegt.
  762.            --- Vorsicht !
  763.  
  764.  
  765.     Alt-S  Sucht nach Texten.
  766.            Es kann ein Suchtext eingegeben werden, der maximal 40 Zeichen
  767.            lang sein darf. Anschleißend folgt die Frage:
  768.            ┌────────────────────────────────────────────────┐
  769.            │Examine <F>ilenames, <D>escriptions or <B>oth ? │
  770.            └────────────────────────────────────────────────┘
  771.            Was  soll  also  nach  dem  Auftauchen   des   Suchtextes
  772.            untersucht werden ?
  773.            F : Filenames - nur die Datei/Verzeichnisnamen
  774.            D : Descriptions  -  nur  die  Beschreibungen  werden
  775.                durchsucht
  776.            B : Both - Beides! Dateinamen, Verzeichnissnamen UND
  777.                die Beschreibungen werden nach dem Auzftauchen des
  778.                Suchstrings durchkaemmt.
  779.            Die  Suche  erfolgt  OHNE  Beachtung  von  Gross-  und
  780.            Kleinschreibung.   Die  Suche  beginnt   beim   ersten
  781.            Eintrag.   Der  erste Eintrag bei dem die Suche Erfolg
  782.            hat wird angesprungen.   Mit  Alt-N wird zum naechsten
  783.            passenden gesprungen.
  784.  
  785.     Alt-N  Siehe Alt-S
  786.            Springt zum naechsten Eintrag, auf den der Suchtext passt.
  787.            Wurde noch kein Suchtext festgelegt, dann hat diese Taste
  788.            keine Funktion.
  789.  
  790.     Alt-L  Nach  dieser  Taste  kann  man  eine   neue   maximale
  791.            Beschreibungs-  laenge von 20 bis 511 eingeben werden.
  792.            (siehe Schalter /L)
  793.  
  794.  
  795.     Alt-I  Speichert  die momentanen Einstellungen von 4Desy/2 in
  796.            die  Datei  4DESY2.INI  im  Verzeichniss  von  dem aus
  797.            4Desy/2 gestartet wurde.  Diese Datei kann  mit  einem
  798.            ASCII-Editor nachbearbeitet werden.
  799.  
  800.  
  801.  
  802.  
  803. Die Datei 4DESY2.INI
  804. --------------------
  805.  
  806. Die Datei wird durch Drücken von ALT-I angelegt.
  807. In  ihr  werden  die   ganz   normalen   Kommandozeilen-Parameter
  808. gespeichert, mit denen 4Desy/2 ausgefuehrt werden soll.
  809. Beispiel:
  810.  
  811. ------------------4DESY2.INI--------------------
  812. /A
  813. /CF27
  814. /CD30
  815. /CE95
  816. /CT79
  817. /CB48
  818. /CW78
  819. /CH116
  820. /CC121
  821. .arj^(unarj ^|more) & pause
  822. .inf^view
  823. -------------------------------------------------
  824.  
  825. Ganz  links muss ein "/" oder ein "." stehen, damit die
  826. Zeile  von  4Desy/2  erkann  wird.   Abgesehen  von /C und von /F
  827. wird bei allen Schaltern nur  der  erste Buchstabe hinter dem "/"
  828. betrachtet.   Also  bewirken   /A   /AutoSave   /Alpenhorn   alle
  829. lediglich, dass der Auto-Speichern-Modus eingeschaltet wird.
  830.  
  831. Beginnt  eine Zeile mit einem "." dann folgt eine Definition fuer
  832. einen F3-Viewer fuer eine spezielle Dateierweiterung.
  833. Durch die Zeile
  834.  
  835. .arj^(unarj ^|more) & pause
  836.  
  837. wird bei Druck auf  F3  auf  der Datei XYZ.ARJ folgendes Kommando
  838. ausgefuehrt:
  839.  
  840. unarj XYZ.ARJ|more & pause
  841.  
  842.  
  843.  
  844. "OK, wass koss' dat Teil ?"  - CARDWARE
  845. ---------------------------------------
  846.  
  847. Also 4Desy/2 ist NICHT umsonst!
  848. Es wird Dich etwas Zeit und eine 80-Pfennig-Briefmarke kosten !
  849. (wenn die Bundesp*st die Preise nicht mal wieder erhoeht ?)
  850.  
  851. Das   also   ist   CARDWARE   !    Keine   Sharewaregebuehr,   Keine
  852. Registrierungs-Krampf,   Keine  fehlerhafte  Registrier-Schluessel-
  853. Funktion, Keine Programm - Beschraenkungen !
  854.  
  855. ABER:
  856. Ich will eben wissen, wohin  mein Prograemmli so reisen tut...  Also
  857. wenn das Teil gefaellt, oder auch wenn es nicht gefaellt  oder  wenn
  858. Du noch eine Funktion dringend benoetigst (und es sein koennte, dass
  859. andere Leute diese Funktion auch brauchen koennten...?) Oder wenn Du
  860. einfach sonst einen Kommentar loswerden willst, dann:
  861. Postkarte, was draufgeschrieben und ab-die-post !
  862.  
  863. (Adresse siehe oben)
  864.  
  865.  
  866.  
  867. HAFTUNG und Co.
  868. ---------------
  869. OBWOHL DAS PROGRAMM MIT  GROSSER  SORGFALT  GESCHRIEBEN WURDE UND
  870. EINE MEHRSTUFIGE TESTPHASE HINTER  SICH  GEBRACHT  HAT,  KANN  ES
  871. IMMERNOCH SEIN, DASS SICH DER EINE ODER ANDERE FEHLER IM PROGRAMM
  872. VERSTECKT HAT. SO  EIN  UNBEKANNTER  FEHLER  KANN NATUERLICH ALLE
  873. MOEGLICHEN ARTEN VON AUSWIRKUNGEN HABEN. DARUM WILL ICH AN DIESER
  874. STELLE DEUTLICH MACHEN, DASS ICH KEINERLEI HAFTUNG FUER  SCHAEDEN
  875. AN HARDWARE ODER SOFTWARE UEBERNEHMEN KANN, DIE DURCH DAS STARTEN
  876. MEINES  PROGRAMMES  VERURSACHT  WURDEN.  SOLLTEST  DU DAMIT NICHT
  877. EINVERSTANDEN SEIN, SO STARTE DAS PROGRAMM NICHT UND LOESCHE ALLE
  878. ZUM PROGRAMM GEHOERENDEN DATEIEN.
  879.  
  880. DANN KANN AUCH NIX PASSIEREN.....
  881.  
  882.  
  883.  
  884. Copyrights und Trademarks
  885. -------------------------
  886.  
  887. 4OS2  ist (C) und trademark von Rex Conn und JP-Software Inc.
  888. 4DOS  ist (C) und trademark von Rex Conn und JP-Software Inc.
  889. OS/2  ist (C) und trademark von IBM Corporation
  890.  
  891. 4Desy/2 ist (C) 1994 von Wolfram Koerner
  892.         das Programm darf, wenn es im Original-ZIP-Archiv
  893.         und in unveraendertem Zustand komplett mit allen
  894.         Dateien weitergegeben wird frei kopiert und verbreitet
  895.         werden. Weitere Auflagen siehe CARDWARE-Hinweis.
  896.  
  897.  
  898.  
  899. Noch ein Hinweis:
  900. -----------------
  901. Hat  man einmal seine Dateien mit  Beschreibungen versehen, ist es
  902. nuetzlich, wenn diese auch wirklich immer zusammen mit den Dateien
  903. verschoben  /  kopiert   werden.     Fuer   OS/2   gibt  es  einen
  904. Norton-Commander aehnliches Programm  namens "File  Commander  /2"
  905. von Brian Havard. Das Archiv heisst in der Regel fc2###.zip
  906. Abgesehen    von    zahlreichen    nuetzlichen   Funktionen   zum
  907. Dateihandling werden  von  FC2  auch 4OS2-Dateibeschreibungen mit
  908. den Dateien kopiert !
  909. Bitte das Programm  auch  registrieren,  wenn  es laenger benutzt
  910. wird.
  911.  
  912.  
  913. Credits
  914. -------
  915.  
  916. Da auch ein  Programmierer  nicht  ohne  seine Mitmenschen auskommt,
  917. hier ein paar die auch mit der  Entstehung  des  Programmes  zu  tun
  918. hatten:
  919.  
  920. Beta-Tester:     Florian v. Walter (z.B. Editor-Mode /E)
  921.                  Hans-Dieter Stich (z.B. SubDir-merken-Mode /K)
  922.                  Holger Gutschmidt (z.B. Attribute-Anzeige)
  923.  
  924. Waerm-Flasche:   Doro   (sonst   haette   jetzt  ein  Programmierer
  925.                          abgefrorene Fuesse - dito !)
  926.  
  927.  
  928.