SORTDESC V1.0 Find file descriptions from
either FILE_ID.DIZ or captured file listing(s)
& move file to a different directory based on
key words in that description, place
description a separate listing. With options
to add a "FILE_NFO.DIZ" to archives that don't
have them, remove graphic characters, match
on names with different extensions, & more!
** SHAREWARE $15 for non-commercial users **

SORTDESC
SHAREWARE (C) 1993 Vince Sorensen
All Rights Reserved


Registration - Individual Users $15.00
Commercial Users $CALL


Send to:
Vince Sorensen
6 Armstrong Bay
Regina, Sask. Canada
S4N 4G7

BBS 306-789-8682 or 306-789-8690
Voice 306-789-4654



SORTDESC: Who wants it?

For BBS operators, CD-ROM publishers, or anyone who wants to have
their files sorted automatically into directories using information in
those files descriptions. The source of file descriptions can be
either the industry standard FILE_ID.DIZ within an archive, a text
file with many file descriptions (for example, a captured on-line
or BBS session), or a README file within an archive.
Options include adding a copy of the description into the archive
if it doesn't already contain a FILE_ID.DIZ, adding a standard text
file to each archive, search for descriptions with or without having
to match the extension (I.E. you downloaded a ZIP file and converted
it to ARJ... the captured BBS listing still says ZIP), remove extended
characters or other phrases from the description (I.E. no more
's in the description).



What does this program do?

Checks a directory for files. For all files found, it checks
to see if they contain a FILE_ID.DIZ. If so, it adds the description
to a text file, in PCBoard format. If not, it checks a text file
(or text files) that contain PCBoard format descriptions (which
may have been captured from a download session, or are from a
CD-ROM/BBS file listing). If a description is found there, it
is added to the description text file, with an updated size field.
If not, a description of "No Description Found" is added to the
description text file, again in PCBoard format. All additions to
the description text file are dated with tomorrow's date.
Optionally, you can add the description that was found, plus
a small message to the archive.


Requirements:
If handling .ARJ files, you need ARJ.EXE. If handling .ZIP files,
you need PKUNZIP.EXE. If handling .LZH programs, you need LHA.EXE.

Command line options:

SORTDESC /S - run program interactively (see below) or set-up
the "re-direction" keywords.
SORTDESC - run program in batch mode; SORTDESC.INI
contains the options


SORTDESC.INI should contain the following lines:

(any that are indicated as OPTIONAL are not necessary... the program will
work as if they were in the INI file and set to their defaults).


D=Directory Directory to Search

I=Import_File File to search for descriptions for files without FILE_ID.DIZ

E=Export_File File to place found descriptions in (unless redirected)

S=Smart_On_Off SMART REDIRECTION (ON or OFF)
Whether or not to redirect the files and descriptions according
to keywords found in the descriptions

R=ON RECHECK (ON or OFF)
Whether or not to try to find descriptions for files that
already exist in the listing being exported to (default
export file only)

DIZ=NO Yes or no; Create FILE_ID.DIZ from description found in
text file, and add to archive? (Also see SPEC below)

MSG=Add_Msg.txt A text file to add to the archive (OPTIONAL)

DATE=REAL Use actual file date rather than tomorrow's date.
Default is CALC, not REAL. (OPTIONAL)

SPEC=Add_line A line to add to the newly created FILE_ID.DIZ (gets added
as FILE_NFO.DIZ instead) (does not apply to files that
already contain a FILE_ID.DIZ) (OPTIONAL)

SKIPEXT=NO Yes or no; when searching for descriptions, ignore if the
extensions don't match (In other words, if this is set to
Yes, the program being looked for is EGG.ZIP and the
description found is for EGG.ARJ, the description WILL be
used). Default is NO. (OPTIONAL)

LIMIT=### The maximum lines to use for any file's description.
Any number ranging from 1 TO 255; use LIMIT=0 or leave this
line out entirely for no maximum limit on the number of lines.

README=NO Yes or no; If SORTDESC can't find either a FILE_ID.DIZ or
a description in the specified text file(s), and you include
the line README=YES, SORTDESC will try to find any file
in the archive called README., READ.ME, README.1ST, or
FILENAME.DOC (where Filename is the name of the archive
being examined, without an extension). If any of these are
found, SORTDESC will try to extract a description. If you
use this option, it is HIGHLY recommended that you set a
LIMIT. Default is NO (OPTIONAL)

FILTER=ON On or Off; Remove certain graphic characters and character
combinations that contain no useful information.
Default is ON (OPTIONAL)

GONE=~STRING1~STRING2~STRING3~ETC~
Specify extra character combinations that will be removed
during filtering (if filtering not turned OFF). Separate
each string with the ~ symbol; up to 80 characters total
are allowed. Example: GONE=~GREAT~I LIKED IT~(NEW)~ will
remove any occurance of the word "Great", the phrase
"I Liked it", and the word "(NEW)".



For example, your SORTDESC.INI may look like this:

D=c:\pcb\upload
I=c:\text\capture.cap
E=c:\pcb\main\private.
S=ON
R=OFF
DIZ=NO
LIMIT=20




Interactive Version: Keyboard Navigation


ESC - Previous field or screen; cancel entry
ENTER - Accept and move to next field or as otherwise indicated
on-screen; On menu screens, execute highlighted function.
F5 - Bring up table to lookup information (where applicable)
ARROW DOWN - Highlight next entry
ARROW UP - Highlight previous entry