home *** CD-ROM | disk | FTP | other *** search
/ Scene Xplorer 1 / Scene_Xplorer_1.iso / c / Dir.doc < prev    next >
Text File  |  1978-01-11  |  7KB  |  258 lines
  1. NewDir V1.4 docs
  2. ----------------
  3.  
  4. Written by MR.BLUESKY
  5. Copyright ©1993-95 DRIFTERS HDC Inc.
  6. All rights reserved
  7.  
  8.  ! FREELY REDISTRIBUTABLE !
  9.  
  10. This program cannot be sold, nor used for ANY commercial purpose
  11. without my personal written permission. You can find my address
  12. at the end of this text.
  13.  
  14. It's provided as is, without any warranty; use it at your own risk !
  15.  
  16. Please DO NOT compress NewDir with an 'executables auto-decompress'
  17. packer, as it may make it crash. Archivers like LhA are ok for
  18. redistribution.
  19.  
  20.  
  21.  
  22. INTRODUCTION
  23. ~~~~~~~~~~~~
  24.  
  25. NewDir is a replacement command for AmigaDos dir & list commands.
  26. It features most options of these commands plus some goodies.
  27. It's of course reentrant and so can be made resident in your system.
  28.  
  29. NewDir is MC68000 upto MC68040 compatible (tested on MC68000, MC68EC20
  30. and MC68040 based machines), but requires at least OS II (2.04).
  31.  
  32. WARNING: NewDir now makes deeper usage of stack, and shell default
  33.      stack size (4096 bytes) may not be enough in some cases
  34.      (deep volumes trees).
  35.      So, if you observe random crashes, increase size to 8KB
  36.      (use the 'stack' command in shell or modify shell startup).
  37.      
  38.  
  39.  
  40. WHAT'S NEW
  41. ~~~~~~~~~~
  42.  
  43. o 12 new possible args/options.
  44.  
  45. o pattern auto-recognition (P option removed).
  46.  
  47. o dynamic output: number of columns is now adjusted according to
  48.   shell window width. Also allows to generate custom output.
  49.  
  50. o shorter & faster code; 68020/030/040 Icaches used as much as
  51.   possible.
  52.  
  53. o bug that sometimes corrupted shell stack now fixed.
  54.  
  55.  
  56.  
  57.  
  58. NEW ARGS/OPTIONS DESCRIPTION
  59. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  60.  
  61. o OPT / keyword   : 'a' options now works (see 'SEARCH' below).
  62.  
  63. o TIMES / switch  : add entries creation times to display.
  64.  
  65. o ATTR / switch   : replaces the BITS switch.
  66.  
  67. o KEYS / switch   : add entries disk keys to display.
  68.  
  69. o SINCE / keyword : show only if later or equal than specified date/time
  70.  
  71.             e.g: nd since=2-mar-94
  72.                  nd since="2-mar-94 14:58"
  73.                  nd since="yesterday 13:15:10"
  74.  
  75.            notes: * words (like month, 'yesterday', 'today'...) must
  76.                     be entered in your own language if your system is
  77.                     localized.
  78.  
  79.                   * Month may be more than 3 chars long (depends on
  80.                     language too); try 'nd DATES' to check this out.
  81.  
  82.                   * Leading 0 in both date & time are not required.
  83.  
  84.               * Stamp must be enclosed by quotes if you specify
  85.                 both date and time.
  86.  
  87.               * Date (if specified) must be entered first.
  88.  
  89.               * Words are case insensitive.
  90.  
  91. o UPTO / keyword  : show only if earlier or equal than specified date/time
  92.  
  93.             e.g: nd upto=11:00
  94.                  nd upto=today
  95.                  nd upto="10-dec-93 12:30:35"
  96.  
  97.           notes: see SINCE notes above.
  98.  
  99. o QUICK / switch  : show only entries names without any further infos.
  100.  
  101. o BLOCK / switch  : show files sizes in blocks rather than in bytes.
  102.  
  103. o NOHEAD / switch : directory head line not displayed.
  104.  
  105. o NOSTAT / switch : directory/volume statistics not displayed.
  106.  
  107. o NOICONS / switch: hide .info files.
  108.  
  109. o NOANSI / switch : output is pure ASCII (monochrome): useful when
  110.             redirected.
  111.  
  112. o SEARCH / switch : show all subdirs contents; useful to look for a 'lost'
  113.             file.
  114.             
  115.             e.g: nd sys:lost.exe search   will search for all
  116.                                           occurences of 'lost.exe'
  117.                                           in all subdirs of sys:
  118.                  
  119.                  nd work:#?.gif search   will search for all GIF
  120.                              files in all subdirs of work:
  121.                              
  122.  
  123. o LFORMAT / keyword: allows you to produce custom directory output; useful
  124.              for script (batch) files creation.
  125.              
  126.              e.g:
  127.  
  128.         nd >ram:arf work:#?.gif LFORMAT="rename %s%s as %stemp/new_%s"
  129.              
  130.                   will produce a script file (ram:arf) which moves and
  131.                   renames all GIF files from work: root to temp/ , ie:
  132.                   
  133.                   rename work:pict1.gif as work:temp/new_pict1.gif
  134.                   rename work:pict2.gif as work:temp/new_pict2.gif
  135.                     .
  136.                     .
  137.                     .
  138.                   rename work:pict90.gif as work:temp/new_pict90.gif
  139.  
  140.                   
  141.            %s occurences interpretation:
  142.            
  143.                %s       pastes <filename>
  144.                %s%s       pastes <path><filename>
  145.                %s%s %s       pastes <path><filename> <fileaname>
  146.                %s%s %s%s  pastes <path><filename> <path><filename>
  147.                
  148.         Notes: * Names and pathes are always current directory relative.
  149.         
  150.                * Format line must be enclosed by quotes if you enter
  151.                  some space chars.
  152.                   
  153.                              
  154.  
  155. FILE PATTERN PROCESS
  156. ~~~~~~~~~~~~~~~~~~~~
  157.  
  158. As you noticed in the examples above, NewDir now auto-recognizes pattern as
  159. target dir/file.
  160.  
  161. All standard AmigaDos wildcards are supported: ?,#,|,~,[,],%,* (optional in
  162. OS II). See your AmigaDos manual for further infos about wildcards.
  163.  
  164. Note: Pattern matching is case-insensitive.
  165.  
  166.  
  167.  
  168.  
  169. OPTIONS / KEYWORDS INCOMPATIBILITIES
  170. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  171.  
  172. Some options or keywords exclude or force other ones. They may also conflict.
  173. Don't panic though, worst conflict CANNOT lead to a crash !
  174.  
  175. Here are the main side effects that you should know about:
  176.  
  177. o INTER: disables QUICK, KEYS, NOANSI options.
  178.      forces DATES, ATTR options.
  179.      unpredictable output if used with LFORMAT.
  180.  
  181. o LFORMAT:
  182.      disables KEYS, DATES, ATTR options.
  183.      forces QUICK, NOANSI, NOHEAD, NOSTATS.
  184.      unpredictable output if used with INTER.
  185.  
  186. o SEARCH:
  187.      disables directory filtering.
  188.  
  189. o HELP:  overrides all other args.
  190.  
  191. o ABOUT: overrides all other args.
  192.  
  193. o SINCE: unpredictable output if used with UPTO in paradoxal way.
  194.  
  195. o UPTO:  unpredictable output if used with SINCE in paradoxal way.
  196.  
  197.  
  198.  
  199. OLD ARGS/OPTIONS
  200. ~~~~~~~~~~~~~~~~
  201.  
  202. The following args/options are unchanged since version 1.3:
  203.  
  204. o OPT (a|d|i)    : only here for Commodore's dir compatibility.
  205.           you should better use OS II new switches instead.
  206.  
  207.           a = SEARCH
  208.           d = DIRS
  209.           i = INTER
  210.           
  211.           see corresponding switches explanations for further infos.
  212.  
  213.  
  214. o DIRS        : shows dirs entries only.
  215.  
  216. o FILES        : shows files entries only.
  217.  
  218. o LINKS        : show links (file and dirs, both hard and soft) only.
  219.  
  220. o DATES        : add entries creation dates to display.
  221.  
  222. o NOSORT    : don't alpha sort entries.
  223.  
  224. o INTER        : start interactive mode; interactive mode output stops after
  225.           each entry and allows you to enter a command.
  226.  
  227.           possible commands are:
  228.           
  229.           *        D = delete entry
  230.           *        T = dump entry contents (ASCII)
  231.           *        H = dump entry contents (Hexadecimal)
  232.           *        C = enter any other AmigaDos command
  233.           *        S = skip entry
  234.           *        Q = quit interactive mode (abort)
  235.           * <RETURN> = S (skip)
  236.           
  237.           
  238.           
  239. o ABOUT            : show NewDir version/credits
  240.  
  241. o HELP        : show NewDir quick help
  242.  
  243. o ?        : show NewDir args template
  244.  
  245.  
  246.  
  247. CONTACT ADDRESS
  248. ~~~~~~~~~~~~~~~
  249.  
  250. If you want to get in touch with me, write to:
  251.  
  252. Lionel GUILLANG
  253. 6, rue de la Martinique
  254. 75018 PARIS
  255. FRANCE
  256.  
  257. No answers guaranted, I'm sooo busy !
  258.