home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / dos_util / tir109b.zip / TIR.DOC < prev   
Text File  |  1993-10-31  |  6KB  |  115 lines
  1. WHAT?------------------------------------------------------------------------      
  2.       
  3.                ╒═══════════╤═══════════╤═══════════╕
  4.                   │ Tirectory │ Tirectory │ Tirectory │
  5.                ╘═══════════╧═══════════╧═══════════╛
  6.                    The Triple Directory Listing
  7.                           V1.09b by Dave Reynolds
  8.                       
  9.                 internet -    dave.reynolds@canrem.com
  10.              CRS      -    in conference 315 chit_chat
  11.                       
  12.     FREE WARE!!! PAST IT AROUND, JUST DON'T ALTER IT PLEASE!!! 
  13.  
  14. HOW?-------------------------------------------------------------------------
  15.  
  16.  /? or /H - Displays a reminder screen of the switches.
  17.  
  18.   /C      - Display color codes. Brings up example colors showing you
  19.         what each color means.
  20.  
  21.   /P      - Turns OFF the automatic pause.
  22.  
  23.   /N      - NO sort. This is handy if you want to see the files in their
  24.         original order.
  25.   
  26.   /E      - Extension sort. Files are sorted by the .[whatever]
  27.  
  28.   /Z      - siZe sort. Largest to smallest file sizes.
  29.  
  30.   /X      - Displays eXecutables only. (.EXE .COM .SYS .BAT)
  31.  
  32.   /O[ext] - Omit extension.   NO "." should be added just /OEXT I thought of
  33.         this while looking at my Mahjong directory.  Instead of trying to
  34.         list  the  exe's or com's I thought why not just Omit the TIL's.
  35.         So now I just TIR /OTIL and  I  get a list of everything but the
  36.         .til files.
  37.  
  38. EXAMPLE----------------------------------------------------------------------
  39.            
  40.               C:\> TIR D:\Zips\a* /d /p /otxt
  41.       
  42.       This  command would  list  all the files in the ZIPS directory on the
  43.     drive D: that start with A  in  a  Double column with no Pause AND Omit
  44.     any files that have a .TXT extension.
  45.  
  46. WHY?-------------------------------------------------------------------------   
  47.    
  48.    This simple program is intended to supplement the Dos DIR command not (at
  49.   this  point  anyway)  replace  it.   I found that working with the Dos DIR
  50.   often gives you information  that  you  don't  really care about eg.   the
  51.   time.  I almost never look at the time or date.  I started to use the WIDE
  52.   switch with DIR.  But with that you don't even get the file size!
  53.  
  54.     In answer to my own needs I wrote this  little  program  to  display  my
  55.   directories three wide WITH the filesize. Also Dos DIR would only pause if
  56.   you  told  it  to,  so if a directory had tons-o-files you had to do a DIR
  57.   command twice.  Once to find out you couldn't read them all and the second
  58.   to add a /P or /W switch.  Humm.  TIR will pause after 24 lines of display
  59.   by default.   If you need to have it  zip by for some reason the /P switch
  60.   will turn OFF pause.
  61.  
  62.    Having the files sorted by Name is nice to.  So that's the default.    If
  63.   you  want  No  sort then add the /N switch.   Text (name/ext) sorts are in
  64.   ascending alphabetical order.  ie.  abc.  File size sorts are descending.
  65.    
  66.    Then I though "it would be nice to see all the files on the disk" not not
  67.   just the "normal"  files.    But  how  to  display  the attributes without
  68.   putting all kinds of letters and  junk  on  the  screen?    COLOR!    Each
  69.   attribute  or  combination of attributes has it's own color code.   To see
  70.   the codes type TIR /C and there you are.
  71.  
  72.    To install just copy it to your utils directory or any other directory in
  73.   your DOS PATH.  See your Dos manual if you need help with that.
  74.    
  75. ** Switches can be combined and a  file mask can be added.  The one thing to
  76.   remember is the switches MUST come AFTER the file mask on the command line.
  77.   Your file mask and path can be any valid DOS DIR path and  mask.    So  if
  78.   your in C:\DOS> you can do a TIR D:\ZIPS or any other drive or directory.
  79.  
  80. PROBLEMS!--------------------------------------------------------------------  
  81.        
  82.        TIR wont handle more that 500 files... I guess it could.. 
  83.        but I'm not sure how big I can go with arrays on my compiler.
  84.        Learning all the time....
  85.        
  86. STANDARD DISCLAIMER----------------------------------------------------------
  87.       
  88.       NOTHING HERE WILL WORK ON ALL MACHINES OR AT ALL TIMES 
  89.      OR IN ALL WEATHER OR WHEN ITS DAYLIGHT OR WHEN IT'S DARK.
  90.       IN OTHER WORDS USE AT YOUR OWN RISK. NOT THAT I THINK IT WOULD,
  91.       BUT IF SOMETHING BLOWS UP BECAUSE YOU USED THIS PROGRAM
  92.               DON'T COME CRYING TO ME.
  93.                       
  94. REVISIONS--------------------------------------------------------------------
  95.  
  96.       v1.04 - fixes bug when there is only 1 file in a dir.
  97.             - fixes bug when there are no dirs in base dir.
  98.               - adds other drive listings eg.  C:> TIR B:\*.*  [enter]
  99.               will show you the files and free size of the disk in
  100.               drive b:. Then return you to the current directory.
  101.       v1.05 - fixes up the paths when calling TIR 's on other drives.
  102.               eg. C:> TIR B:   and  C:> TIR D:\ZIPS   now works.
  103.             - adds a bit more color to the display
  104.       v1.06 - fixes incomplete file masks  A* will now work.
  105.       v1.07 - adds Omit (/O) option  TIR /ODOC will skip all files 
  106.               with the extension .DOC
  107.       v1.08 - adds the eXecutables only (/X) option.
  108.       v1.09    - adds more graphics.
  109.             - removes the sizing options
  110.       v1.09b- FIXES BUGS!! I reduced the maximum files to 255 for
  111.               testing. Now back to 500. 
  112.             - also fixed screen scroll to account for the graphics lines.
  113.                  
  114. THE END----------------------------------------------------------------------
  115.