home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / oct93 / cli_util / dirs.lha / Dirs / Deutsch / dirs.dok < prev    next >
Text File  |  1993-08-26  |  14KB  |  406 lines
  1.  
  2.  
  3.                           Dirs V1.00
  4.  
  5.                   Copyright © 1993 Harald Pehl
  6.                      Alle Rechte reserviert
  7.  
  8.                             FREEWARE
  9.  
  10.                          Mit  Anleitung
  11.  
  12.  
  13.  
  14.  
  15.  
  16. Vorwort
  17. -------
  18.  
  19. Dieses Programm ist Freeware, das bedeutet, daß Sie es frei weiter-
  20. kopieren können, solange Sie nicht mehr Geld verlangen, als eine normale
  21. Gebühr für die Kopie. Wenn Sie dieses Programm verbreiten wollen, sollten
  22. Sie auch dieses Dokument mitverbreiten. Dieses Programm kann nicht ohne
  23. die schriftliche Erlaubnis des Autors zum kommerziellen Verkauf angeboten
  24. werden.
  25.  
  26. Wenn Sie irgendwelche Vorschläge oder Gedanken zum Programm haben, so
  27. lassen Sie mich davon wissen. Natürlich bin ich auch für jede Art von
  28. Geschenken dankbar!!
  29.  
  30. Schreiben Sie an folgende Adresse :
  31.  
  32.         Harald Pehl
  33.         Equarhofen 8
  34.         97215 Uffenheim
  35.         Germany - Europe
  36.  
  37.  
  38.  
  39.  
  40.  
  41. Einleitung
  42. ----------
  43.  
  44. Dirs ist ein mächtiger Befehl, der die Vorteile der Befehle List und Dir in sich
  45. vereinigt und dazu noch sehr flexibel ist. Ähnlich wie bei den MS-DOSen kann man
  46. sich die am häufigsten der immerhin 22 Optionen in einer Variable abspeichern
  47. (am besten in der startup-sequence oder der shell-startup). Diese Variable oder
  48. -falls in der Befehlszeile angegeben eine andere Variable- wird dann automatisch
  49. von Dirs eingelesen und ausgewertet. So kann man sich ganz einfach seinen
  50. 'Lieblings-Dirs-Befehl' zusammenstellen.
  51.  
  52.  
  53.  
  54.  
  55. Programmaufruf
  56. --------------
  57.  
  58. Dirs ist nur über das CLI aufrufbar, und hat folgende Synthax:
  59.  
  60.    Dirs ARGS/M,
  61.         C  =  CLI/S,
  62.         S  =  SINCE/K,
  63.         U  =  UPTO/K,
  64.         AS =  ALPHASORT/S,
  65.        -AS = -ALPHASORT/S,
  66.         SS =  SIZESORT/S,
  67.        -SS = -SIZESORT/S,
  68.         DS =  DATESORT/S,
  69.        -DS = -DATESORT/S,
  70.         Q  =  QUICK/S,
  71.         DO =  DIRSONLY/S,
  72.         FO =  FILESONLY/S,
  73.         FF =  FILESFIRST/S,
  74.         SH =  SHOWHIDDEN,
  75.         NH =  NOHEAD/S,
  76.         NI =  NOINFO/S,
  77.         NS =  NOSIZE/S,
  78.         NP =  NOPROTECT/S,
  79.         ND =  NODATE/S,
  80.         NC =  NOCOMMENT/S,
  81.         V  =  VAR/K,
  82.         HEADFORM/K,
  83.         ?  =  HELP/S,
  84.  
  85.  
  86.  
  87.    Erklärung der Abkürzungen:
  88.  
  89.         Option/K          Bei dieser Option handelt es sich um ein Schlüsselwort,
  90.                           das zusammen mit dem entsprechenden Argument angegeben
  91.                           werden muß (K = Keyword).
  92.         Schalter/S        Wird dieser Begriff angegeben, ist der Schalter
  93.                           eingeschaltet, andernfalls nicht.
  94.         Argument/M        An dieser Position können ein oder mehrere Argumente
  95.                           angegeben werden.
  96.  
  97.         Die Buchstaben vor dem '=' können als Abkürzungen für die Parameter
  98.         verwendet werden.
  99.  
  100.  
  101.  
  102.    Erklärung der Parameter:
  103.  
  104.         ARGS/M:
  105.          Hier können Sie mehrere Dateien und Verzeichnisse angeben, die
  106.          hintereinander aufgelistet werden. Jokerzeichen wie '#', '?' und '#?'
  107.          können verwendet werden. Falls dieser Parameter ganz weggelassen
  108.          wird, liest dirs das aktuelle Verzeichnis ein.
  109.  
  110.         C  =  CLI/S:
  111.          Bei Angabe dieses Parameters, werden die Argumente NUR übers CLI
  112.          eingelesen und eine eventuell vorhandene ENV-Variable wird nicht
  113.          berücksichtigt. Steht in der ENV-Variable z.B. 'alphasort noprotect
  114.          nocomment', dann werden die Daten alphabetisch sortiert (A-Z), ohne
  115.          Ausgabe der Schutzbits und ohne Kommentar ausgegeben. Es ist jetzt
  116.          möglich zusätzlich auch die Größenangabe zu unterdrücken, indem man im
  117.          CLI eingibt 'dirs nosize'. Will man jedoch nicht alphabetisch sondern
  118.          nach Größe sortieren lassen, so muß man im CLI eingeben 'dirs CLI
  119.          sizesort' eingeben (nun wird die Umgebungsvariable nicht mehr
  120.          automatisch eingelesen und die Grundeinstellungen sind nun wirksam).
  121.          Mit Hilfe der CLI-Option kann man also auch ganz einfach das Auslesen
  122.          der Umgebungsvariable aus- und die Grundeinstellungen einschalten.
  123.  
  124.         S  =  SINCE/K:
  125.          Es werden nur Dateien und Verzeichnisse seit einem bestimmten Datum
  126.          oder seit einer bestimmten Uhrzeit ausgegeben. Sie können auch
  127.          tomorrow, yesterday oder today angeben um Dateien und Verzeichnisse
  128.          seit morgen, gestern oder heute anzusehen.
  129.  
  130.         U  =  UPTO/K:
  131.          Es werden nur Dateien und Verzeichnisse bis zu einem bestimmten Datum
  132.          oder bis zu einer bestimmten Uhrzeit ausgegeben. Sie können auch
  133.          tomorrow, yesterday oder today angeben um Dateien und Verzeichnisse
  134.          die vor dem morgigen, gestrigen oder heutigen Tag erstellt wurden
  135.          anzusehen.
  136.  
  137.         AS =  ALPHASORT/S:
  138.          Die Dateien und Verzeichnisse werden alphabetisch sortiert und zwar
  139.          von A-Z ohne daß dabei zwischen Groß- und Kleinschreibung unterschieden
  140.          wird.
  141.  
  142.        -AS = -ALPHASORT/S:
  143.          Dreht die Sortierreihenfolge von ALPHASORT um.
  144.  
  145.         SS =  SIZESORT/S:
  146.          Die Dateien werden der Größe nach sortiert. Es werden zuerst die
  147.          kleinsten Dateien und dann die größeren angezeigt.
  148.    
  149.        -SS = -SIZESORT/S:
  150.          Dreht die Sortierreihenfolge von SIZESORT um.
  151.  
  152.         DS =  DATESORT/S:
  153.          Die Dateien und Verzeichnisse werden nach ihrem Datum sortiert
  154.          ausgegeben. Dabei werden zuerst die älteren Dateien und dann die
  155.          neueren ausgegeben. Haben zwei Dateien oder zwei Verzeichnisse das
  156.          gleiche Datum, werden die zwei Uhrzeiten miteinander verglichen.
  157.  
  158.        -DS = -DATESORT/S
  159.          Dreht die Sortierreihenfolge von DATESORT um.
  160.  
  161.         Q  =  QUICK/S
  162.          Bei angabe dieses Parameters werden lediglich die Dateinamen
  163.          ausgegeben. Weiterhin wird keine Kopf- und Fußzeile ausgegeben.
  164.          Die Option 'QUICK' hat jedoch keinen Einfluß auf den Sortiermodus.
  165.  
  166.         DO =  DIRSONLY/S:
  167.           Es werden nur Verzeichnisse ausgegeben.
  168.  
  169.         FO =  FILESONLY/S:
  170.          Diese Option stellt das Gegenteil zu 'DIRSONLY' dar und gibt -wer
  171.          hätte das gedacht- nur Dateien aus.
  172.  
  173.         FF =  FILESFIRST/S:
  174.          Normalerweise werden zuerst die Verzeichnisse und danach die Dateien
  175.          ausgegeben, sollte jemanden diese Reihenfolge stören so kann er sie
  176.          mit Hilfe dieses Parameters umstellen und zuerst die Dateien und
  177.          danach die Verzeichnisse ausgeben lassen.
  178.  
  179.         SH =  SHOWHIDDEN:
  180.          Dirs berücksichtigt bei der Ausgabe der Verzeichnisse und Dateien das
  181.          Schutzbit 'h' (Hidden-Flag) und zeigt Dateien mit diesem Bit nicht an.
  182.          Mit der Option 'SHOWHIDDEN' werden diese Dateien jedoch mitangezeigt.
  183.  
  184.         NH =  NOHEAD/S:
  185.          Dieser Parameter bewirkt, daß keine Kopf- und Fußzeile angezeigt wird.
  186.    
  187.         NI =  NOINFO/S:
  188.         NS =  NOSIZE/S:
  189.         NP =  NOPROTECT/S:
  190.         ND =  NODATE/S:
  191.         NC =  NOCOMMENT/S:
  192.          Diese fünf Parameter blenden bestimmte Dateien bzw. Informationen aus:
  193.          (von oben nach unten)
  194.             - .info-Dateien
  195.             - die Größenangabe (bei Verzeichnissen wird das '(dir)'
  196.               ausgeblendet)
  197.             - die Schutzbits
  198.             - das Datum und die Uhrzeit
  199.             - der Kommentar
  200.  
  201.         V  =  VAR/K:
  202.          Standardmäßig wird nach einer Umgebungsvariablen namens 'DIRCMD'
  203.          gesucht und falls gefunden ausgelesen. Wenn Sie jedoch eine ganz
  204.          bestimmte Umgebungsvariable einlesen wollen, die nicht 'DIRCMD' heißt,
  205.          dann können Sie den Parameter 'VAR' dazu benutzen um Dirs mitzuteilen
  206.          wie die Variable heißt. Wenn Sie also z.B. eine Umgebungsvariable
  207.          namens 'dirvar' einlesen wollen, können Sie eine der folgenden Wege
  208.          benutzen:
  209.             1. Dirs VAR=dirvar
  210.             2. Dirs V dirvar
  211.             3. Dirs V=ENV:dirvar
  212.          Wenn Sie wie bei 1. und 2. den Pfad der Variablen weglassen wird sie
  213.          automatisch im ENV:-Verzeichniss gesucht.
  214.  
  215.         HEADFORM/K:
  216.          Hier können Sie -als kleine Spielerei- die Zeichenkette die in der
  217.          Fußzeile erscheint selbst bestimmen (standardmäßig ist das '<»--«>').
  218.          Wenn Sie also z.B. 'Dirs HEADFORM " -Hallo- " schreiben bekommen
  219.          sie in etwa folgende Fußzeile:
  220.          '35 Verzeichnisse -Hallo- 2 Dateien -Hallo- 103514 Bytes benutzt'
  221.  
  222.         ?  =  HELP/S:
  223.          Sobald diese Option in den Argumenten erscheint, wird eine
  224.          Kuzübersicht über die Parameter, deren Wirkung und Grundeinstellungen
  225.          angezeigt.
  226.  
  227.  
  228.  
  229.  
  230. Beispiele
  231. ---------
  232.  
  233. Die folgenden Beispiele beziehen sich alle auf meinen Computer und einer
  234. Umgebungsvariable DIRCMD, die folgendes enthält: 'ALPHASORT NOPROTECT NOCOMMENT
  235. NOINFO'
  236.  
  237. 1. Dirs ENV: s:#?-startup
  238.  
  239. Verzeichnis: ›1mENV:›0m
  240.  
  241.    BootX                     (dir)   Today     10:11:16
  242.    EGS                       (dir)   Today     10:11:15
  243.    HDMenu                    (dir)   Today     10:11:15
  244.    sys                       (dir)   Today     10:11:16
  245.    DIRCMD                       36   Today     10:11:18
  246.  
  247. 4 Verzeichnisse   <»--«>   1 Datei   <»--«>   36 Bytes benutzt
  248.  
  249.  
  250. Verzeichnis: ›1ms:›0m
  251.  
  252.    Ed-startup                  616   24-Apr-78 19:39:48
  253.    shell-startup               162   08-Sep-92 20:32:53
  254.    user-startup                408   30-Jun-93 17:57:57
  255.  
  256. 3 Dateien   <»--«>   1186 Bytes benutzt
  257.  
  258.  
  259.  
  260. 2. Dirs l: c -ss nd headform = "  -<>-   "
  261.  
  262. Verzeichnis: ›1ml:›0m
  263.  
  264.    MessyFileSystem           24068   ----rwed
  265.    bootram-handler           20400   ----rwed
  266.    FastFileSystem            12248   ----rw-d
  267.    dmouse-handler             9408   --p-rwed
  268.    ASH                        7932   --p-rw-d
  269.    Newcon-Handler             7532   ----rw-d
  270.    Shell-Seg                  7116   --p-rw-d
  271.    Ram-Handler                6464   ----rw-d
  272.    speak-handler              4188   ----rw-d
  273.    Pipe-Handler               3332   ----rw-d
  274.    queue-handler              2664   ----rw-d
  275.    aux-handler                2392   ----rw-d
  276.    Disk-Validator             1848   ----rw-d
  277.    port-handler               1364   ----rw-d
  278.    UnixDirs-Handler            984   ----rwed
  279.    null-handler                908   --p-rwed
  280.    ConHandler                  176   --p-rwed
  281.  
  282. 17 Dateien  -<>-  113024 Bytes benutzt
  283.  
  284.  
  285.  
  286. 3. Dirs c:d#? cli ff dh0:#?.info dh0:M#? tools/virenkiller/#?(b|x)#? noinfo
  287.    nocomment MaxonC/Source/#?.c ds
  288.  
  289. Verzeichnis: ›1mc:›0m
  290.  
  291.    dmouse                    10376   --p-rwed   22-Aug-92 17:27:13
  292.    disdf                      8096   ----rwed   23-Aug-92 13:16:36
  293.    DiskDoctor                 7112   --p-rwed   23-Aug-92 18:23:51
  294.    DiskChange                  312   --p-rwed   23-Aug-92 18:23:50
  295.    Dir                        3440   --p-rwed   23-Aug-92 18:23:49
  296.    Delete                     1972   --p-rwed   23-Aug-92 18:23:48
  297.    Date                       1092   --p-rwed   23-Aug-92 18:23:46
  298.    Display                   21044   ----rwed   23-Aug-92 22:18:09
  299.    Decrunch                   3624   --p-rwed   27-Aug-92 20:24:09
  300.    disksalv                  33364   ----rwed   27-Aug-92 21:54:48
  301.    DOpusRT                    4216   ----rwed   21-Jan-93 10:47:17
  302.    dirs                       9768   ----rwed   Thursday  22:10:27
  303.  
  304. 12 Dateien   <»--«>   104416 Bytes benutzt
  305.  
  306.  
  307. Verzeichnis: ›1mdh0:›0m
  308.  
  309.    Musik                     (dir)   ----rwed   04-Jan-78 07:45:00
  310.    Mathe                     (dir)   ----rwed   04-Jan-78 14:14:06
  311.    MonitorStore              (dir)   ----rwed   22-Aug-92 03:17:01
  312.    Monitors                  (dir)   ----rwed   14-Nov-92 20:40:59
  313.    MaxonWORD                 (dir)   ----rwed   30-Apr-93 17:31:39
  314.    MaxonMAGIC                (dir)   ----rwed   01-May-93 18:31:06
  315.    MaxonC                    (dir)   ----rwed   31-Jul-93 15:32:01
  316.  
  317. 7 Verzeichnisse
  318.  
  319.  
  320. Verzeichnis: ›1mTools/Virenkiller/›0m
  321.  
  322.    EarlyExplode                252   ----rwed   14-Oct-92 19:07:34
  323.    LVD1.74                    3840   ----rwed   14-Oct-92 19:07:33
  324.    EVW2.22                    3536   ----rwed   14-Oct-92 19:07:29
  325.    Virus_Checker             26312   ----rwed   29-Nov-92 21:21:36
  326.    VT                        (dir)   ----rwed   04-Jan-78 07:46:41
  327.    VirusZ                    (dir)   ----rwed   29-Nov-92 22:00:50
  328.    BootX                     (dir)   ----rwed   29-Nov-92 22:03:28
  329.  
  330. 3 Verzeichnisse   <»--«>   4 Dateien   <»--«>   33940 Bytes benutzt
  331.  
  332.  
  333. Verzeichnis: ›1mMaxonC/Source/›0m
  334.  
  335.    BOOPSI.c                   1964   ----rwed   11-Jan-78 07:07:59
  336.    wbstart.c                   971   ----rwed   08-Dec-92 20:50:10
  337.    NewBorder.c                2002   ----rwed   23-Mar-93 14:44:08
  338.    font.c                      933   ----rw-d   23-Mar-93 15:09:26
  339.    Prim.c                      552   ----rwed   25-Apr-93 14:37:12
  340.    change.c                   3631   ----rwed   25-Apr-93 15:37:27
  341.    maxwin.c                    814   ----rwed   27-Apr-93 15:54:13
  342.    optimizewin.c               604   ----rwed   27-Apr-93 16:00:09
  343.    speicher.c                 2108   ----rwed   08-Jun-93 12:01:28
  344.    AmigaMagazinPrim.c           51   ----rwed   27-Jun-93 18:18:24
  345.    dirs_inter.c              17367   ----rwed   01-Aug-93 13:08:06
  346.    cout.c                     3130   ---arwed   04-Aug-93 19:20:48
  347.    mydate.c                   2397   ----rwed   Thursday  11:05:28
  348.    dirs.c                    16451   ----rwed   Thursday  22:39:52
  349.  
  350. 14 Dateien   <»--«>   52975 Bytes benutzt
  351.  
  352. Anm.: Das Verzeichniss DH0:#?.info kann nicht ausgegeben werden, da die
  353.       .info-Dateien schon durch die Option 'noinfo' ausgeblendet werden.
  354.  
  355.  
  356.  
  357.  
  358.  
  359. Beschreibung
  360. ------------
  361.  
  362. Dirs ist ein in C++ programmierter Befehl, der unter MaxonC++ compiliert
  363. wurde. Bei der Auswertung der Parameter greife ich auf die Funktion ReadArgs()
  364. der DOS-Library zurück, die mir die Ergebnisse in einen Speicherbereich schreibt
  365. (in diesem Fall in eine struct) aus der ich sie wunderbar auslesen kann und
  366. dementsprechend weitere structs u.ä. initialisieren und allokieren kann. Ein
  367. weiterer wichtiger Bestandteil meines Programmes sind die beiden Klassen, die
  368. zusammen eine doppelt verkettete Liste darstellen und in die ich am Anfang je nach
  369. Sortiermodus die Daten aus einem Verzeichniss in einer bestimmten Reihenfolge
  370. einlese. Schließlich wird am Ende ein String ausgegeben, in den je nach
  371. Parameter verschiedene Informationen eingebaut werden.
  372.  
  373.  
  374.  
  375.  
  376. © 1993 Dirs V1.00 geschrieben von Harald Pehl
  377.                   Grüße an Florian Derks und Martin Gleiß.
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.