home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / utility / disk / sortie12 / sortie12.asc < prev   
Text File  |  1993-02-06  |  10KB  |  242 lines
  1.  
  2.                            Sortie™ v1.2 by Terry May
  3.                          Copyright © 1993, Shark Bytes
  4.  
  5.                                F R E E W A R E !
  6.  
  7.  
  8.  VERSIONS:
  9.  """""""""
  10.  
  11.      1.0 - 22-May-91 - First public release!
  12.      1.1 - 01-Feb-93 - Added -Date sort.
  13.      1.2 - 06-Feb-93 - Fixed cosmetic bug with long folder names.
  14.  
  15.  
  16.  INTRODUCTION:
  17.  """""""""""""
  18.  
  19.      Sortie was conceived while T² Ltd. owned BBS Express! ST, and was our
  20.  first freeware offering at T² Ltd.  BBS Express! ST has long since been
  21.  sold to C&R Systems, but Sortie lives on -- now under Shark Bytes, my
  22.  freeware/software 'company.'  Although this program was designed and
  23.  written mainly for use as an Express! utility, there are many other uses
  24.  for a utility of this nature.
  25.  
  26.      What Sortie does is sort the files in any directory, alphabetically
  27.  or by date (in ascending or descending order).  Although the desktop and
  28.  many programs will show you the files in order by Name or by Date (none
  29.  in ascending order, that I know of), there are many programs, such as BBS
  30.  Express! ST and most picture slide shows, that show files in the order
  31.  they are on disk.  Well, Sortie sorts them on disk in a perfectly SAFE
  32.  way, so that the program in question shows them in the order you wish.
  33.  
  34.      You've probably seen programs that allow you to sort your AUTO
  35.  folder, to put programs in a certain order.  And you may have seen
  36.  programs that allow you to sort files in alphabetical order.  Sortie will
  37.  not allow you to sort your directories on a file by file basis, but it
  38.  will allow you to sort by Name and by Date, probably easier and faster
  39.  than any other program currently in existance.
  40.  
  41.      Sortie operates in two modes, which I'll call "Batch" and "Manual":
  42.  
  43.  
  44.  BATCH MODE:
  45.  """""""""""
  46.  
  47.      In Batch mode, Sortie will take on a command line the path\filename
  48.  of an ASCII list (data file) of folders you'd like sorted, in the
  49.  following format:
  50.  
  51. D:\SORTIE\SORTIE.DAT [-DATE|+DATE]
  52.  
  53.      The path\filename can be anything and doesn't have to have a DAT
  54.  extender (or any extender at all).  Capitalization is optional and can
  55.  even be mixed.  "-DATE" and "+DATE" are optional parameters that tell
  56.  Sortie to sort by Date in descending or ascending order, respectively.
  57.  If "-DATE" or "+DATE" are not found, a Name sort will be done.
  58.  
  59.      Your data file can contain comments or anything else you wish.  Just
  60.  be sure that all valid path\filenames start in the first column and
  61.  contain a drive specification.  (Sortie looks at the 2nd character in
  62.  each line for a ":" character to determine whether it's a path or a
  63.  comment.)  Trailing backslashes (\) are entirely optional, as is
  64.  capitalization.  Examples:
  65.  
  66. c:           <- Good
  67. D:\Files     <- Good
  68. e:\FILES\    <- Good
  69.  
  70. c            <- Bad
  71.  D:\Files    <- Bad
  72. \FILES\      <- Bad
  73.  
  74.      Sortie will ignore any line that doesn't follow the prescribed
  75.  format.  If the line follows the prescribed format (i.e., any line with
  76.  ":" as the second character), but can't find the path, no harm is done.
  77.  Sortie will simply ring the bell, display "NOT FOUND" in the status
  78.  window, and then go on to the next line.
  79.  
  80.      It is not possible to sort folders by Name and Date on an individual
  81.  basis within a Batch listing.  ALL folders will be sorted either by Name
  82.  or by Date, depending on the parameters sent on the command line.  To
  83.  sort on a folder by folder basis, use Manual mode or run Batch mode two
  84.  or three times, using two or three separate data files and command lines.
  85.  
  86.  
  87.  MANUAL MODE:
  88.  """"""""""""
  89.  
  90.      Manual mode allows you to use the file selector to sort your
  91.  directories one at a time.  This mode is automatically envoked if Sortie
  92.  is not given a valid path\filename on the command line, or if no command
  93.  line was used.
  94.  
  95.      You will first be presented with an Alert box, asking if you wish to
  96.  sort by -Date, Name or +Date.  (Name is initially the default button, but
  97.  after the 1st use on any session, the default will be the last button
  98.  pressed.)
  99.  
  100.      Select -Date for sorting by date in descending order (i.e., newest
  101.  files first); select Name for sorting by name, in alphabetical order; and
  102.  select +Date for sorting by date in ascending order (oldest files first).
  103.  
  104.      Next you'll be given the file selector.  Simply choose the directory
  105.  or folder you wish to sort and press Return.  If you change your mind and
  106.  don't want to sort any directory, simply click on CANCEL in the file
  107.  selector.
  108.  
  109.      After Sortie is done doing its thing you will again be presented the
  110.  Alert box.  Again choose your preferred sorting method for sorting a new
  111.  folder.  If you don't wish to sort anymore folders, simply click on any
  112.  of the three buttons (or press Return) and then click on Cancel in the
  113.  file selector.
  114.  
  115.  
  116.  SCREEN DISPLAY:
  117.  """""""""""""""
  118.  
  119.      After receiving a valid path from your Batch list or from Manual
  120.  mode, Sortie will go to work on sorting that directory.  In the upper
  121.  left hand corner is the File Counter.  It counts only files that are
  122.  being sorted.  In the upper center is the Folder being sorted.  And in
  123.  the upper right corner is the Status indicator.
  124.  
  125.      The middle (and vast majority) of the screen is used to display the
  126.  files currently being sorted.  They will first be shown in inverse, with
  127.  the Status indicator showing "Sorting."  They will then be displayed
  128.  again in normal text, with the Status indicator showing "Writing."
  129.  
  130.      The screen will hold 100 filenames.  If you're sorting more than
  131.  that, Sortie will not clear the screen, but will simply start over in the
  132.  first filename 'slot.'  The screen is not cleared, so that you can see
  133.  what Sortie has done on the previous screen.  A ">" marker tells you what
  134.  file is currently being sorted, so there is no confusion.
  135.  
  136.      With each new sort (even if there are no files to sort), the screen
  137.  will be cleared, as if you were starting new.
  138.  
  139.  
  140.  MISCELLANEOUS:
  141.  """"""""""""""
  142.  
  143.      - Worry not about what Sortie is doing to your fragile drive.  Sortie
  144.  does not directly access your FAT; it uses only _legal_ GEMDOS calls.
  145.  It is literally as safe as renaming files from your desktop.
  146.  
  147.      - If Sortie gives you an "Error 36" Alert box, check the folder
  148.  you're sorting for a folder named \ZZZZZ\.  If found, MOVE all files (if
  149.  any) from the \ZZZZZ\ folder to their original folder and then delete the
  150.  \ZZZZZ\ folder.  Sortie uses a \ZZZZZ\ folder for temporary storage, and
  151.  if it is aborted for any reason during the sorting process, you'll have
  152.  to do this to restore those files to their original directory and before
  153.  that original directory can be sorted again.
  154.  
  155.      - Sortie requires at least 2k of free space on the drive you're
  156.  sorting, more if you have lots of files in that directory (figure an
  157.  additional 1k for every 75 files or so).  If you try to sort a directory
  158.  on a drive without enough free space, no harm will be done, but Sortie
  159.  will abort and you'll be presented with an Alert box.
  160.  
  161.      - Sortie will even sort files that are locked (set to READ ONLY).
  162.  After sorting they'll be restored to locked status.  (Locked files will
  163.  be shown with an (*) asterisk next to them.)
  164.  
  165.      - Sortie will restore your Archive Bits to their original setting
  166.  after it's done.  This is useful if you backup your drives by Archive
  167.  Bit; you surely don't want to backup the same file twice, just because it
  168.  was sorted.
  169.  
  170.      - If you use a PC emulator, it is recommended you do NOT sort the
  171.  root of your PC boot drive, as your System files will be sorted along
  172.  with everything else, likely causing your drive to no longer autoboot.
  173.  
  174.      - Sortie will not run in LOW REZ, due to its 80x25 screen display.
  175.  
  176.      - Maximum files in a folder that can be sorted is 999.  Any files
  177.  over 999 will simply be ignored (no harm done).
  178.  
  179.      - Maximum lines in a Batch data file is 100.  Any lines over 100
  180.  will be ignored (no harm done).
  181.  
  182.      - When using manual sort, Sortie will back out to the parent
  183.  directory (if any) of the last path sorted, the next time it calls up
  184.  the file selector for another sort.  This is handy if you have a lot of
  185.  folders with the same parent directory to sort.
  186.  
  187.      - Sortie will only sort enough files that are necessary to put your
  188.  directory in the proper order.  If the directory is already sorted, it
  189.  won't do anything, obviously.  If it has been previously sorted and then
  190.  you add a file or two, then it's likely Sortie will only have to sort
  191.  some of the files.
  192.  
  193.      - Name sort is useful for putting all your pics in order for a
  194.  slideshow program, or for BBS (Express) programs that show files in the
  195.  order in which they reside on the disk, and you want the files shown in
  196.  alphabetical order.
  197.  
  198.      - -Date sort is useful for BBS (Express) programs that show files in
  199.  the order in which they reside on the disk, and you want the files shown
  200.  by date, with the newest files first.
  201.  
  202.      - +Date sort is useful for BBS (Express) programs that show files in
  203.  the order in which they reside on the disk, and you want the files shown
  204.  by date, oldest files first, particularly for weeding out old uploads.
  205.  
  206.  
  207.  COPYRIGHT:
  208.  """"""""""
  209.  
  210.      The "Sortie" name, program and documentation is a copyright of Shark
  211.  Bytes.  The Sortie program is FREEWARE and may be distributed freely,
  212.  provided this documentation is included and unaltered.
  213.  
  214.  
  215.  WARRANTY:
  216.  """""""""
  217.  
  218.      There is none!  Although Sortie is believed to be perfectly safe, I
  219.  still must insist that you use at your own risk.  Shark Bytes will not
  220.  accept responsibility for damage to hardware or loss of data that results
  221.  from the use or misuse of this program.
  222.  
  223.  
  224.  EPILOGUE:
  225.  """""""""
  226.  
  227.      Geez, so much documentation for such a simple, easy to use program!  :^)
  228.  
  229.      If you have any comments (good or bad), suggestions, or whatever,
  230.  please don't hesitate to drop me a line.  Send private mail to:
  231.  
  232.      Delphi   : OUTRIDER
  233.      GEnie    : OUTRIDER
  234.      FidoNet  : 1:209/745 (Terry May)
  235.      AtariNet : 51:2/0 (Terry May)
  236.      BBS      : 702/435-0786 (Outrider)
  237.  
  238.      Happy sorting...
  239.  
  240.      - Terry May @ Shark Bytes
  241.  
  242.