home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SORTDESC.ZIP / SORTDESC.DOC < prev    next >
Encoding:
Text File  |  1993-05-18  |  6.9 KB  |  156 lines
  1.                                     SORTDESC
  2.                         SHAREWARE (C) 1993 Vince Sorensen
  3.                                All Rights Reserved
  4.  
  5.  
  6.                      Registration - Individual Users $15.00
  7.                                     Commercial Users $CALL
  8.  
  9.  
  10.                                     Send to:
  11.                                  Vince Sorensen
  12.                                  6 Armstrong Bay
  13.                               Regina, Sask. Canada
  14.                                      S4N 4G7
  15.  
  16.                         BBS 306-789-8682 or 306-789-8690
  17.                                Voice 306-789-4654
  18.  
  19.  
  20.  
  21. SORTDESC: Who wants it?
  22.  
  23.    For BBS operators, CD-ROM publishers, or anyone who wants to have
  24. their files sorted automatically into directories using information in
  25. those files descriptions. The source of file descriptions can be
  26. either the industry standard FILE_ID.DIZ within an archive, a text
  27. file with many file descriptions (for example, a captured on-line
  28. or BBS session), or a README file within an archive.
  29.    Options include adding a copy of the description into the archive
  30. if it doesn't already contain a FILE_ID.DIZ, adding a standard text
  31. file to each archive, search for descriptions with or without having
  32. to match the extension (I.E. you downloaded a ZIP file and converted
  33. it to ARJ... the captured BBS listing still says ZIP), remove extended
  34. characters or other phrases from the description (I.E. no more
  35. ░'s in the description).
  36.  
  37.  
  38.  
  39. What does this program do?
  40.  
  41.    Checks a directory for files. For all files found, it checks
  42. to see if they contain a FILE_ID.DIZ. If so, it adds the description
  43. to a text file, in PCBoard format. If not, it checks a text file
  44. (or text files) that contain PCBoard format descriptions (which
  45. may have been captured from a download session, or are from a
  46. CD-ROM/BBS file listing). If a description is found there, it
  47. is added to the description text file, with an updated size field.
  48. If not, a description of "No Description Found" is added to the
  49. description text file, again in PCBoard format. All additions to
  50. the description text file are dated with tomorrow's date.
  51.    Optionally, you can add the description that was found, plus
  52. a small message to the archive.
  53.  
  54.  
  55. Requirements:
  56.    If handling .ARJ files, you need ARJ.EXE. If handling .ZIP files,
  57. you need PKUNZIP.EXE. If handling .LZH programs, you need LHA.EXE.
  58.  
  59. Command line options:
  60.  
  61. SORTDESC /S         - run program interactively (see below) or set-up
  62.                       the "re-direction" keywords.
  63. SORTDESC            - run program in batch mode; SORTDESC.INI
  64.                       contains the options
  65.  
  66. ┌─────────────────────────────────────────────────────────────────────────────┐
  67. │               SORTDESC.INI should contain the following lines:              │
  68. └─────────────────────────────────────────────────────────────────────────────┘
  69.     (any that are indicated as OPTIONAL are not necessary... the program will
  70.         work as if they were in the INI file and set to their defaults).
  71.  
  72.  
  73. D=Directory      Directory to Search
  74.  
  75. I=Import_File    File to search for descriptions for files without FILE_ID.DIZ
  76.  
  77. E=Export_File    File to place found descriptions in (unless redirected)
  78.  
  79. S=Smart_On_Off   SMART REDIRECTION (ON or OFF)
  80.                  Whether or not to redirect the files and descriptions according
  81.                  to keywords found in the descriptions
  82.  
  83. R=ON             RECHECK (ON or OFF)
  84.                  Whether or not to try to find descriptions for files that
  85.                  already exist in the listing being exported to (default
  86.                  export file only)
  87.  
  88. DIZ=NO           Yes or no; Create FILE_ID.DIZ from description found in
  89.                  text file, and add to archive? (Also see SPEC below)
  90.  
  91. MSG=Add_Msg.txt  A text file to add to the archive        (OPTIONAL)
  92.  
  93. DATE=REAL        Use actual file date rather than tomorrow's date.
  94.                  Default is CALC, not REAL.                 (OPTIONAL)
  95.  
  96. SPEC=Add_line    A line to add to the newly created FILE_ID.DIZ (gets added
  97.                  as FILE_NFO.DIZ instead) (does not apply to files that
  98.                  already contain a FILE_ID.DIZ)           (OPTIONAL)
  99.  
  100. SKIPEXT=NO       Yes or no; when searching for descriptions, ignore if the
  101.                  extensions don't match (In other words, if this is set to
  102.                  Yes, the program being looked for is EGG.ZIP and the
  103.                  description found is for EGG.ARJ, the description WILL be
  104.                  used).  Default is NO.                   (OPTIONAL)
  105.  
  106. LIMIT=###        The maximum lines to use for any file's description.
  107.                  Any number ranging from 1 TO 255; use LIMIT=0 or leave this
  108.                  line out entirely for no maximum limit on the number of lines.
  109.  
  110. README=NO        Yes or no; If SORTDESC can't find either a FILE_ID.DIZ or
  111.                  a description in the specified text file(s), and you include
  112.                  the line README=YES, SORTDESC will try to find any file
  113.                  in the archive called README., READ.ME, README.1ST, or
  114.                  FILENAME.DOC (where Filename is the name of the archive
  115.                  being examined, without an extension). If any of these are
  116.                  found, SORTDESC will try to extract a description. If you
  117.                  use this option, it is HIGHLY recommended that you set a
  118.                  LIMIT. Default is NO                       (OPTIONAL)
  119.  
  120. FILTER=ON        On or Off; Remove certain graphic characters and character
  121.                  combinations that contain no useful information.
  122.                  Default is ON                              (OPTIONAL)
  123.  
  124. GONE=~STRING1~STRING2~STRING3~ETC~
  125.                  Specify extra character combinations that will be removed
  126.                  during filtering (if filtering not turned OFF). Separate
  127.                  each string with the ~ symbol; up to 80 characters total
  128.                  are allowed. Example: GONE=~GREAT~I LIKED IT~(NEW)~ will
  129.                  remove any occurance of the word "Great", the phrase
  130.                  "I Liked it", and the word "(NEW)".
  131.  
  132.  
  133.  
  134. For example, your SORTDESC.INI may look like this:
  135.  
  136. D=c:\pcb\upload
  137. I=c:\text\capture.cap
  138. E=c:\pcb\main\private.
  139. S=ON
  140. R=OFF
  141. DIZ=NO
  142. LIMIT=20
  143.  
  144.  
  145.  
  146. ┌─────────────────────────────────────────────────────────────────────────────┐
  147. │                   Interactive Version: Keyboard Navigation                  │
  148. └─────────────────────────────────────────────────────────────────────────────┘
  149.  
  150.    ESC         - Previous field or screen; cancel entry
  151.    ENTER       - Accept and move to next field or as otherwise indicated
  152.                  on-screen; On menu screens, execute highlighted function.
  153.    F5          - Bring up table to lookup information (where applicable)
  154.    ARROW DOWN  - Highlight next entry
  155.    ARROW UP    - Highlight previous entry
  156.