home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / oct93 / cli_util / dirs.lha / Dirs / English / dirs.doc < prev    next >
Text File  |  1993-08-26  |  11KB  |  368 lines
  1.  
  2.  
  3.                           Dirs V1.00
  4.  
  5.                   Copyright © 1993 Harald Pehl
  6.                       All rights reserved
  7.  
  8.                            FREEWARE
  9.  
  10.                        With documentation
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17. Preface
  18. -------
  19.  
  20. This program is freeware, this means that you can copy it
  21. freely as long as you don't ask any more money for it than a
  22. nominal fee for copying.  If you want to distribute this program
  23. you should keep this document with it.  This program cannot be
  24. used for commercial purposes without written permission from the
  25. author.
  26.  
  27. If you have suggestions or remarks about this program, or if you
  28. find any bugs, please let me know. Naturaly I won't refuse any
  29. gifts. When sending in bug reports, please state exactly under what
  30. circumstances the bug occurred, what equipment was used and what
  31. happened.  If possible also try to give me enough information to
  32. reproduce the bug.  It is very difficult to find bugs when you
  33. don't know exactly what happened.
  34.  
  35. Write to the following address:
  36.  
  37.         Harald Pehl
  38.         Equarhofen 8
  39.         97215 Uffenheim
  40.         Germany - Europe
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47. Introduction
  48. ------------
  49.  
  50. Dirs is a powerful command that combines the advantages of the List and Dir
  51. command and in addition to that a command which is extremly flexible. Similar to
  52. these MS-DOS computers you can store some of the 22 options you use most in an
  53. environment variable (in the startup-sequence or in the shell-startup). This
  54. environment variable is then interpretated automaticly by the Dirs command.
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Usage
  61. -----
  62.  
  63. Dirs can only be started from the CLI and has fallowing synthax:
  64.  
  65.    Dirs ARGS/M,
  66.         C  =  CLI/S,
  67.         S  =  SINCE/K,
  68.         U  =  UPTO/K,
  69.         AS =  ALPHASORT/S,
  70.        -AS = -ALPHASORT/S,
  71.         SS =  SIZESORT/S,
  72.        -SS = -SIZESORT/S,
  73.         DS =  DATESORT/S,
  74.        -DS = -DATESORT/S,
  75.         Q  =  QUICK/S,
  76.         DO =  DIRSONLY/S,
  77.         FO =  FILESONLY/S,
  78.         FF =  FILESFIRST/S,
  79.         SH =  SHOWHIDDEN,
  80.         NH =  NOHEAD/S,
  81.         NI =  NOINFO/S,
  82.         NS =  NOSIZE/S,
  83.         NP =  NOPROTECT/S,
  84.         ND =  NODATE/S,
  85.         NC =  NOCOMMENT/S,
  86.         V  =  VAR/K,
  87.         HEADFORM/K,
  88.         ?  =  HELP/S,
  89.  
  90.  
  91.  
  92.         The letters in front of the '=' can be used as abbreviations
  93.  
  94.  
  95.  
  96.    The options:
  97.  
  98.         ARGS/M:
  99.          Here you can specify several files and directories which should be
  100.          displayed. Of course you can use a joker ('#', '?', '#?'...).
  101.          If you leave out this option the current directory is displayed.
  102.  
  103.         C  =  CLI/S:
  104.          If you declare this option the source of the arguments is the CLI and
  105.          environment variables are neglected. Supposing that the content of the
  106.          environment variable is: 'alphasort noprotect nocomment', then the
  107.          output is sorted (A-Z), the protection bits and the comment are hidden.
  108.          Now it is still possible to hide also the size by typing 'dirs nosize'.
  109.          But if one want an output sorted by size one must use fallowing:
  110.          'dirs CLI sizesort'. (Now the environment variable is not aautomaticly
  111.          read out and the default settings are predominant).
  112.    
  113.         S  =  SINCE/K:
  114.          Only files and directories since a certain date or time are displayed.
  115.          You can use 'tomorrow', 'yesterday' or 'today' to refer to a certain
  116.          day.
  117.  
  118.         U  =  UPTO/K:
  119.          Only files and directories upto a certain date or time are displayed.
  120.          You can use 'tomorrow', 'yesterday' or 'today' to refer to a certain
  121.          day.
  122.  
  123.         AS =  ALPHASORT/S:
  124.          The files and directories are sorted by name (A-Z, no case sensetive).
  125.  
  126.        -AS = -ALPHASORT/S:
  127.          Reverses the order of ALPHASORT.
  128.  
  129.         SS =  SIZESORT/S:
  130.          The files are sorted by size (smallest-biggest).
  131.  
  132.        -SS = -SIZESORT/S:
  133.          Reverses the order of SIZESORT.
  134.  
  135.         DS =  DATESORT/S:
  136.          The files and directories are sorted by date and time (oldest-today).
  137.  
  138.        -DS = -DATESORT/S
  139.          Reverses the order of DATESORT.
  140.  
  141.         Q  =  QUICK/S
  142.          Choosing this option, only the name of the files and directories is
  143.          displayed. 'QUICK' has no effect on the sortmode.
  144.  
  145.         DO =  DIRSONLY/S:
  146.           Only directories are displayed.
  147.  
  148.         FO =  FILESONLY/S:
  149.          This is the opposite of the option 'DIRSONLY' and -unbelievable but
  150.          true- displays only files.
  151.  
  152.         FF =  FILESFIRST/S:
  153.          Normaly Dirs first displays directories and then files. Using this
  154.          option you can turn araound this order.
  155.  
  156.         SH =  SHOWHIDDEN:
  157.          Dirs looks after the protectionbit 'h' (Hidden-Flag) and does not
  158.          display files and directories with this bit. If you use 'SHOWHIDDEN'
  159.          these files and directories are also displayed.
  160.  
  161.         NH =  NOHEAD/S:
  162.          This option causes that no statusbar is displayed.
  163.  
  164.         NI =  NOINFO/S:
  165.         NS =  NOSIZE/S:
  166.         NP =  NOPROTECT/S:
  167.         ND =  NODATE/S:
  168.         NC =  NOCOMMENT/S:
  169.          These five options hide certain files or information:
  170.             - .info-files
  171.             - the size of files (no '(dir)' with directories)
  172.             - the protection bits
  173.             - the date and time
  174.             - the comment
  175.  
  176.         V  =  VAR/K:
  177.          By default dirs searches for the environment variable 'DIRCMD' and
  178.          reads out its content. If you like to make Dirs read out a certain
  179.          environment variable, then you can use the option 'VAR'. For instance
  180.          if you like to reado out the environment variable 'dirvar', you can
  181.          use one of the fallowing ways:
  182.             1. Dirs VAR=dirvar
  183.             2. Dirs V dirvar
  184.             3. Dirs V=ENV:dirvar
  185.          If you leave out the path of the environment variable (1. and 2.
  186.          example) the variable is searched in ENV:
  187.  
  188.         HEADFORM/K:
  189.          Here you can define the format of the status bar (by default that is
  190.          '<»--«>'). If you type 'Dirs HEADFORM " -Hallo- " you get something
  191.          like this:
  192.          '35 Directories -Hallo- 2 Files -Hallo- 103514 Bytes used'
  193.  
  194.         ?  =  HELP/S:
  195.          This option displays a short helptext
  196.  
  197.  
  198.  
  199.  
  200. Beispiele
  201. ---------
  202.  
  203. The fallowing examples refers to this environmen variable:
  204. 'ALPHASORT NOPROTECT NOCOMMENT NOINFO'
  205.  
  206. 1. Dirs ENV: s:#?-startup
  207.  
  208. Directory: ›1mENV:›0m
  209.  
  210.    BootX                     (dir)   Today     10:11:16
  211.    EGS                       (dir)   Today     10:11:15
  212.    HDMenu                    (dir)   Today     10:11:15
  213.    sys                       (dir)   Today     10:11:16
  214.    DIRCMD                       36   Today     10:11:18
  215.  
  216. 4 Directories  <»--«>  1 File  <»--«>  36 Bytes used
  217.  
  218.  
  219. Directory: ›1ms:›0m
  220.  
  221.    Ed-startup                  616   24-Apr-78 19:39:48
  222.    shell-startup               162   08-Sep-92 20:32:53
  223.    user-startup                408   30-Jun-93 17:57:57
  224.  
  225. 3 Files  <»--«>  1186 Bytes used
  226.  
  227.  
  228.  
  229. 2. Dirs l: c -ss nd headform = "  -<>-  "
  230.  
  231. Directory: ›1ml:›0m
  232.  
  233.    MessyFileSystem           24068   ----rwed
  234.    bootram-handler           20400   ----rwed
  235.    FastFileSystem            12248   ----rw-d
  236.    dmouse-handler             9408   --p-rwed
  237.    ASH                        7932   --p-rw-d
  238.    Newcon-Handler             7532   ----rw-d
  239.    Shell-Seg                  7116   --p-rw-d
  240.    Ram-Handler                6464   ----rw-d
  241.    speak-handler              4188   ----rw-d
  242.    Pipe-Handler               3332   ----rw-d
  243.    queue-handler              2664   ----rw-d
  244.    aux-handler                2392   ----rw-d
  245.    Disk-Validator             1848   ----rw-d
  246.    port-handler               1364   ----rw-d
  247.    UnixDirs-Handler            984   ----rwed
  248.    null-handler                908   --p-rwed
  249.    ConHandler                  176   --p-rwed
  250.  
  251. 17 Files  -<>-  113024 Bytes used
  252.  
  253.  
  254.  
  255. 3. Dirs c:d#? cli ff dh0:#?.info dh0:M#? tools/virenkiller/#?(b|x)#? noinfo
  256.    nocomment MaxonC/Source/#?.c ds
  257.  
  258. Directory: ›1mc:›0m
  259.  
  260.    dmouse                    10376   --p-rwed   22-Aug-92 17:27:13
  261.    disdf                      8096   ----rwed   23-Aug-92 13:16:36
  262.    DiskDoctor                 7112   --p-rwed   23-Aug-92 18:23:51
  263.    DiskChange                  312   --p-rwed   23-Aug-92 18:23:50
  264.    Dir                        3440   --p-rwed   23-Aug-92 18:23:49
  265.    Delete                     1972   --p-rwed   23-Aug-92 18:23:48
  266.    Date                       1092   --p-rwed   23-Aug-92 18:23:46
  267.    Display                   21044   ----rwed   23-Aug-92 22:18:09
  268.    Decrunch                   3624   --p-rwed   27-Aug-92 20:24:09
  269.    disksalv                  33364   ----rwed   27-Aug-92 21:54:48
  270.    DOpusRT                    4216   ----rwed   21-Jan-93 10:47:17
  271.    dirs                       9768   ----rwed   Thursday  22:10:27
  272.  
  273. 12 Files  <»--«>  104416 Bytes used
  274.  
  275.  
  276. Directory: ›1mdh0:›0m
  277.  
  278.    Musik                     (dir)   ----rwed   04-Jan-78 07:45:00
  279.    Mathe                     (dir)   ----rwed   04-Jan-78 14:14:06
  280.    MonitorStore              (dir)   ----rwed   22-Aug-92 03:17:01
  281.    Monitors                  (dir)   ----rwed   14-Nov-92 20:40:59
  282.    MaxonWORD                 (dir)   ----rwed   30-Apr-93 17:31:39
  283.    MaxonMAGIC                (dir)   ----rwed   01-May-93 18:31:06
  284.    MaxonC                    (dir)   ----rwed   31-Jul-93 15:32:01
  285.  
  286. 7 Directories
  287.  
  288.  
  289. Directory: ›1mTools/Virenkiller/›0m
  290.  
  291.    EarlyExplode                252   ----rwed   14-Oct-92 19:07:34
  292.    LVD1.74                    3840   ----rwed   14-Oct-92 19:07:33
  293.    EVW2.22                    3536   ----rwed   14-Oct-92 19:07:29
  294.    Virus_Checker             26312   ----rwed   29-Nov-92 21:21:36
  295.    VT                        (dir)   ----rwed   04-Jan-78 07:46:41
  296.    VirusZ                    (dir)   ----rwed   29-Nov-92 22:00:50
  297.    BootX                     (dir)   ----rwed   29-Nov-92 22:03:28
  298.  
  299. 3 Directories  <»--«>  4 Files  <»--«>  33940 Bytes used
  300.  
  301.  
  302. Directory: ›1mMaxonC/Source/›0m
  303.  
  304.    BOOPSI.c                   1964   ----rwed   11-Jan-78 07:07:59
  305.    wbstart.c                   971   ----rwed   08-Dec-92 20:50:10
  306.    NewBorder.c                2002   ----rwed   23-Mar-93 14:44:08
  307.    font.c                      933   ----rw-d   23-Mar-93 15:09:26
  308.    Prim.c                      552   ----rwed   25-Apr-93 14:37:12
  309.    change.c                   3631   ----rwed   25-Apr-93 15:37:27
  310.    maxwin.c                    814   ----rwed   27-Apr-93 15:54:13
  311.    optimizewin.c               604   ----rwed   27-Apr-93 16:00:09
  312.    speicher.c                 2108   ----rwed   08-Jun-93 12:01:28
  313.    AmigaMagazinPrim.c           51   ----rwed   27-Jun-93 18:18:24
  314.    dirs_inter.c              17367   ----rwed   01-Aug-93 13:08:06
  315.    cout.c                     3130   ---arwed   04-Aug-93 19:20:48
  316.    mydate.c                   2397   ----rwed   Thursday  11:05:28
  317.    dirs.c                    16451   ----rwed   Thursday  22:39:52
  318.  
  319. 14 Files  <»--«>  52975 Bytes used
  320.  
  321.  
  322.  
  323.  
  324.  
  325. Description
  326. -----------
  327.  
  328. Dirs is written in C++ and compiled under MaxonC++. I use the ReadArgs()
  329. function of the DOS-Library to evaluate the arguments. A very impotant part of
  330. my program are the two classes 'List' and 'Entry' in which I store the datas
  331. in a certain order depending on the sortmode. At last I display a string filled
  332. with certain information depending on the arguments.
  333.  
  334.  
  335.  
  336.  
  337.  
  338. © 1993 Dirs V1.00 written by Harald Pehl
  339.                   Greeting to Florian Derks and Martin Gleiß.
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.