home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / arc / pakutl12.lzh / PAKSORT.DOC < prev    next >
Text File  |  1988-09-09  |  5KB  |  124 lines
  1.  
  2.  
  3.  
  4.  
  5.                                   PAKSORT v1.1
  6.  
  7.                                 9 September 1988
  8.                      Michael J. Housky and Jeffrey J. Nonken
  9.  
  10.         Copyright 1988 by Michael J. Housky and Jeffrey J. Nonken.
  11.         Released to the public domain September 1988. No rights reserved.
  12.  
  13.         PAKSORT will sort the members of one or more archive files,  such 
  14.         as those produced by the Phil Katz's utilities PKPAK and PKPAKJR. 
  15.         It  will  also list archive files produced by newer  versions  of 
  16.         ARC.EXE, or so we believe. For each archive matching a given file 
  17.         specification,  PAKSORT  sorts the members as  specified  in  the 
  18.         command  line.  The sorted result replaces the  original  archive 
  19.         file.
  20.  
  21.         Usage:
  22.  
  23.         PAKSORT filespec [order]
  24.  
  25.         The filespec may include a drive and path. The characters * and ? 
  26.         may be used as wildcards in the filename and extension, with  the 
  27.         *  matching  zero  or more characters, and  the  ?  matching  one 
  28.         character. If no filetype extension is given, a default  filetype 
  29.         of .PAK is assumed.
  30.  
  31.         The  order  is one or more two-character sort criteria.  Each  of 
  32.         these consists of a letter identifying a sort field, followed  by 
  33.         a  plus(+)  for ascending sort order or minus(-)  for  descending 
  34.         sort  order.  The  sort criteria must  be  entered  consecutively 
  35.         without intervening blanks. Sort field letters are:
  36.  
  37.             F  --  sort by "filename.ext" member name
  38.             N  --  sort by "filename" only.
  39.             X  --  sort by ".ext" only.
  40.             D  --  sort by date of last update.
  41.             T  --  sort by time of last update.
  42.             S  --  sort by (original) file size.
  43.  
  44.         Multiple criteria are entered in order of decreasing  importance, 
  45.         so that "D+T+" means sort primarily by date (older to newer)  and 
  46.         then by time (earlier to later) when dates are equal. If no  sort 
  47.         order is specified, then "D+T+F+" is assumed as a default.
  48.  
  49.         One  minor  note:  The  "F"  field  is  sorts  by  the  compacted 
  50.         "name.ext"  (without  imbedded blanks) as stored in  the  archive 
  51.         headers  and  as normally typed at the console.  No  priority  or 
  52.         division  is  given to the "." in this case.  When  member  names 
  53.         contain characters less than "." in the ASCII collating sequence, 
  54.         or nonstandard names are encountered in the archive, the  results 
  55.         may be slightly different from sorting by name then by extension. 
  56.         Normally, this will difference will not be important.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                  PAKSORT v1.1                     page 1
  63.  
  64.  
  65.  
  66.  
  67.         A typical example may look like this:
  68.  
  69.         D>PAKSORT BBSLIST X-N+
  70.  
  71.         PAKSORT v1.0
  72.  
  73.         Searching: BBSMOVE.PAK
  74.           Copying: BBSMOVE.EXE   - loc=4871    len=25442
  75.           Copying: BBSMOVE.DOC   - loc=0       len=4871
  76.  
  77.         Technical  note:  The  sort  process  is  performed  "safely"  by 
  78.         completely  producing  the  sorted archive file  under  the  name 
  79.         "PAKSRTMP.$$$"  on the same drive:path as the unsorted  original. 
  80.         The  original  is then deleted and the temporay file  renamed  to 
  81.         replace  the original. This means that the destination disk  must 
  82.         have  enough free space for a complete copy of the original,  and 
  83.         that the destination directory must have room for one new  entry. 
  84.         This  second point will not normally be a problem except  in  the 
  85.         case of a completely full root directory.
  86.  
  87.         The  purpose  of this program is to principally to allow  use  of 
  88.         PKPAK  with  Fido-Net  archived mail. Normally,  PKPAK  keeps  an 
  89.         archive sorted by member name, but many mail processing  programs 
  90.         presume  that the members are stored in the order added, as  with 
  91.         the  ARC.EXE  program. For systems which use the  ARCA  and  ARCE 
  92.         programs (like Opus-CBCS), "front-end" programs (PAKAS/PAKSE) are 
  93.         included which will "shell" to PKPAK/PKUNPAK and then "shell"  to 
  94.         PAKSORT to sort the result in chronological order ("D+T+F+".)
  95.  
  96.         The  reason  for  the unusual default of  ".PAK"  as  a  filetype 
  97.         extension is due to Mike Housky, who is trying to ignite a grass-
  98.         roots   standard  for  identifying  archives  produced   by   the 
  99.         techically  superior PKWARE Inc. utilites, and incompatible  with 
  100.         the ARC program distributed by SEA.
  101.  
  102.         PKPAK,  PKUNPAK  and PKPAKJR are trademarks of PKWARE,  Inc.  and 
  103.         Phil Katz.
  104.  
  105.         ARC  and SEA are trademarks of Software  Enhancement  Associates, 
  106.         Inc.
  107.  
  108.         Opus-CBCS  is  probably a trademark of Wynn Wagner III,  and  the 
  109.         reference herein is intended to be "Lawful and Friendly."
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.                                  PAKSORT v1.1                     page 2
  124.