home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d07xx / d0784.lha / DirKing / UserManual.doc < prev    next >
Text File  |  1992-12-23  |  89KB  |  1,794 lines
  1.  
  2.                   __
  3.                  / ////
  4.           __    ///
  5.           \ \  ///          < < <<<  DirKing v2.10e  >>> > >
  6.            \ \///
  7.             \__////        USER MANUAL - Release : 22-Nov-92
  8.  
  9.                 Copyright ⌐1991-1992 Chris P. Vandierendonck, [AmiSYS].
  10.  
  11.        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  12.        Copyright Notice
  13.        ~~~~~~~~~~~~~~~~
  14.          DirKing  is  released  as  SHAREWARE, not excluding the copyright
  15.          and all other rights  which  remain  with  the  author  Chris  P.
  16.          Vandierendonck.  The  program  and  files  included   with   this
  17.          distribution are not freely distributable. Shareware  means  that
  18.          you must register if you use the program.
  19.  
  20.          Prior  written  permission  from  the  author  is   required   to
  21.          distribute  DirKing  or to use  it  in  commercial  releases,  on
  22.          coverdisks or diskmagazines. When distributed, all files must  be
  23.          kept together, in the original unmodified form. 
  24.  
  25.          (AmigaDOS is a trademark of Commodore Amiga Inc.)
  26.  
  27.        Disclaimer
  28.        ~~~~~~~~~~
  29.          DirKing  is  provided  "AS  IS",  WITHOUT  ANY  WARRANTY  to  its
  30.          quality, performance or fitness for a particular purpose.  In  no
  31.          event shall the author be liable or responsible to  the  user  or
  32.          any other person, for any kind of damage caused  by  the  use  of
  33.          this software.
  34.  
  35.          Registering   for   DirKing  is  necessary   to   ensure   future
  36.          development. More information on how to register can be found  in
  37.          this document or in the "Registration.doc".
  38.  
  39.          Registrations, suggestions, remarks and bug  reports  about  this
  40.          program can be send to the following address :
  41.  
  42.               Chris Vandierendonck
  43.               Koning Albertstraat 188
  44.             B-8210   VELDEGEM
  45.               BELGIUM
  46.  
  47.        Preface
  48.        ~~~~~~~
  49.          DirKing  is  a  feature  packed  directory  list  program,  which
  50.          overlaps the AmigaDOS commands List, Dir and  Info.  It  has  all
  51.          the features of the AmigaDOS commands,  but  also  includes  many
  52.          enhancements. The program supports different filter  for  reading
  53.          a directory, allows complex sorting and  gives  full  control  on
  54.          the listing format.   
  55.  
  56.          DirKing is reentrant, so it can be made resident.
  57.  
  58.        System Requirements
  59.        ~~~~~~~~~~~~~~~~~~~
  60.          DirKing v2.10 requires AmigaDOS v1.2 or higher.
  61.  
  62.  
  63.  
  64.                                         DirKing v2.10 User Manual - Page 1
  65.  
  66.        Shareware Registration
  67.        ~~~~~~~~~~~~~~~~~~~~~~
  68.          Registering for  DirKing  ensures  future  development  of  this
  69.          software. You can register under the following conditions :
  70.  
  71.          o See  "Registration.doc" for  more  information,  and  for  the
  72.            registration fee in US dollars, GB  pounds,  German  marks  or
  73.            Belgian franks.
  74.  
  75.          o The base fee is  US$  12.00.  This  fee  covers  a  registered
  76.            version of DirKing (English, German, French or Ducth  version)
  77.            and one free update. 
  78.  
  79.          The following  additional products can only be obtained when you
  80.          pay the base fee, or if you're  already  a  registered  user  of
  81.          DirKing :
  82.  
  83.          o You can order DirKing in  other  language  versions  (English,
  84.            German, French or Dutch) at the price of US$ 6.00. 
  85.  
  86.            NOTE: the one  free  update  in  the  base  registration  fee,
  87.                   doesn't apply for these extra version ordered!!
  88.  
  89.            REMARK: only the program itself supports these languages,  the
  90.                    DirKing documents are only  in  the  english  language
  91.                    (but the user manual is adapted  for  those  functions
  92.                    which use language specific arguments).
  93.  
  94.          o A  laser  printed  copy  of  this  user  manual,  and  related
  95.            documents can be obtained for US$ 6.00 (price per version). 
  96.  
  97.          o All above mentioned amounts include P&P. So you don't have  to
  98.            pay extra, wherever you live.
  99.  
  100.          o You can transfer the money in three ways :
  101.              - in cash (PAPER money ONLY) -> fast and cheap;
  102.              - by EuroCheck (only in Belgian Francs [BEF] !!);
  103.              - by (international) postal money order.
  104.            DO NOT SEND FOREIGN BANKCHECKS, since  it's too  expensive  to
  105.            clear them.
  106.  
  107.          o If  possible,  please  use  a   printout   of   the   included
  108.            'RegForm' file to register.
  109.  
  110.          o From the moment I receive the registration  (order)  form  and
  111.            the necessary payments, your order will be processed.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                         DirKing v2.10 User Manual - Page 2
  129.  
  130.        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  131.                              USER MANUAL CONTENTS  
  132.        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  133.          º1  Preliminary remarks. . . . . . . . . . . . . . . . . . .  4
  134.          º2  DirKing keyword and argument syntax. . . . . . . . . . .  5
  135.          º3  Directory scanning . . . . . . . . . . . . . . . . . . .  5
  136.              A. Specifying the directory path . . . . . . . . . . . .  5
  137.                 A.1. Normal directory paths . . . . . . . . . . . . .  5
  138.                      a. General use . . . . . . . . . . . . . . . . .  5
  139.                      b. Advanced use : recursive directory paths. . .  6
  140.                 A.2. Deep level pattern matching. . . . . . . . . . .  6
  141.              B. Filtering directory information . . . . . . . . . . .  7
  142.                 B.1. Global filters . . . . . . . . . . . . . . . . .  8
  143.                 B.2. Filter options . . . . . . . . . . . . . . . . .  8
  144.                 B.3. File- and directoryname filtering. . . . . . . .  9
  145.                 B.4. Conditional date filters . . . . . . . . . . . . 10
  146.              C. Tracing the scanning process. . . . . . . . . . . . . 11
  147.          º4  Directory information. . . . . . . . . . . . . . . . . . 12
  148.              A. Volume (disk) information . . . . . . . . . . . . . . 12
  149.              B. Listing header/end information. . . . . . . . . . . . 13
  150.              C. File- and directory fields. . . . . . . . . . . . . . 15
  151.          º5  Directory sorting. . . . . . . . . . . . . . . . . . . . 16
  152.          º6  Listing formatting . . . . . . . . . . . . . . . . . . . 17
  153.              A. Listing table formatting. . . . . . . . . . . . . . . 17
  154.                 A.1. Setting the listing table width. . . . . . . . . 17
  155.                 A.2. Formatting the listing table . . . . . . . . . . 18
  156.              B. Predefined listing table formats. . . . . . . . . . . 20
  157.              C. Free formatting and script generation (LFORMAT) . . . 21
  158.          º7  DirKing MULTI-mode (multiple directory scanning) . . . . 22
  159.          º8  Listing styles . . . . . . . . . . . . . . . . . . . . . 23
  160.              A. Information format. . . . . . . . . . . . . . . . . . 23
  161.              B. Listing print styles. . . . . . . . . . . . . . . . . 23
  162.          º9  Listing output redirection . . . . . . . . . . . . . . . 24
  163.          º10 Listing paging . . . . . . . . . . . . . . . . . . . . . 26
  164.          º11 Disk identification coding support . . . . . . . . . . . 27
  165.          º12 DirKing program information. . . . . . . . . . . . . . . 27
  166.  
  167.          Appendix: DirKing keyword reference. . . . . . . . . . . . . 28
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.                                         DirKing v2.10 User Manual - Page 3
  193.  
  194.        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  195.                               DIRKING USER MANUAL  
  196.        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  197.              
  198.        º1 Preliminary remarks.
  199.           ~~~~~~~~~~~~~~~~~~~~
  200.           o Although DirKing can be used in the same way as  the  AmigaDOS
  201.             command  List,  the  real  power and flexibility of DirKing is
  202.             found in  the  additional  features.  For  the  more  advanced
  203.             features, you'll need to experiment a  bit,  but  you'll  soon
  204.             get the hang of it.
  205.  
  206.           o Like the AmigaDOS command  List,  DirKing  can  only  be  used
  207.             from a Shell  (CLI)  or  script.  DirKing  can  also  be  made
  208.             resident by  using  the  AmigaDOS  command  'Resident',  since
  209.             DirKing is reentrant.
  210.  
  211.           o From  the  DirKing  usage  prompt  you'll  notice   that   all
  212.             argument  keywords are printed in  upper  case.  This  doesn't
  213.             mean you have to type them as well in upper case,  lower  case
  214.             will do since DirKing doesn't parse the arguments  on  a  case
  215.             sensitive basis. The rule is that everything  may  be  printed
  216.             in lower case, unless explicitly stated otherwise. 
  217.  
  218.             Except for one argument, all arguments can  be  typed  on  the
  219.             command  line  in  any  order you want. This  means  that  for
  220.             example you could type in  the  directory  path  at  the  end.
  221.             DirKing  will  still   recognize   it. Some  options  however,
  222.             consist  of  two   separate   arguments, which  are  a keyword
  223.             argument and a  data-argument.  Naturally these arguments have
  224.             to typed in that order. 
  225.  
  226.             The exception as mentioned earlier, is  the  LFORMAT argument.
  227.             This argument has always to be typed  last,  since  everything
  228.             after the keyword is regarded as being the format string.
  229.  
  230.             Due to the fact  that  the  arguments  can  be  typed  in  any
  231.             order, you must be careful not to override  a  previous  typed
  232.             option. For instance,  if  you  first  type  'INCL'  and  then
  233.             'EXCL',  the latter can alter the settings of the INCL  option
  234.             if you don't watch it. 
  235.             
  236.           o Some DirKing  options  need  a  data-argument in the form of a
  237.             string. In  case  this  string  should  contain  spaces,  then
  238.             you've to enclose it between double quotation marks.
  239.  
  240.           o DirKing  also  supports  pattern matching. In this version not
  241.             all AmigaDOS  wildcards  are  supported,  but  I  don't  think
  242.             you'll  need  those  exotic  wildcards  anyway.  (Although   a
  243.             future planned AmigaDOS  2  version  only,  will  support  all
  244.             wildcards.)
  245.  
  246.             The following wildcards are supported by DirKing :
  247.  
  248.                 ? : matches just one character;
  249.                 # : the next character may occur zero or more times;
  250.                 ' : take the next character literally;
  251.                 * : although not supported by  AmigaDOS,  DirKing  accepts
  252.                     this equivalent  for  '#?'.  (This  wildcard  is  also
  253.                     used in all examples.)
  254.  
  255.  
  256.                                         DirKing v2.10 User Manual - Page 4
  257.  
  258.                 | : this pattern separator is supported but  not  in  path
  259.                     patterns (see later). 
  260.  
  261.           o Throughout this  manual,  you'll  find  numerous  examples  to
  262.             demonstrate the use  of  DirKing's  features.  Those  examples
  263.             are always printed after  '|'s.  What  has  to  typed  on  the
  264.             command line,  is  enclosed  between  single  quotation  marks
  265.             ('). I didn't use double quotation marks ("), since  they  may
  266.             sometimes be part of a data-argument.
  267.  
  268.        º2 DirKing keyword and argument syntax.
  269.           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  270.           When you use the question mark (?) on the command line,  DirKing
  271.           will print the usage  prompt  (which  will  remind  you  of  the
  272.           correct argument syntax) :
  273.  
  274.          [PATH] [[F|D|]<path|patt>]  [QUICK]  [ALL]  [TOLEVEL  <#>] [DIRS]
  275.          [FILES]        [READ [F|D|]<pattern>]      [PASS [F|D|]<pattern>]
  276.          [SUB [F|D|]<string>]           [SINCE "[F|D|]<[DOSdate] [time]>"]
  277.          [UPTO "[F|D|]<[DOSdate] [time]>"]       [FROM [F|D|]<ch> TO <ch>]
  278.          [INCL   {fkbladtc}]   [EXCL   {fkbladtc}]   [DESC]    [FD|DF|MIX]
  279.          [SORT {nksadtc}]   [NOSORT]     [FULLPATH]     [HEAD {fdvpimtse}]
  280.          [DISKINFO]    [DISKID <str>]   [BARELIST]   [NOHEAD]    [MAXHEAD]
  281.          [NOSTAT]        [ENDMSG]   [EXPAND]   [MAXWIDTH <#>]  [SHOWLEVEL]
  282.          [NEWPAGE [[{th}]<#>]]   [DIRSTYLE [r|i|b|y|f|a|e][r|i|b|y|f|a|e]]
  283.          [PRTSTYLE {rdlbpes}]    [PRT]    [TO <file>]  [DATES]  [BINFLAGS]
  284.          [HEXVAL]     [LISTF <0..4>]     [DATEF <0..7>]     [TIMEF <0..3>]
  285.          [LISTORD <fmt>]    [DFORMAT <fmtstr>]  [TFORMAT <fmtstr>] [TRACE]
  286.          [MULTI] [VERSION] [LFORMAT <fmtstr>]
  287.  
  288.        º3 Directory scanning.
  289.           ~~~~~~~~~~~~~~~~~~~
  290.           The following arguments direct the way the  directory  is  read.
  291.           By default DirKing will only read the files and  directories  of
  292.           the current directory or the specified path. Thus DirKing  won't
  293.           descend in the sub-directories.
  294.  
  295.        A. Specifying the directory path.
  296.  
  297.           A.1. Normal directory paths. 
  298.  
  299.         o [[F|D|]<path|patt>]
  300.  
  301.           a. General use.
  302.  
  303.           If you don't specify a path to a directory (or  file)  to  scan,
  304.           then DirKing will scan your Shell's current directory. 
  305.  
  306.              | current directory : 'Workbench:c' 
  307.              | 'DirKing' : will read the 'Workbench:c' directory
  308.  
  309.           If you do specify a path, then DirKing will obviously  check  if
  310.           this path exists, and if so, list its contents. This  path  must
  311.           be a valid AmigaDOS path, otherwise you'll cause a DOS error.
  312.  
  313.              | 'DirKing workbench:s' : will read 'Workbench:S'
  314.  
  315.           It's also possible to use pattern matching. You can do this  for
  316.           both a specified path or the current  directory.  Normally  this
  317.           pattern will be effective on both  files  and  directories,  but
  318.  
  319.  
  320.                                         DirKing v2.10 User Manual - Page 5
  321.  
  322.           but you can alter this by using the '[F]' or the  '[D]'  option.
  323.           To select one of these options, you have to put  an  'F'  or  an
  324.           'D' at the beginning of the path. IMPORTANT:  this  option  code
  325.           has always to be typed in UPPER  CASE  and  must  be  the  first
  326.           character of the path! Otherwise DirKing will interprete  it  as
  327.           being part of the path.
  328.  
  329.           The specified  patterns  will  be  effective  during  the  whole
  330.           scanning process. Thus not just for the scanned  directory,  but
  331.           for all further read  sub-directories.  If  you  only  want  the
  332.           pattern to be effective in one directory level,  then  you  must
  333.           use "deep level pattern matching", which is explained later.   
  334.             
  335.              | 'DirKing   workbench:*s*' : only  read  those   files   and
  336.              | directories which contain an 's' in their name
  337.  
  338.              | 'DirKing  Fworkbench:*s*' : only  read  those  files  which
  339.              | matchs the pattern. The directories will all be accepted.
  340.  
  341.           b. Advanced use : recursive directory-paths.
  342.  
  343.           Recursive paths to a directory or a file always start  from  the
  344.           current directory. To climb up the directory tree (recurse)  you
  345.           have to make use of the '/' and ':' characters. 
  346.  
  347.           Using ':' goes back to the root  of  the  volume  on  which  the
  348.           current directory is situated.
  349.  
  350.             | current directory : 'Workbench:devs/keymaps'
  351.             | 'DirKing :' : DirKing use 'Workbench:' as the path.    
  352.  
  353.           The '/' character refers to a parent directory of  your  current
  354.           directory. The more '/'s you  use,  the  higher  you  climb  the
  355.           directory tree. How many '/'s you may use, depends  on  how  far
  356.           you're away from the root directory.  If  you  enter  more  '/'s
  357.           than there are parent directories, then DirKing  will  fail  and
  358.           output an invalid path error!
  359.  
  360.              | current directory : 'Workbench:devs/keymaps'
  361.              | 'DirKing /'   : read the 'Workbench:devs' directory
  362.              | 'DirKing //'  : read the 'Workbench:' directory
  363.              | 'DirKing ///' : error, no parent of 'Workbench:' exists
  364.  
  365.         o [PATH]
  366.  
  367.           The only  function  of  PATH  is  to  inform  DirKing  that  the
  368.           argument following is the path, and  not  an  argument  keyword.
  369.           PATH is only useful in case you want to scan a sub-directory  of
  370.           your current directory which has the same name  as  an  argument
  371.           keyword. If PATH wouldn't be used  in  such  a  situation,  then
  372.           DirKing would interprete your path as an argument  keyword,  and
  373.           not as the path (the AmigaDOS commands 'List'  and  'Dirs'  make
  374.           this mistake).
  375.            
  376.           A.2. Deep level pattern matching.
  377.  
  378.           The term 'deep level pattern matching' is the  only  way  I  can
  379.           describe the following feature. As mentioned  above,  this  kind
  380.           of pattern matching is more suited when DirKing has  to  descend
  381.           the directory tree. Since you can specify  a  pattern  for  each
  382.  
  383.  
  384.                                         DirKing v2.10 User Manual - Page 6
  385.  
  386.           directory level DirKing reads. The patterns  are  typed  in  the
  387.           place where you would normally type the name of a  directory  in
  388.           the path. When nothing is typed in this place  then  this  means
  389.           that there's no pattern for that directory level. 
  390.  
  391.           Note: the  patterns  are  also  effective  on  both  files   and
  392.                 directories, unless  you  make  use  of  the  'F'  or  'D'
  393.                 options.
  394.  
  395.             | 'DirKing workbench:*s*/p*' will be interpreted as :
  396.             | path = 'workbench:', 
  397.             | pattern for level 0 = '*s*', for level 1 = 'p*'
  398.  
  399.             | 'DirKing workbench:s/p*' will be interpreted as :
  400.             | path = 'workbench:s', pattern for level 0 = 'p*'
  401.  
  402.             | 'DirKing workbench:/p*//*c*' will be interpreted as :
  403.             | path = 'workbench:', 
  404.             | pattern for level 0 = '' (no pattern),
  405.             |    "    for level 1 = 'p*',
  406.             |    "    for level 2 = '', (no pattern)
  407.             |    "    for level 3 = '*c*',
  408.  
  409.           'Deep level pattern matching' can  also  be  used in conjunction
  410.           with  a  recursive  path. It then is very important  to  have  a
  411.           clear notion of what you enter, since DirKing has to use a  part
  412.           of your path string as the path to scan, and the rest of  it  as
  413.           the patterns.  The  recursive  indicators  ':'  and  '/'  should
  414.           always  be  at  the  front  of  the  path  string,  without  any
  415.           characters in between. From  the  moment  another  character  is
  416.           typed in, then from thereon the string will be used  as  a  path
  417.           (with or without deep level pattern matching).
  418.  
  419.              | 'DirKing :/*c*' means path = ':' or volume (root)
  420.              |                 level 0 pattern = '' (no pattern),
  421.              |                 level 1 pattern = '*c*'
  422.  
  423.              | current directory = 'Workbench:devs/keymaps'
  424.              | 'DirKing //*s*//*y*' means path = 'Workbench:'
  425.              |                      level 0 pattern = '*s*', 
  426.              |                      level 1 pattern = '' (no pattern), 
  427.              |                      level 2 pattern = '*y*' 
  428.  
  429.              | current directory = 'Workbench:devs/keymaps'
  430.              | 'DirKing //devs//*s*//*y*' means path = 'Workbench:devs'
  431.              |                      level 0 pattern = '' (no pattern), 
  432.              |                      level 1 pattern = '*s*', 
  433.              |                      level 2 pattern = '' (no pattern), 
  434.              |                      level 3 pattern = '*y*' 
  435.  
  436.           I know it gets very complicated,  but  the  only  way  to  fully
  437.           master this feature is to experiment a bit. The best way  to  do
  438.           this is by sending the listing of a large directory tree to  the
  439.           printer, and then starting to experiment on that directory  with
  440.           its listing in front of you.
  441.  
  442.        B. Filtering directory information.
  443.  
  444.           Although you can filter what has to be read  by  using  patterns
  445.           in the path, most of the time you want more than that. For  this
  446.  
  447.  
  448.                                         DirKing v2.10 User Manual - Page 7
  449.  
  450.           this purpose DirKing supports three kinds of  powerful  filters,
  451.           which are explained below. 
  452.  
  453.           B.1. Global filters.
  454.  
  455.           As their name suggest, these filters have an overall control  on
  456.           the scanning  process.  With  most  you'll  be  familiar,  since
  457.           they're also present in the AmigaDOS directory list commands.
  458.  
  459.         o [ALL]
  460.  
  461.           By default Dirking will only read one directory level (which  is
  462.           the Shell's current directory or a specified path). If  you  use
  463.           ALL then  DirKing  will  descend  into  all  sub-directories  it
  464.           finds, until no more are found. 
  465.  
  466.             | 'DirKing  Workbench:  ALL' : the whole Workbench  disk  will
  467.             | be scanned.
  468.  
  469.         o [DIRS]
  470.  
  471.           At first glance one would assume that  DirKing  will  only  read
  472.           directories.  In  a  way  this  is  true,  but  it's  better  to
  473.           interprete  this   argument   so   that   DirKing   may  include
  474.           directories. (Because if you also use 'FILES', then  files  will
  475.           also be included.).
  476.  
  477.           The 'DIRS' option in conjunction with 'ALL' is  a  good  way  to
  478.           get a clear view of the  directory  tree  (since  no  files  are
  479.           listed).
  480.  
  481.         o [FILES]
  482.  
  483.           This DirKing option acts the same as DIRS, but  now  for  files.
  484.           It's important to remember that the options 'ALL'  or  'TOLEVEL'
  485.           won't work when 'FILES'  is  used,  since  DirKing  ignores  all
  486.           directories (unless you also use DIRS). 
  487.  
  488.         o [TOLEVEL <#>]
  489.  
  490.           This option  works  in  the  same  way  as  'ALL',  except  that
  491.           'TOLEVEL' specifies how many directory levels  may be scanned. I
  492.           speak of 'may' because it doesn't matter if  the  TOLEVEL  value
  493.           is greater than the actual number of directory levels present. 
  494.  
  495.             | Assume current directory is 'Workbench:Devs'
  496.             | 'DirKing  TOLEVEL   0' : will  only  read  entries  in  this
  497.             | directory  level,  without  descending  down  the  directory
  498.             | tree.
  499.             | 'DirKing  TOLEVEL  1' : does the same, but  will  also  read
  500.             | the 'KeyMaps' and 'Printers' directories.
  501.  
  502.           B.2. Filter options. -> [F|D|] 
  503.  
  504.           All  the  following  filters  (including  the  conditional  date
  505.           filters) support the use of 'F', 'D' and '' options. The use  of
  506.           these options has already been  discussed  with  the  path,  but
  507.           when used with filters, they add another  dimension.  First  I'd
  508.           like to remind you of the meaning of the three options :
  509.  
  510.  
  511.  
  512.                                         DirKing v2.10 User Manual - Page 8
  513.  
  514.  
  515.             - ''  : if you don't enter an option code, then  DirKing  will
  516.                     use the filter on both files and directories;
  517.             - 'F' : the filter will only be used for files;
  518.             - 'D' : the filter will only be used for directories.
  519.  
  520.           Note: the option code must always be typed in  UPPER  CASE,  and
  521.                 always be the first character of the data-argument!
  522.  
  523.           The options used with filters, add  another  dimension  to  that
  524.           filter. Since you can use the filter upto  three  times  on  the
  525.           command  line,  providing  that  each  filter  argument  has   a
  526.           different option. In other words you  can  enter  a  filter  for
  527.           both files and directories, one for files only, and another  for
  528.           directories.
  529.  
  530.           B.3. File- and directoryname filtering.
  531.  
  532.           The  following  filters  operate  on  the  name  of  files   and
  533.           directories, thus presenting more powerful  filtering  than  the
  534.           previous filter type. 
  535.  
  536.         o [READ [F|D|]<pattern>]
  537.  
  538.           This argument instructs DirKing to  only  read  (include)  those
  539.           directory entries (files and/or  directories)  which  match  the
  540.           given pattern(s). Upto 32 patterns can be  used  with  the  READ
  541.           argument (note that if you make use of the filter  options,  you
  542.           can have upto 96  patterns).  To  enable  DirKing  to  recognize
  543.           these  patterns  they  have  to  be  separated  by  '/'  or  '|'
  544.           characters. (If one of the patterns should contain spaces,  then
  545.           you must  enclose  the  whole  data-argument  between  quotation
  546.           marks.)
  547.  
  548.             | 'READ *s*' : include only those  directories  and  files  if
  549.             |              their name includes 's'.
  550.  
  551.             | 'READ *s*/*a*' : include only those  directories  and  files
  552.             |                  if their name either includes 's' or 'a'.
  553.  
  554.             | 'READ F*a* READ D*b* READ *c*' :
  555.             | Files are only included if their name matches the  '*a*'  or
  556.             | the '*c*' patterns. Directories are only included  if  their
  557.             | name matches the '*b*' or the '*c*' patterns. 
  558.  
  559.             | 'READ F*a*/*b*/*c*' :
  560.             | Files are only included if their name  matches  one  of  the
  561.             | three specifies patterns (*a*, *b*,  *c*).  All  directories
  562.             | will be included, since  this  argument  is  only  effective
  563.             | for files!
  564.  
  565.         o [PASS [F|D|]<pattern>]
  566.  
  567.           The PASS argument works in the same way as  the  READ  argument,
  568.           except that  all directory entries  (files  and/or  directories)
  569.           that match the given pattern(s)  are  ignored  (excluded).  PASS
  570.           also supports upto 32 patterns (or 96  if  you  use  all  filter
  571.           options). 
  572.  
  573.             | 'PASS *s*/*a*' : ignore  those  directories  and  files   if
  574.  
  575.  
  576.                                         DirKing v2.10 User Manual - Page 9
  577.  
  578.             |                  their name either includes 's' or 'a'.
  579.  
  580.             | 'PASS F*a* PASS D*b* PASS *c*' :
  581.             | Files are ignored  if their name matches the  '*a*'  or  the
  582.             | '*c*'  patterns.  Directories  are  ignored  if  their  name
  583.             | matches the '*b*' or the '*c*' patterns. 
  584.  
  585.         o [SUB [F|D|]<string>]
  586.  
  587.           In order to be included in the listing the names  of  the  files
  588.           and/or directories must  contain  the  specified  string(s).  As
  589.           with the above  name  filters,  upto  32  (or  96)  strings  are
  590.           supported (separated by '/'s).
  591.  
  592.             | 'SUB s/a' : include only  those  directories  and  files  if
  593.             |             their name either contains 's' or 'a'.
  594.  
  595.             | 'SUB Fa/d SUB Db SUB c' :
  596.             | Files are only included if their name contains 'a',  'd'  or
  597.             | 'c'. Directories are only included if  their  name  contains
  598.             | 'b' or 'c'. 
  599.  
  600.         o [FROM [F|D|]<ch> TO <ch>]
  601.  
  602.           The 'FROM TO' argument enables  filtering on the first character
  603.           of the name of files and/or directories.  Since  AmigaDOS  names
  604.           aren't handled case sensitive, typing 'A' is the same as  typing
  605.           'a'.
  606.  
  607.           The <ch>aracter is only valid if it's in  the  range  [0..9]  or
  608.           [a..z].
  609.  
  610.             | 'FROM a  TO  d' : only include directories and files, if the
  611.             | first character of their  name  is  equal  or  greater  than
  612.             | 'a', but not greater than 'd'.
  613.  
  614.             | 'FROM 5  TO  a' : only include directories and files, if the
  615.             | first character of their  name  is  equal  or  greater  than
  616.             | '5', but not greater than 'a'.
  617.  
  618.             | 'FROM Fa  TO  d' : only include files if the first character
  619.             | of their name is equal or greater than 'a' but  not  greater
  620.             | than 'd'. All  directories  will  be  included,  since  this
  621.             | filter doesn't apply to them.
  622.  
  623.           If the TO <ch>aracter is  smaller  than  the  FROM  <ch>aracter,
  624.           then this TO <ch>aracter will be  replaced  by  the  last  valid
  625.           character in the range.
  626.  
  627.             | 'FROM s TO a' : will be interpreted as 'FROM s TO z'.
  628.  
  629.           B.4. Conditional date filters.
  630.  
  631.           Conditional  dates  provide  filters for the date- and timestamp
  632.           of a file or directory. The syntax of the conditional  date  can
  633.           be one of the following :
  634.  
  635.            1░ DOSdate : only a datestamp is given, in the  usual  AmigaDOS
  636.                         format, which is DD-MMM-YY  (e.g.  14-aug-92).  If
  637.                         the date is within the last week  of  the  current
  638.  
  639.  
  640.                                        DirKing v2.10 User Manual - Page 10
  641.  
  642.                         date, then you  may  use  the  actual  dayname  of
  643.                         that date (Sunday...Saturday); you  may  also  use
  644.                         'Today'  and  'Yesterday'.  The  dates  after  the
  645.                         current date can be  replaced  by  'Tomorrow'  and
  646.                         'Future' (represents the day  after  tomorrow  and
  647.                         later).
  648.  
  649.            2░ time : only a timestamp is  given,  in  the  usual  AmigaDOS
  650.                      format,  which  is  HH:MM:SS  (e.g.  18:15:42).  (The
  651.                      seconds  can  be  omitted,  in  which  case  '00'  is
  652.                      used).
  653.  
  654.            3░ DOSdate & time : a date- and  timestamp  is  given,  in  the
  655.                                above   specified   formats.   (Note   that
  656.                                you  can   also   enter   the   date-   and
  657.                                timestamp in reverse order.)
  658.  
  659.           REMARK: the date- and timestamp  must  be  typed  in  the  above
  660.                   mentioned formats,  otherwise  DirKing  won't  recognize
  661.                   your date/timestamp!
  662.  
  663.         o [SINCE "[F|D|]<[DOSdate] [time]>"]
  664.  
  665.           Using SINCE means  that  only  those  directory  entries  (files
  666.           and/or directories) will  be  included  if  their  date-  and/or
  667.           timestamp is equal or later than the given conditional date. 
  668.  
  669.             | 'SINCE 14-aug-92' : include  only  files   and   directories
  670.             | which were created on or after 14 August 1992.
  671.  
  672.             | 'SINCE 14:30:00' : include  only   files   and   directories
  673.             | which were created on or after 14:30:00.
  674.  
  675.             | 'SINCE "14-aug-92 14:30:00"' : include   only   files    and
  676.             | directories  which  were  created  on  or  after  14-Aug-92,
  677.             | 14:30:00.
  678.  
  679.             | Assume that today is 16-Aug-92
  680.             | 'SINCE   yesterday' : include  only  files  and  directories
  681.             | which were created on or after 15-Aug-92.
  682.  
  683.             | 'SINCE   Ftoday' : include  only  files  that  were  created
  684.             | today or later. All  directories  found  will  be  included,
  685.             | since this filter is only effective for files.
  686.           
  687.         o [UPTO "[F|D|]<[DOSdate] [time]>"]
  688.  
  689.           Everything  said  for  SINCE  applies  for   UPTO,   with   this
  690.           difference that now only files/directories will be  included  if
  691.           their  date/timestamp  is  equal or earlier than the conditional
  692.           date/timestamp.
  693.  
  694.        C. Tracing the scanning process. 
  695.  
  696.         o [TRACE]
  697.  
  698.           This  is  a  rather  exotic feature of DirKing. TRACE is used to
  699.           monitor the scanning process. This option  is  extremely  useful
  700.           when scanning large directories, and you  want  to  know  what's
  701.           going on. The information printed consists of the following :
  702.  
  703.  
  704.                                        DirKing v2.10 User Manual - Page 11
  705.  
  706.             - the currently scanned path;
  707.             - the number of directories included  so  far,  and  the  last
  708.               one found;
  709.             - the number of files  included  so  far,  and  the  last  one
  710.               found;
  711.  
  712.           Note:  this  feature  will  slightly  slow  down  the   scanning
  713.                  process, but once you used  it,  you'll  be  addicted  to
  714.                  it.
  715.  
  716.        º4 Directory information.
  717.           ~~~~~~~~~~~~~~~~~~~~~~
  718.           By  default, DirKing will print the listing in roughly the  same
  719.           format as the AmigaDOS 'List' command, but with more  style  and
  720.           information. First of all DirKing will print  the  scanned  path
  721.           and the date/timestamp of the listing. Then the  actual  listing
  722.           is printed in a table form, with a title  line  indicating  what
  723.           all the printed fields mean  (the  List  command  doesn't  print
  724.           such a title line!). After  the  listing  has  been  printed,  a
  725.           statistic line will be  printed,  which  states  the  number  of
  726.           files and directories found, and the amount of bytes and  blocks
  727.           they used.
  728.  
  729.           This default listing format can be altered  by  the  options  as
  730.           described below. But for good understanding, it's  necessary  to
  731.           explain some terms used :
  732.  
  733.             o DirectoryEntry : refers to files and directories;
  734.             o Field : each  separate  information  of  a  directory  entry
  735.                       (e.g. name, blocks used, datestamp,...);
  736.             o Listing : what  DirKing  prints  on  the  scanned  directory
  737.                         (consists  of  the  listing  header,  the   actual
  738.                         listing and the listing end);
  739.             o ListingHeader : a block of  information  about  the  scanned
  740.                               directory (and volume);
  741.             o ActualListing : that section of the  listing,  only  holding
  742.                               the   directory   entries,   including   the
  743.                               title line  (which  states  the  meaning  of
  744.                               the different fields);
  745.             o ListingEnd : the block of information  printed  at  the  end
  746.                            of  the  listing   (thus   after   the   actual
  747.                            listing).
  748.             o DiskInfoBlock : a block  of  extensive  information  on  the
  749.                               volume  that  was  accessed  to   read   the
  750.                               directory;
  751.  
  752.         A. Volume (disk) information.
  753.  
  754.         o [DISKINFO]
  755.  
  756.           The DISKINFO option can be compared with  the  AmigaDOS  command
  757.           'Info',  except  that  it  gives  more  information  than   this
  758.           command. The information is printed in  a  block  consisting  of
  759.           three lines of information : 
  760.  
  761.           Line_1 : - 'Volume'     : volume name;
  762.                    - 'Created'    : date/time stamp of creation;
  763.           Line_2 : - 'RootKey'    : block number of the root directory;
  764.                    - 'DiskSize'   : number of blocks on the disk;
  765.                    - 'BlockSize'  : number of bytes in a block;
  766.  
  767.  
  768.                                        DirKing v2.10 User Manual - Page 12
  769.  
  770.                    - 'BlocksFree' : number of blocks free on the disk;
  771.                    - 'BytesFree'  : number of bytes free on the disk;
  772.                    - 'Errors'     : number of soft-errors on the disk;
  773.                    - 'DiskStatus' : status  of   the   disk   (Read/Write,
  774.                                     ReadOnly, Validating);
  775.                    - 'DOSType'    : DOS type of the  disk  (OFS:OldFiling-
  776.                                     System,  FFS:FastFilingSystem,   KICK:
  777.                                     KickstartDisk,MSDOS:MS-DOSdisk,IOFS:
  778.                                     InterOFSdisk, IFFS:InterFFSdisk);
  779.           Line_3 : - 'Most Recent DateStamp' : not filled;
  780.                    - 'TotalFiles' : not filled;
  781.                    - 'TotalDirs'  : not filled;
  782.                    - 'BlocksUsed' : number of blocks used on the disk;
  783.                    - 'BytesUsed'  : number of bytes used on the disk;
  784.                    - 'Full'       : disk full percentage.
  785.  
  786.           Note: the lines 2 and 3 form the  'DiskInfoBlock'.  Three  items
  787.                 of line 3 aren't  filled,  because  DirKing  doesn't  scan
  788.                 the  disk when 'DISKINFO' is  selected.  If  you  do  want
  789.                 these  items filled, then you must use 'HEAD vpi  EXCL  f'
  790.                 instead  of  'DISKINFO'  (for  more   details   on   these
  791.                 arguments, see later). 
  792.  
  793.           IMPORTANT: when 'DISKINFO'  is  used,  then  all  other  DirKing
  794.                      options  will  be  ignored,  except  for   the   path
  795.                      argument (DirKing must know  from  which  volume  you
  796.                      want  information).  Since  DirKing  doesn't  read  a
  797.                      directory,   the   volume   information   is    given
  798.                      instantly.
  799.            
  800.             | 'DirKing DISKINFO' : gives information about the  volume  on
  801.             |                      which   the   current   directory    is
  802.             |                      situated.
  803.  
  804.             | 'DirKing DF1: DISKINFO' : gives  information  on  the   disk
  805.             |                           which   is   inserted   in   drive
  806.             |                           'DF1:'.
  807.  
  808.         B. Listing header/end information.
  809.  
  810.           By  default DirKing  will  use  a  listing  header  stating  the
  811.           following information : scanned  directory  (using  the  correct
  812.           upper/lower  case  notation)  and  the  date/timestamp  of   the
  813.           listing. The listing end consists of a  statistic  line,  giving
  814.           the number of files and directories found,  and  the  number  of
  815.           bytes and blocks used by them.
  816.  
  817.           With the following options, you can alter what is printed  as  a
  818.           listing header an as a listing end.
  819.  
  820.         o [FULLPATH]
  821.  
  822.           When  you  normally enter a path to a directory or file,  you'll
  823.           use lower case characters (since AmigaDOS isn't  case  sensitive
  824.           on this subject). However, DirKing will search for  the  correct
  825.           upper/lower case notation of that path, before  printing  it  in
  826.           the listing. 
  827.  
  828.           By  default, DirKing will only  correct  the  path  that  you've
  829.           specified. It won't look for the correct path from the root  on.
  830.  
  831.  
  832.                                        DirKing v2.10 User Manual - Page 13
  833.  
  834.           on. Sometimes you'll want to  know  the  correct  path  starting
  835.           from the volume-root. You can do this  by  using  FULLPATH. This
  836.           option instructs DirKing to construct the path from the  volume-
  837.           root upto the directory or file specified.
  838.  
  839.             | Assume we're scanning your Workbench (system) disk.
  840.             | 'DirKing devs:' : DirKing  will   print   'DEVS:'   as   the
  841.             |                   scanned path.
  842.             | 'DirKing devs: FULLPATH' : 'Workbench:Devs'  is  printed  as
  843.             |                             the scanned path.
  844.  
  845.             | Assume current directory is 'Workbench:Devs'.
  846.             |  'DirKing' : (read current directory) '' is printed  as  the
  847.             |             scanned path.
  848.             | 'DirKing  FULLPATH' : 'Workbench:Devs'  is  printed  as  the
  849.             |                       scanned path.
  850.  
  851.             | Assume current directory is 'Workbench:Devs'
  852.             | 'DirKing  keymaps' : will read the  'Workbench:Devs/Keymaps'
  853.             |                     directory,  where  DirKing  will   print
  854.             |                     'Keymaps' as the scanned path.
  855.             | 'DirKing keymaps FULLPATH' : reads the same  directory,  but
  856.             |                              'Workbench:Devs/Keymaps'   will
  857.             |                              be printed as the path read.
  858.  
  859.             | Assume your Workbench disk in drive 'DF1:'.
  860.             | 'DirKing df1:' : 'DF1:' is printed as the scanned path.
  861.             | 'DirKing df1: FULLPATH' : 'Workbench:'  is  printed  as  the
  862.             |                           scanned path.
  863.           
  864.         o [HEAD {fdvpimtse}]
  865.  
  866.           The default listing header and listing  end  have  already  been
  867.           explained at the beginning of 'º4B'. The HEAD option now  allows
  868.           you to specify what information you want in the  listing  header
  869.           and the listing end.
  870.  
  871.           Note: although  the  argument  keyword  is  called  'HEAD',   it
  872.                 defines both the listing header and listing end!
  873.  
  874.           To define which listing header and listing  end  you  want,  you
  875.           have to use the following codes (the  codes  are  given  in  the
  876.           order they'll appear in the header) :
  877.  
  878.           > Listing head codes
  879.  
  880.             - F : display the maximum  listing  head;  this  code  is  the
  881.                   equivalent of using 'HEAD dvpit'.
  882.             - D : print date and time of scanning;
  883.             - V : print name and creation  date  of  the  accessed  volume
  884.                   (disk);
  885.             - P : if a path was scanned (any path,  except  when  it  only
  886.                   represents a volume or device name, or an  assign)  then
  887.                   print it;  
  888.             - I : print  the   DiskInfoBlock   as   explained   with   the
  889.                   'DISKINFO' option;
  890.             - M : print the default listing header line;
  891.             - T : print the title above the listing table;
  892.  
  893.  
  894.  
  895.  
  896.                                        DirKing v2.10 User Manual - Page 14
  897.  
  898.           > Listing end codes
  899.  
  900.             - E : print the '~~~~~ End  of  Directory  ~~~~~'  message  at
  901.                   the end.
  902.             - S : print the statistic line  at  the  end  of  the  listing
  903.                   (default listing end);
  904.  
  905.         o [MAXHEAD]
  906.  
  907.           This argument is equal to using 'HEAD f' or 'HEAD dvpit'.
  908.  
  909.         o [NOHEAD]
  910.  
  911.           If used,  then  no  listing  head  will  be  printed  above  the
  912.           listing, except for the listing title.
  913.  
  914.         o [BARELIST]
  915.  
  916.           Only the actual listing  will  be  printed,  without  the  title
  917.           line. In other words only the directory entries are given.
  918.  
  919.         o [NOSTAT]
  920.  
  921.           Prevents  that  the  statistic line is printed at the end of the
  922.           listing. This option will primarily  be  used  to  suppress  the
  923.           default listing end (which is this statistic line).
  924.  
  925.         o [ENDMSG]
  926.  
  927.           Lets DirKing print the '~~~~  End  of  Directory  ~~~~'  message
  928.           after the actual listing. 
  929.  
  930.        C. File- and directory fields.
  931.  
  932.           The following arguments  define  which  fields  of  a  directory
  933.           entry are printed. By default DirKing will print  the  following
  934.           fields in the given order (the names between  ''  are  the  ones
  935.           printed in the listing title line) : 
  936.  
  937.             - 'FileName' : name of a file or directory;
  938.             - 'Keys'     : the disk key (block  number  of  file/directory
  939.                            header);
  940.             - 'Blocks'   : blocks used by a file  (for  directories  'Dir'
  941.                            is printed instead);
  942.             - 'Bytes'    : bytes used by a  file  (for  directories  'Dir'
  943.                            is printed instead);
  944.             - 'Flags'    : the   file/directory   attributes   (protection
  945.                            flags);
  946.             - 'Date'     : datestamp of file/directory;
  947.             - 'Time'     : timestamp of file/directory.
  948.  
  949.           Note:  filenotes  (comments)  aren't  printed  in  the   default
  950.                  setting. You have to use 'INCL' to include them.
  951.  
  952.         o [QUICK]
  953.  
  954.           If 'QUICK' is used the only the  file/directory  name  field  is
  955.           printed.
  956.  
  957.  
  958.  
  959.  
  960.                                        DirKing v2.10 User Manual - Page 15
  961.  
  962.         o [INCL {fnkbladtc}]
  963.  
  964.           The INCL option is used to specify which fields you want  to  be
  965.           printed in the actual listing. The  following  field  codes  are
  966.           defined :
  967.  
  968.             - F : the  equivalent  of  'INCL  nkbladtc'  (in  other  words
  969.                   prints all fields);
  970.             - N : include file/directory name;
  971.             - K : include file/directory diskkey;
  972.             - B : include filesize in blocks (prints 'Dir' for dirs.);
  973.             - L : include filesize in bytes (prints 'Dir' for dirs.);
  974.             - A : include file/directory attributes (protectionflags);
  975.             - D : include file/directory datestamp;
  976.             - T : include file/directory timestamp;
  977.             - C : include file/directory filenote  (comment);  the   file-
  978.                   note is only printed when one is present.
  979.  
  980.             | 'INCL nd' : only print the name and datestamp fields.
  981.  
  982.             | 'INCL n' : only print name field (equivalent of 'QUICK').
  983.  
  984.             | 'INCL nkbladt' : is  the  same  as   the   default   setting
  985.             |                  (explained earlier).
  986.  
  987.         o [EXCL {fnkbladtc}]
  988.  
  989.           The 'EXCL' option is used to  specify  which  fields  you  don't
  990.           want to be printed. 'EXCL' is only useful for  excluding  fields
  991.           from  the  default  settings,  because  if  you've  used  'INCL'
  992.           earlier, then you've already specified which fields you want. 
  993.  
  994.             | 'EXCL  f' : you'll get an empty listing, only  the  listing
  995.             |            header and listing end will be printed.
  996.  
  997.             | 'EXCL kbladt' : is the same as using  the  QUICK  argument,
  998.             |                 in other words, only the name of the  files
  999.             |                 and directories is printed.
  1000.  
  1001.        º5 Directory sorting.
  1002.           ~~~~~~~~~~~~~~~~~~
  1003.           By default DirKing will sort the names of files and  directories
  1004.           in ascending alphabetical order.  In  the  listing  itself,  all
  1005.           files will be printed first, and last the directories. 
  1006.  
  1007.         o [SORT {nksadtc}]
  1008.  
  1009.           DirKing is able to execute  a  complex sort on all the fields of
  1010.           a directory entry. On which  field  to  sort,  is  specified  by
  1011.           their appropriate code.  Important  however  is  to  type  these
  1012.           codes in the order you want DirKing to sort the fields.
  1013.  
  1014.           The following codes (and fields) are supported :
  1015.  
  1016.             - N : sort on file/directory names;
  1017.             - K : sort on file/directory diskkey;
  1018.             - S : sort on filesize (dirs have no size);
  1019.             - A : sort on file/directory attributes (sorts on  the  binary
  1020.                   value of these attributes);
  1021.  
  1022.  
  1023.  
  1024.                                        DirKing v2.10 User Manual - Page 16
  1025.  
  1026.             - D : sort on file/directory datestamp;
  1027.             - T : sort on file/directory timestamp;
  1028.             - C : sort on file/directory filenote if it's present.
  1029.  
  1030.           REMARK: since  AmigaDOS  names  of  files  and  directories  are
  1031.                   unique in the  same  directory  level,  any  sort  codes
  1032.                   after the 'N' code aren't executed (because  this  would
  1033.                   be a waste of valuable processing time!).
  1034.           Note:  specifying the fields  to  sort  on,  doesn't  mean  that
  1035.                  these items will be  printed  in  the  listing.  What  is
  1036.                  actually printed depends  on  the  options  explained  in
  1037.                  'º4C'.
  1038.  
  1039.             | 'SORT ds' : first sort on the date, then on the size.
  1040.  
  1041.             | 'SORT tna' : first sort on the time, then on  the  name.  No
  1042.             |              sort  is  executed  on  the  attributes,  since
  1043.             |              filenames are unique. 
  1044.           
  1045.         o [NOSORT]
  1046.  
  1047.           If used then the listing won't be sorted. Thus giving  a  slight
  1048.           scanning speed increase.
  1049.  
  1050.         o [DESC]
  1051.  
  1052.           By default the directory is sorted ascending (thus from  low  to
  1053.           high). If  you  want  a  descending sort (from high to low), you
  1054.           have to use DESC.
  1055.  
  1056.         o [FD|DF|MIX]
  1057.  
  1058.           The files and directories can  be  printed  at  three  different
  1059.           places in the listing. You can select the appropriate format  by
  1060.           using one of the following arguments :
  1061.  
  1062.            - 'FD'  : (default) print files first, directories last.
  1063.            - 'DF'  : print directories first, files last.
  1064.            - 'MIX' : print files and directories among each other.  
  1065.  
  1066.        º6 Listing formatting.
  1067.           ~~~~~~~~~~~~~~~~~~~
  1068.           The format of the actual listing can be either  a  table  format
  1069.           or a script format. Most of the time, however,  you'll  use  the
  1070.           table format.
  1071.  
  1072.        A. Listing table formatting. 
  1073.  
  1074.           A.1. Setting the listing table width.
  1075.  
  1076.         o [MAXWIDTH <#>]
  1077.  
  1078.           DirKing will expand the listing table  in  accordance  with  the
  1079.           fields to be printed, and the length of the FileName  field.  In
  1080.           most cases, you'll want to set  a  limit to this expanding. With
  1081.           'MAXWIDTH' you can specify how many characters  may  be  printed
  1082.           on one line. If the listing is too wide, then if the name  field
  1083.           is printed, it will be cut (the name field  is  the  only  field
  1084.           that can be trimmed, all other fields have a fixed  length).  If
  1085.           the name of a file or directory should be too  long  to  fit  in
  1086.  
  1087.  
  1088.                                        DirKing v2.10 User Manual - Page 17
  1089.  
  1090.           to fit in the FileName field, then the last  character  will  be
  1091.           an '$' to indicate that more characters are  following  in  that
  1092.           name. 
  1093.  
  1094.           Note: the MAXWIDTH  option  is  only  effective  on  the  actual
  1095.                 listing, not on the listing header or listing end.
  1096.  
  1097.  
  1098.           REMARK: the limit set with 'MAXWIDTH' won't work in  all  cases.
  1099.                   This depends on the fields to  be  printed.  The  fields
  1100.                   that have a fixed length will always be  fully  printed.
  1101.                   The only variable field is  the  'FileName'  field,  but
  1102.                   it can't be smaller than  16  characters.  DirKing  will
  1103.                   always  print  the  fixed  fields  and  the  minimal  16
  1104.                   characters,  even  if  the  total  width   exceeds   the
  1105.                   'MAXWIDTH' setting. 
  1106.  
  1107.             | 'MAXWIDTH 70' : the actual listing  width  can  only  be  70
  1108.             |                 characters wide. 
  1109.  
  1110.         o [EXPAND]
  1111.  
  1112.           By  default, DirKing will only print as wide as is necessary  to
  1113.           print all the wanted fields. So  the  listing  width  will  vary
  1114.           from directory to directory. If you want DirKing to make use  of
  1115.           the full allowed listing width, then you must use EXPAND.
  1116.  
  1117.           When  MAXWIDTH is used, then DirKing will print a  listing  with
  1118.           an actual width as specified. When you don't use MAXWIDTH,  then
  1119.           DirKing will use the default width of 77 characters.
  1120.  
  1121.           A.2. Formatting the listing table.
  1122.  
  1123.           With the following options you can customize the format  of  the
  1124.           listing table, and the format of the date-  and  timestamp.  All
  1125.           these format options, support the use of  AmigaDOS print control
  1126.           sequences. To introduce such a  sequence  in  the  formatstring,
  1127.           you have  to  use  a  '\'  character  followed  by  one  of  the
  1128.           following codes :
  1129.  
  1130.             - e : insert an  ESCape  character  (refer  to  your  AmigaDOS
  1131.                   manual  for  a  list  of  the  supported  print  control
  1132.                   sequences);
  1133.             - t : insert a TAB character;
  1134.             - n : insert a line feed;
  1135.             - ' : print a double quotation mark (");
  1136.             - \ : used to print '\'.
  1137.  
  1138.         o [LISTORD <fmt>]
  1139.  
  1140.           Normally the listing is printed in the form of  a  table,  where
  1141.           each  column  represents  a  field.  By  default the fields  are
  1142.           printed in the following order  :  name,  keys,  blocks,  bytes,
  1143.           attributes  (protectionflags),  date  and  time  (if  there's  a
  1144.           comment, then it's printed on the next line).
  1145.  
  1146.           With the following  codes  you  can  define  the  order  of  the
  1147.           fields :
  1148.  
  1149.             - N : 'FileName';
  1150.  
  1151.  
  1152.                                        DirKing v2.10 User Manual - Page 18
  1153.  
  1154.             - K : 'Keys';
  1155.             - B : 'Blocks,;
  1156.             - L : 'Bytes,;
  1157.             - A : 'Flags';
  1158.             - S : 'Date';
  1159.             - T : 'Time'.
  1160.  
  1161.             | 'LISTORD dalnktb' : defines  the  order   :   date,   flags,
  1162.             |                     bytes, name, keys, time and blocks.
  1163.  
  1164.           Note: the use of LISTORD doesn't mean  that  these  fields  will
  1165.                 actually be  printed.  This  depends  on  the  options  as
  1166.                 described under 'º4C'.
  1167.  
  1168.           Important:  as mentioned above the default order  is  'nkbladt'.
  1169.                      When defining the fields order,  you  don't  have  to
  1170.                      enter  all  codes  for  the  fields  that   will   be
  1171.                      printed. When  you  only  define  the  order  of  the
  1172.                      first fields, DirKing  will  use  the  default  order
  1173.                      for the rest of the fields.
  1174.  
  1175.             | 'LISTORD an' : only two fields are  defined,  the  rest  are
  1176.             |                printed  in  the  default  order.  The  order
  1177.             |                will  then  be  : flags, name, keys,  blocks,
  1178.             |                bytes, date and time. 
  1179.  
  1180.           As mentioned earlier, the LISTORD will also support the  use  of
  1181.           AmigaDOS print control sequences. You can also use normal  text,
  1182.           although this isn't much recommandable since it can disrupt  the
  1183.           listing  table.  So  it's  best  to  only  use   print   control
  1184.           sequences.
  1185.  
  1186.             | 'LISTORD  \e[1mN\e[0m' : all names will be printed  in  bold
  1187.             | style characters.  The  other  fields  are  printed  in  the
  1188.             | usual default order, and in plain text.
  1189.  
  1190.             | 'LISTORD nkbladt' : same as the default order.
  1191.  
  1192.         o [DFORMAT <fmtstr>]
  1193.  
  1194.           DirKing uses the AmigaDOS dateformat  (which  is  DD-MMM-YY)  as
  1195.           its default format. With  'DFORMAT'  you  can  define  your  own
  1196.           dateformat. This formatstring can  contain  normal  text,  print
  1197.           control  sequences  and  of   course   the   date   substitution
  1198.           operators. The substitution operators indicate which  date  item
  1199.           has  to  be  printed.  Such  an  operator  consists  of  an  '%'
  1200.           character and one of the following date item codes :
  1201.  
  1202.            - w : insert a two character dayname (e.g.Sa,Su,Mo,...);
  1203.            - W : insert the full dayname (e.g.Sunday,Monday,...);
  1204.            - d : insert the day in the month;
  1205.            - m : insert the month number (1..12);
  1206.            - M : insert a three character month name (e.g.Jul,Aug,...);
  1207.            - y : insert the last two digits of the year (e.g.91,92,...);
  1208.            - Y : insert a four digit year (e.g.1991,1992,...).
  1209.  
  1210.             | 'DFORMAT %w_%d/%Y/%m' : gives a date like Su_23/1992/08.  
  1211.  
  1212.             | 'DFORMAT "\e[1m%W\e[0m  \e[3m%d  %M  %Y\e[0m"'  (Notice  the
  1213.             | quotation marks! They're  used  because  the  DFORMAT  data-
  1214.  
  1215.  
  1216.                                        DirKing v2.10 User Manual - Page 19
  1217.  
  1218.             | argument contains spaces!) 
  1219.             | The defined date format will result in a date  looking  like
  1220.             | this : 'Friday 11 Sep 1992' 
  1221.  
  1222.           Note. The TFORMAT codes are also supported with DFORMAT. 
  1223.  
  1224.         o [TFORMAT <fmtstr>]
  1225.  
  1226.           Everything said for  DFORMAT  is  true  for  TFORMAT,  the  only
  1227.           difference is the specific set of time item codes :
  1228.  
  1229.             - H : insert the hour in 24 hour mode (0..23);
  1230.             - h : insert the hour in 12 hour mode (0..11);
  1231.             - i : insert the minutes;
  1232.             - s : insert the seconds;
  1233.             - T : insert AM  or  PM  according  to  the  hour  ('T'  works
  1234.                   independent from 'H' and 'h', in other words  you  don't
  1235.                   have to use 12 hour mode to use AM/PM!).
  1236.  
  1237.             | 'TFORMAT %h:%m_%T' : gives time like '08:53_AM'.
  1238.  
  1239.             | 'TFORMAT \e[1m%h\e[0m:\e[3m%i\e[0m:\e[4m%s\e[0m' : gives   a
  1240.             | time like : '14:30:18'. 
  1241.  
  1242.           Note. The DFORMAT codes are also supported with TFORMAT. 
  1243.  
  1244.        B. Predefined listing table formats.
  1245.  
  1246.           As a shortcut,  DirKing  has  several  predefined  formats,  for
  1247.           selecting  a  listing  order,  a  date-  or  timeformat.   These
  1248.           predefined formats can be accessed by their appropriate code.
  1249.  
  1250.         o [LISTF <code 0..4>]
  1251.  
  1252.           The following listing order formats are supported :
  1253.  
  1254.             - 0 : NKBLADT (default)
  1255.             - 1 : NAKLBDT
  1256.             - 2 : NADTLBK
  1257.             - 3 : NDALBKT
  1258.             - 4 : ALBKDTN
  1259.  
  1260.         o [DATEF <code 0..7>]
  1261.  
  1262.           The following dateformats are supported :
  1263.  
  1264.            - 0  : '%d-%M-%y'  -> DOS format dd-mmm-yy (e.g. '14-Aug-92')
  1265.            - 1  : '%y-%M-%d'  -> INT format yy-mmm-dd (e.g. '92-Aug-14')
  1266.            - 2  : '%m-%d-%y'  -> USA format mm-dd-yy  (e.g. '08-14-92')
  1267.            - 3  : '%d-%m-%y'  -> CDN format dd-mm-yy  (e.g. '14-08-92')
  1268.            - 4  : '%w %d-%M-%y' -> (DOS format - e.g. 'Fr 11-Sep-92')
  1269.            - 5  : '%w %y-%M-%d' -> (INT format - e.g. 'Fr 92-Sep-11')
  1270.            - 6  : '%w %m-%d-%y' -> (USA format - e.g. 'Fr 09-11-92')
  1271.            - 7  : '%w %d-%m-%Y' -> (CDN format - e.g. 'Fr 11-09-92')
  1272.  
  1273.         o [TIMEF <code 0..3>]
  1274.  
  1275.           The following timeformats are supported :
  1276.  
  1277.             - 0 : '%H:%i:%s'     (e.g. '14:30:00' )
  1278.  
  1279.  
  1280.                                        DirKing v2.10 User Manual - Page 20
  1281.  
  1282.             - 1 : '%h:%i:%s-%T'  (e.g. '02:30:00 PM') 
  1283.             - 2 : '%H:%i'        (e.g. '14:30')
  1284.             - 3 : '%h:%i-%T'     (e.g. '02:30 PM')
  1285.  
  1286.        C. Free formatting and script generation. -> [LFORMAT <fmtstr>]
  1287.  
  1288.  
  1289.           LFORMAT is the only way to  have  full  control  on  the  actual
  1290.           listing print  format.  I  say  'actual  listing'  because  when
  1291.           LFORMAT is used, no listing head, title or end will be  printed.
  1292.           The main use of LFORMAT  will  probable  be  the  generation  of
  1293.           scripts, but you don't have to limit it to this.
  1294.  
  1295.           IMPORTANT : LFORMAT MUST ALWAYS  BE  THE  LAST  ARGUMENT,  SINCE
  1296.           EVERYTHING AFTER THE LFORMAT  KEYWORD  IS  PART  OF  THE  FORMAT
  1297.           STRING!! (This means that quotation marks may only  be  used  if
  1298.           they're needed in the output!)
  1299.  
  1300.           The 'LFORMAT' option works in the same way as  in  the  AmigaDOS
  1301.           'List'  command,  so  you  should  have   no   difficulties   to
  1302.           understand the use of it.
  1303.  
  1304.           The format string can  contain  three  sorts  of  text.  Firstly
  1305.           normal text, secondly the substitution operators (like  '%S'  or
  1306.           '%N'), and thirdly AmigaDOS print control  sequences  (refer  to
  1307.           the  previous  explanation  on  the  use  of  these  in   format
  1308.           strings). Like the AmigaDOS command  'List',  DirKing  uses  two
  1309.           sorts of substitution operators :      
  1310.  
  1311.           a. Usage of '%S' operators.
  1312.  
  1313.           The usage of '%S' substitution  operators  is  limited,  because
  1314.           you only have access to the name and path of  directory  entries
  1315.           (files/directories). To  know  where  and  what  information  to
  1316.           print, DirKing uses the followig table of '%S' occurences :
  1317.  
  1318.             Occurences  1st     2nd     3rd     4th     5th     6th...  
  1319.             1           name    -       -       -       -       -
  1320.             2           path    name    -       -       -       -
  1321.             3           name    path    name    -       -       -
  1322.             4           path    name    path    name    -       -
  1323.             5           name    path    name    path    name    -
  1324.             6           path    name    path    name    path    name
  1325.             ...
  1326.  
  1327.             | 'LFORMAT Path:[%s]   Name:[%s]' :  Just  try  this   format-
  1328.             | string on a directory  and  see  the  magic.  Note  that  no
  1329.             | quotation marks were used, since  these  aren't  needed  for
  1330.             | LFORMAT, unless you want them in the output!
  1331.  
  1332.           b. Usage of field specific operators.
  1333.  
  1334.           The  usage  of  '%S'   substitution   operators   isn't   really
  1335.           recommended since its range is limited, and  the  format  string
  1336.           can sometimes be hard to read if many operators are  used.  It's
  1337.           better to use  the  field  specific  operators,  since  you  can
  1338.           exactly specify which field to print, and where to print it. 
  1339.  
  1340.           DirKing supports the same field substitution  operators  as  the
  1341.           AmigaDOS command  'List'.  These  operators  consist  of  a  '%'
  1342.           character followed by one of the following codes :
  1343.  
  1344.  
  1345.                                        DirKing v2.10 User Manual - Page 21
  1346.  
  1347.             - N : print file/directory name;
  1348.             - K : print file/directory diskkey;
  1349.             - B : print filesize in blocks ('Dir' is used for dirs.);
  1350.             - L : print filesize in bytes ('Dir' is used for dirs.);
  1351.             - A : print file/directory attributes (protectionflags);
  1352.             - D : print file/directory datestamp;
  1353.             - T : print file/directory timestamp;
  1354.             - C : print file/directory filenote   (comment);   prints   an
  1355.                   empty string if no comment is present;
  1356.             - P : print the path of the file  or  directory,  relative  to
  1357.                   the scanned path;
  1358.             - F : print the full  path  name  of  the  file  or  directory
  1359.                   (thus beginning with the volume name).
  1360.  
  1361.             | Assume current directory is 'Workbench:Devs'
  1362.             | 'DirKing keymaps LFORMAT File:[%N] Path:[%P] FullP:[%F]'
  1363.             | DirKing will read  the  'Workbench:Devs/KeyMaps'  directory.
  1364.             | The output can then be something like this :
  1365.             | 'File:[usa] Path:[] FullP:[KeyMaps]'
  1366.             | If you also use  FULLPATH  in  the  command  line  then  the
  1367.             | output will be :
  1368.             | 'File:[usa] Path:[] FullP:[Workbench:Devs/KeyMaps]'
  1369.  
  1370.             | 'DirKing TO RAM:script FILES LFORMAT RENAME %N %N.iff' :
  1371.             | This will  generate  a  script  in  the  'RAM:'  disk.  When
  1372.             | executed, the rename commands will add an  'iff'  suffix  to
  1373.             | the name of files found in the current directory. 
  1374.  
  1375.        º7 DirKing MULTI-mode (multiple directory scanning). -> [MULTI]
  1376.           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1377.           The MULTI mode was implemented to present  a  more  flexible way
  1378.           of scanning several disks in a  row. If DirKing is first started
  1379.           with  MULTI  in  its  command  line,  then  the  directory  will
  1380.           immediately be read. When the listing has been printed,  instead
  1381.           of breaking off, DirKing will print a prompt giving  the  choice
  1382.           between the following operations :
  1383.  
  1384.             - S : start scanning the directory. 
  1385.  
  1386.                   If you want to read several disks, then you must  use  a
  1387.                   drive name as  the  path  (e.g.  'DF1:').  DirKing  will
  1388.                   then always scan the disk in  drive  'DF1:'.  (Otherwise
  1389.                   if you type the name of a disk like  'Workbench:',  then
  1390.                   each time you press  'S'  to  reply  the  MULTI  prompt,
  1391.                   DirKing will always access that disk.)
  1392.  
  1393.                   The  only  time  MULTI  mode  is  useful   when   you've
  1394.                   specified a  path  other  than  a  drive  name,  is  for
  1395.                   printing several copies of that directory.   
  1396.  
  1397.             - Q : quit DirKing.
  1398.  
  1399.             - A : let's you enter new DirKing  arguments,  just  like  you
  1400.                   would when starting  DirKing.  It's  important  to  know
  1401.                   that you don't have to  type  'DirKing'  anymore,  since
  1402.                   you  aren't  starting  the  program!   Only   type   the
  1403.                   arguments.
  1404.             
  1405.                   REMARK: when you don't type anything when  DirKing  asks
  1406.                           for new arguments, then the old  arguments  will
  1407.  
  1408.  
  1409.                                        DirKing v2.10 User Manual - Page 22
  1410.  
  1411.                           be used again.
  1412.  
  1413.                   Note: you  don't  have  to  type  MULTI  anymore,  since
  1414.                         DirKing will stay in MULTI  mode  until  an  error
  1415.                         occurs, or you want to quit the program.
  1416.  
  1417.             - U : will print the DirKing usage prompt, so you  would  know
  1418.                   the correct syntax before entering new arguments.
  1419.  
  1420.        º8 Listing styles.
  1421.           ~~~~~~~~~~~~~~~
  1422.           DirKing normally prints the files in plain characters,  and  the
  1423.           directories in italic. The directory entries are  also  indented
  1424.           to show the structure of the directory.
  1425.             
  1426.        A. Information format.
  1427.  
  1428.         o [SHOWLEVEL]
  1429.  
  1430.           Instead of indenting with spaces ('   '),  DirKing  will  indent
  1431.           with '__' for files and '_/' for directories. SHOWLEVEL is  very
  1432.           useful to get a clear view of the directory tree structure.
  1433.  
  1434.             | 'DirKing  RAM:  SHOWLEVEL  ALL  DIRS' : you'll get  a  clear
  1435.             | view of the directory tree of your  'Ram  Disk'.  Note  that
  1436.             | the  use  of   DIRS   forces   DirKing   only   to   include
  1437.             | directories.
  1438.  
  1439.         o [BINFLAGS]
  1440.  
  1441.           By default DirKing uses 'hsparwed' to represent  the  file-  and
  1442.           directory attributes (protectionflags). BINFLAGS will result  in
  1443.           a   binary   value   representation  (e.g.  00010000)  of  these
  1444.           attributes.
  1445.  
  1446.         o [DATES]
  1447.  
  1448.           Like the AmigaDOS command 'List', DirKing will use the  daynames
  1449.           (Sunday...Saturday) of the dates  if  they're  within  the  last
  1450.           week     of     the     current     date.     Besides      these
  1451.           'Yesterday','Today','Tomorrow' and 'Future' are also used.
  1452.  
  1453.           You can disable this by using 'DATES'. This  forces  DirKing  to
  1454.           print all dates in the  same date format (the default is DD-MMM-
  1455.           YYY).
  1456.  
  1457.         o [HEXVAL]
  1458.  
  1459.           Normally all values printed in the listing are in their  decimal
  1460.           notation.  Using  'HEXVAL'  instructs   DirKing   to   use   the
  1461.           hexadecimal  notation  instead.  (When  the  'DiskInfoBlock'  is
  1462.           printed in the listing header, then all values will be  preceded
  1463.           by '$' character).
  1464.  
  1465.        B. Listing print styles.
  1466.  
  1467.           The following options define in which style  the  entire  listig
  1468.           is printed, and also how the directory entries  themselves  will
  1469.           be printed.
  1470.  
  1471.  
  1472.  
  1473.                                        DirKing v2.10 User Manual - Page 23
  1474.  
  1475.         o [DIRSTYLE [r|i|b|y|f|a|e][r|i|b|y|f|a|e]]
  1476.  
  1477.           The   default  print  style  for  files  is  plain  text,  while
  1478.           directories use italics. These styles can be  altered  by  using
  1479.           predifined style codes. Only the first  two  characters  of  the
  1480.           'DIRSTYLE's  data-argument  will  be  used,  where   the   first
  1481.           character gives the style for directories, and  the  second  for
  1482.           files. (One character data-arguments are also valid,  the  files
  1483.           will  then  be  printed  in  their  default  style,  while   the
  1484.           directories will use the specified style.) 
  1485.  
  1486.           The following character style codes are supported :
  1487.  
  1488.             - R : Red 
  1489.             - I : Italic 
  1490.             - B : Bold
  1491.             - Y : Yuppy -> Red/Italic
  1492.             - F : Fat   -> Red/Bold
  1493.             - A : All   -> Red/Italic/Bold
  1494.             - E : Elite -> Italic/Bold
  1495.             - N : Normal (plain)
  1496.  
  1497.           Note:  DIRSTYLEs determine in  which  style  a  directory  entry
  1498.                  will be printed. If you want to print  a  specific  field
  1499.                  in another style, then you  must  make  use  of  AmigaDOS
  1500.                  print  control  sequences  with  the  LISTORD,   DFORMAT,
  1501.                  TFORMAT arguments.
  1502.  
  1503.             | 'DIRSTYLE ab' : print the directories  in  red,  italic  and
  1504.             |                 bold  characters,  and  the  files  in  bold
  1505.             |                 characters.
  1506.  
  1507.         o [PRTSTYLE {rdlbpes}]
  1508.  
  1509.           If the DirKing  output  is  directed  to  the  printer, then the
  1510.           printer style settings won't be changed,  unless  the  following
  1511.           codes are given :
  1512.  
  1513.             - R : reset to normal characters
  1514.             - D : print in draft quality
  1515.             - L : print in near_letter_quality
  1516.             - B : print in subscript
  1517.             - P : print in superscript
  1518.             - E : print in elite (12 cpi)
  1519.             - S : print with doublestriking
  1520.  
  1521.             | 'PRTSTYLE de' : print in elite and draft quality.
  1522.  
  1523.        º9 Listing output redirection.
  1524.           ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1525.           The default output is to the  Shell  window  where  DirKing  was
  1526.           started. Although you can use  the  AmigaDOS  redirection  (e.g.
  1527.           '>PRT:')  to  output  somewhere   else,   it's   sometimes   not
  1528.           recommended. This is the case when you use  TRACE  for  example.
  1529.           If you would use AmigaDOS  redirection  when  TRACE  is  active,
  1530.           then  all  TRACE  information  would  be  send   to   this   new
  1531.           destination,  which  isn't  what   you   want.   Therefore   two
  1532.           redirection arguments were implemented in DirKing to  split  the
  1533.           output.  The  DirKing  messages  (e.g.  TRACE  information)  are
  1534.           printed in the Shell window as usual, but the directory  listing
  1535.  
  1536.  
  1537.                                        DirKing v2.10 User Manual - Page 24
  1538.  
  1539.           listing will be send to the selected output device.  
  1540.  
  1541.         o [PRT]
  1542.  
  1543.           a. General use.
  1544.  
  1545.           As the argument keyword suggest, this  redirects  the  directory
  1546.           listing to the printer ('PRT:').
  1547.  
  1548.           b. Use in MULTI-mode.
  1549.  
  1550.           When DirKing has to send the directory listing, it  first  opens
  1551.           a channel to the  printer  (this  is  called  'locking'). As you
  1552.           know from the explanation of MULTI, DirKing  doesn't  break  off
  1553.           after printing the directory, instead a prompt is printed.  When
  1554.           you reply this prompt with  'S'  then  DirKing  starts  scanning
  1555.           again. DirKing will then  send  this  listing  again  along  the
  1556.           previously opened channel.
  1557.  
  1558.           It's  important to note that DirKing doesn't close  this  output
  1559.           channel when in MULTI-mode, since DirKing always uses  the  same
  1560.           arguments. ONLY when new arguments are entered (the  prompt  was
  1561.           replied with 'A'), then DirKing will close this  output  channel
  1562.           (and open a new channel to the  new  specified  output  device)!
  1563.           DirKing does this to make sure it always has  direct  access  to
  1564.           the  printer,  so   the   listing   can   be   printed   without
  1565.           interruptions.
  1566.  
  1567.         o [TO <file>]
  1568.  
  1569.           a. General use.
  1570.  
  1571.           With the 'TO'  argument  you  can  send  the  directory  listing
  1572.           anywhere you like, as long as it's a valid AmigaDOS path.
  1573.  
  1574.             | 'DirKing  DF1:  TO  RAM:df1'  will  output  the  listing  of
  1575.             | 'DF1:' to a file in RAM: called 'df1'.
  1576.  
  1577.             | 'TO PRT:' : naturally you can also use the  TO  argument  to
  1578.             |             send the directory listing to the printer.
  1579.  
  1580.           b. Use in MULTI-mode.
  1581.  
  1582.           As mentioned with 'PRT', DirKing only opens the  output  channel
  1583.           once. Only when new  arguments  are  supplied  is  this  channel
  1584.           closed, and another opened if needed.
  1585.  
  1586.           This way of working is extremely  useful,  since  you  can  send
  1587.           several directory listings to one file.  All  listings  will  be
  1588.           placed after one another.
  1589.  
  1590.             | 'DirKing  DF1:  TO  RAM:df1_dirs  MULTI'   will   send   all
  1591.             | directory listings of the disks you've  inserted  in  'DF1:'
  1592.             | to the file in RAM: called 'df1_dirs'
  1593.  
  1594.           c. Use in conjunction with PRT.
  1595.  
  1596.           If only 'TO' is used, then DirKing will save  the  listing  with
  1597.           the Shell control  sequences.  When  you  also  use  'PRT'  then
  1598.           DirKing will use the printer control sequence instead. 
  1599.  
  1600.  
  1601.                                        DirKing v2.10 User Manual - Page 25
  1602.  
  1603.           Let's take a  look  at  the  printing  of  bold  characters,  to
  1604.           demonstrate the difference between these control sequences :
  1605.  
  1606.             -> Shell control sequences > bold on  : 'esc[1m' 
  1607.                                          bold off : 'esc[0m' <<
  1608.             -> Print control sequences > bold on  : 'esc[1m'
  1609.                                          bold off : 'esc[22m' <<
  1610.  
  1611.        º10 Listing paging. -> [NEWPAGE [[{th}]<#>]
  1612.            ~~~~~~~~~~~~~~~
  1613.           By  default DirKing will print the directory listing in one  go.
  1614.           If a long listing is send to a Shell  window,  then  it  can  be
  1615.           annoying to see it flying by. To prevent this from happening,  a
  1616.           paging facility was implemented in DirKing.
  1617.  
  1618.           The NEWPAGE argument  can  be  used  in  three  different  ways.
  1619.           Besides this, the effect of  'NEWPAGE'  isn't  always  the  same
  1620.           when output is send to the Shell, to a file or to the printer. 
  1621.  
  1622.           a. Command : 'NEWPAGE'.
  1623.  
  1624.           When only 'NEWPAGE' is used,  and  output is redirected by 'PRT'
  1625.           or  'TO  <file>' then at the end a new page  character  will  be
  1626.           send.
  1627.  
  1628.           REMARK: the bare 'NEWPAGE' command has  no  effect  when  output
  1629.                   is send to your Shell window!  
  1630.  
  1631.           b. Command : 'NEWPAGE <#>'. 
  1632.  
  1633.           NEWPAGE will mostly be used in  this  way.  By  adding  a  value
  1634.           (greater than 10) to the NEWPAGE keyword, you  can  specify  how
  1635.           many lines should be printed on each page.
  1636.  
  1637.           If  output  is  send  to  your  Shell  window, then DirKing will
  1638.           display a RETURN-prompt when the  specified  maximum  lines  has
  1639.           been reached. When RETURN is pressed, the Shell window  will  be
  1640.           cleared, and the next number of  lines  will  be  printed.  This
  1641.           process will be repeated  until  the  entire  listing  has  been
  1642.           printed.
  1643.  
  1644.           When  output  is  redirected  with  'PRT'  or  'TO  <file>' then
  1645.           instead of printing a RETURN-prompt in the Shell window,  a  new
  1646.           page charachter will be inserted  in  the  listing.  This  means
  1647.           that, if for instance output is send to the  printer,  that  the
  1648.           paper will be ejected, each time the specified number  of  lines
  1649.           is reached. As with the  bare  'NEWPAGE'  command,  a  new  page
  1650.           character will be send at the end of the listing.
  1651.  
  1652.             | 'NEWPAGE 20' : only print 20 lines on a page.
  1653.  
  1654.           REMARK: If the given value is less than 10, then the  number  of
  1655.                   lines will be set to 10!
  1656.  
  1657.           c. Command : 'NEWPAGE {ht}' or 'NEWPAGE {ht}<#>'.
  1658.  
  1659.           The  NEWPAGE  argument  also  supports  two  additional options,
  1660.           which are indicated by the  following  characters  (all  options
  1661.           can be used at once)  and  are  used  in  conjunction  with  the
  1662.           commands as explained in (a.) en (b.) :
  1663.  
  1664.  
  1665.                                        DirKing v2.10 User Manual - Page 26
  1666.  
  1667.             - H : after  the  listing  header  is  printed,  a  new   page
  1668.                   character will be send.
  1669.  
  1670.             - T : always print a listing  title  at  the  beginning  of  a
  1671.                   new page. 
  1672.  
  1673.             | 'NEWPAGE h' : after the listing head has been  printed,  use
  1674.             |               a new page to print the actual listing.
  1675.  
  1676.             | 'NEWPAGE ht20' : print  the  listing  header  on  one  page,
  1677.             |                  then use only 20 lines per  page  to  print
  1678.             |                  the listing itself.
  1679.  
  1680.        º11 Disk identification coding support.  -> [DISKID <str>]
  1681.            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1682.           a. General use.
  1683.  
  1684.           If  you  use  a  catalog  tool  to  keep  track  of  your   disk
  1685.           collection, then this feature of  DirKing  is  very  useful.  It
  1686.           enables you to insert a string (this can be a disk ID  used  for
  1687.           cataloging your disks, or any  other  message)  in  the  listing
  1688.           header.  
  1689.  
  1690.           REMARK: Most times the DISKID string  will  contain  spaces,  in
  1691.                   which case you must  place  the  string  between  double
  1692.                   quotation marks.  
  1693.  
  1694.             | 'DISKID PD0/00.0000' : this disk ID will be printed  in  the
  1695.             |                        header.
  1696.  
  1697.             | 'DISKID "This is a  test  ID  string!"' : prints this string
  1698.             | in the listing header (notice the double quotation marks).
  1699.  
  1700.           b. Use in MULTI-mode. 
  1701.  
  1702.           The disk ID string that was typed  in  the  command  line  (thus
  1703.           when starting DirKing from Shell) will only be used  once!  Each
  1704.           time you reply the  MULTI  prompt  with  'S'  (start  scanning),
  1705.           DirKing will first ask  to  enter  a  new  disk  ID  string  (or
  1706.           message) before reading the directory.
  1707.  
  1708.        º12 DirKing program information.  -> [VERSION]
  1709.            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1710.           VERSION simply  instructs  DirKing  to  print  the  version  and
  1711.           copyright prompt.
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.                                        DirKing v2.10 User Manual - Page 27
  1730.  
  1731.        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1732.                      APPENDIX : DIRKING KEYWORD REFERENCE  
  1733.        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1734.         Pattern matching . . . . . . . . . . . . . . . . . . . . . .  4
  1735.         ---------------------------------------------------------------
  1736.         <path|patt>. . . [[F|D|]<path|patt>] . . . . . . . . . . . .  5
  1737.         ALL. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  1738.         BARELIST . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1739.         BINFLAGS . . . . . . . . . . . . . . . . . . . . . . . . . . 23
  1740.         DATEF. . . . . . [DATEF <0..7>]. . . . . . . . . . . . . . . 20
  1741.         DATES. . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
  1742.         DESC . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  1743.         DF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  1744.         DFORMAT. . . . . [DFORMAT <fmtstr>]. . . . . . . . . . . . . 19
  1745.         DIRS . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  1746.         DIRSTYLE . . . . [DIRSTYLE [r|i|b|y|f|a|e][r|i|b|y|f|a|e]] . 24
  1747.         DISKID . . . . . [DISKID <str>]. . . . . . . . . . . . . . . 27
  1748.         DISKINFO . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  1749.         ENDMSG . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1750.         EXCL . . . . . . [EXCL {fkbladtc}] . . . . . . . . . . . . . 16
  1751.         EXPAND . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  1752.         FD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  1753.         FILES. . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  1754.         FROM..TO . . . . [FROM [F|D|]<ch> TO <ch>] . . . . . . . . . 10
  1755.         FULLPATH . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1756.         HEAD . . . . . . [HEAD {fdvpimtse}]. . . . . . . . . . . . . 14
  1757.         HEXVAL . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
  1758.         INCL . . . . . . [INCL {fkbladtc}] . . . . . . . . . . . . . 16
  1759.         LFORMAT. . . . . [LFORMAT <fmtstr>]. . . . . . . . . . . . . 21
  1760.         LISTF. . . . . . [LISTF <0..4>]. . . . . . . . . . . . . . . 20
  1761.         LISTORD. . . . . [LISTORD <fmt>] . . . . . . . . . . . . . . 18
  1762.         MAXHEAD. . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1763.         MAXWIDTH . . . . [MAXWIDTH <#>]. . . . . . . . . . . . . . . 17
  1764.         MIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  1765.         MULTI. . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1766.         NEWPAGE. . . . . [NEWPAGE [[{th}]<#>]] . . . . . . . . . . . 26
  1767.         NOHEAD . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1768.         NOSORT . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  1769.         NOSTAT . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1770.         PASS . . . . . . [PASS [F|D|]<pattern>]. . . . . . . . . . .  9
  1771.         PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  1772.         PRT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
  1773.         PRTSTYLE . . . . [PRTSTYLE {rdlbpes}]. . . . . . . . . . . . 24
  1774.         QUICK. . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1775.         READ . . . . . . [READ [F|D|]<pattern>]. . . . . . . . . . .  9
  1776.         SHOWLEVEL. . . . . . . . . . . . . . . . . . . . . . . . . . 23
  1777.         SINCE. . . . . . [SINCE "[F|D|]<[DOSdate] [time]>"]. . . . . 11
  1778.         SORT . . . . . . [SORT {nksadtc}]. . . . . . . . . . . . . . 16
  1779.         SUB. . . . . . . [SUB [F|D|]<string>]. . . . . . . . . . . . 10
  1780.         TFORMAT. . . . . [TFORMAT <fmtstr>]. . . . . . . . . . . . . 20
  1781.         TIMEF. . . . . . [TIMEF <0..3>]. . . . . . . . . . . . . . . 20
  1782.         TO . . . . . . . [TO <file>] . . . . . . . . . . . . . . . . 25
  1783.         TOLEVEL. . . . . [TOLEVEL <#>] . . . . . . . . . . . . . . .  8
  1784.         TRACE. . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1785.         UPTO . . . . . . [UPTO "[F|D|]<[DOSdate] [time]>"] . . . . . 11
  1786.         VERSION. . . . . . . . . . . . . . . . . . . . . . . . . . . 27
  1787.  
  1788.        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1789.         DirKing v2.10e, Copyright ⌐1991-1992 by Chris P. Vandierendonck,
  1790.                         All Rights Reserved.
  1791.  
  1792.  
  1793.                                        DirKing v2.10 User Manual - Page 28
  1794.