home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
HATCH
/
WWSRT122.ZIP
/
WWIVSORT.DOC
< prev
next >
Wrap
Text File
|
1996-07-11
|
37KB
|
876 lines
═════════════════════════════════════════════════
C M I P R O D U C T R E G I S T R A T I O N S
═════════════════════════════════════════════════
This product is SHAREWARE. License is granted to use the program
without charge for an evaluation period of not more than 30 days.
After this time, users are required to register or cease their use of
the program. The registration fee for this program is $5 U.S. for
each installed copy. Mail your payment in a check or money order to:
Ken W. Harris
9948 Duffy St.
Temple City, CA 91780-2607
Note: DO NOT make your check or money order payable to CMI Software,
as this is only my trade name and I do not have a business checking
account under that name.
═════════════════════════════════════════════════
A registration form can be found on the next page. Please fill it out
completely and submit it with your payment. If possible, please
include your Internet e-mail address; this will allow your registered
copy to be sent as an e-mail file attachment. If you do not have
Internet mail access, other arrangements will need to be made to
receive your registered copy. Future versions of WWIVSort will use
WWIV.INI registration codes, so registered copies will not need to be
custom-compiled with registration codes imbedded in them.
Date: ___/___/___
Product being registered: ____________________________________________
Amount enclosed: $__________
Your name: ___________________________________________________________
[Enter name as you want it to appear in registration]
Address : ___________________________________________________________
___________________________________________________________
___________________________________________________________
BBS name : ___________________________________________________________
[Enter BBS name as it appears in INIT]
BBS phone: ___________________________________________________________
[Enter BBS phone as it appears in INIT]
Net Addr.: ___________________________________________________________
┌─────────────────────── ┌┬┐┌┬┬┐┌┐
│ U S E R S U R V E Y │├┤│├┤│││
└─────────────────────── └┴┘└┘└┘└┘
Have you used a previous version of this program? [Y] [N]
Will you consider using future versions? [Y] [N]
Does this program contain all the features you want? [Y] [N]
How would you rate this program on a scale of 1 to 10? __________
How would you rate the documentation on a scale of 1 to 10? __________
Comments/Suggestions: ________________________________________________
______________________________________________________________________
______________________________________________________________________
______________________________________________________________________
______________________________________________________________________
______________________________________________________________________
______________________________________________________________________
______________________________________________________________________
______________________________________________________________________
╔═══════════════════════════════════════════════════╗
║ WWIVSORT 1.22 - Transfer AutoSort For WWIV 4.xx ╟─┐
║ (C) 1993-1996 by Ken Harris / CMI ║ │
╚═╤═════════════════════════════════════════════════╝ │
└───────────────────────────────────────────────────┘
OVERVIEW:
WWIVSort is a general utility for sorting WWIV transfer section databases
[*.DIR files], updating filesizes within those databases, and generating
listings of files within the databases. In addition, it will automatically
detect unused and inactive records within a .DIR file and pack that file to
remove the inactive records if any exist.
WWIVSort fully supports batch operation by being completely automated from
the DOS command line and by returning various ERRORLEVEL codes to DOS upon
exit. This makes WWIVSort ideal for your board's daily maintenance or
external event.
New for v1.2: WWIVSort now checks and adjusts the 'Daten' fields in any
.DIR file being processed. The 'Daten' field is a numeric timestamp which
indicates the exact upload date/time of a file or, in the case of the
|MARKER| records, the date/time on which a .DIR file was last updated. If a
file's 'Daten' field appears to be older than its actual upload date, its
'Daten' field will be adjusted to approximate a correct date/time stamp.
New for v1.21: WWIVSort now opens data files in LOCK WRITE mode. This
allows multiple instances of the BBS to share READ access of those data
files. The BBS cannot write to those data files until WWIVSort has finished
processing; this time will usually be very brief and should not cause any
conflicts with the BBS.
IMPORTANT NOTICE:
Your *.DIR files must be in unmodified stock form and must contain a
record size equal to that of 4.22's .DIR files [144 bytes]. In addition,
your DIRS.DAT file must also be unmodified and have a record size of 141
bytes. WWIVSort will attempt to determine, as accurately as possible,
whether or not each particular file it tries to access appears to be
usable. If not, the file will not be processed. "Gold" mods which add
new fields to DIRS.DAT and/or to *.DIR are not supported by WWIVSort.
[ WWIVSort 1.22 User Manual - Page 1 ]
USING WWIVSORT:
To install WWIVSort, the program should be placed in any directory in which
it will be able to locate CHAIN.TXT. For instance, if you have a logon
event which copies CHAIN.TXT to another directory, WWIVSort can be run from
that directory. It is recommended, however, that WWIVSort be placed in
your main BBS directory.
Amendment for v1.2: WWIVSort now searches the DOS PATH= environment
variable if it cannot locate CHAIN.TXT in the current directory. Please
see the description of ErrorLevel 7 on page 8.
If WWIVSort is run without any command line options or switches, it will
default to: Sort all directories by name in forward order, update file-
sizes, no report [file list] created. If a command line which contains no
valid parameters is passed to WWIVSort, the program will display the help
screen.
Note that it is not absolutely necessary to include spaces between any
command line or environment variable options being sent to WWIVSort - the
program contains logic which can always find the options required as long
as they have been passed to the program.
Also, note that command line options may be given in -any- order. Case is
not significant; options may be given in upper or lower case, or both.
The following is a complete list of available WWIVSort command line options
and switches. Note that certain options cannot be mixed [it is not pos-
sible to specify more than one sort method unless a listfile is used].
Syntax: WWIVSORT [<options> <method> <order> <count>]
WWIVSORT /? - Help
WWIVSORT ? - "
WWIVSORT /HELP - "
If a question mark or the /HELP option are seen anywhere on WWIVSort's
command line, they will ALWAYS bring up the help screen. Both of these
will automatically override any other options or switches, as WWIVSort
checks for them before it searches for any other command line options.
Also, since the presence of a question mark on the command line always for-
ces the help screen, it is not possible to use it as a DOS wildcard char-
acter with /F= or in listfiles [no wildcards are accepted by WWIVSort under
any circumstances].
OPTIONS:
/F=datafile Name of specific directory data file [*.DIR] to sort;
defaults to ALL if omitted.
[ WWIVSort 1.22 User Manual - Page 2 ]
Note: DOS wildcard characters * and ? are NOT ACCEPTED by WWIVSort! If a
question mark is present, it will bring up the help screen. If an asterisk
is present, WWIVSort will stop parsing at that point. Example: You wish to
process three files named GAMESA2G.DIR, GAMESH2Q, and GAMESR2Z.DIR. It
would not be possible to specify them simultaneously as /F=GAMES* - WWIVSort
would read this as GAMES.DIR and attempt to process a file by that name. If
you wish to process a specific set of individual files, use the /F=@ option
as described below.
/F=@listfile 'Listfile' is the name of a text file which contains a list
of directory names [.DIR files] to be operated upon for sort,
size, and/or report operations. A list might look similar to
this:
SYSOP
WWIVMODS
GAMES
GRAPHICS
Each one of the above items will be assumed to be the name of
a .DIR file and will be processed accordingly. See the
section 'USING LIST FILES' below for further details.
Although WWIVSort will -accept- /F= and /F=@ on the command line simulta-
neously, it will always use only the first item it finds. For instance, if
the command line contains /F=sysop/F=@sort.lst, only the file SYSOP.DIR
will be processed, and the listfile 'sort.lst' will be completely ignored.
Keep in mind that this also goes for all other WWIVSort command line
options - the first occurrence of any particular option will be used to the
exclusion of any other occurrences of that option.
/NOSIZE Skips filesize updating. If this switch is NOT used, WWIV-
Sort will attempt to update the file sizes of all files which
are contained in the .DIR file database and are resident in
each particular transfer library's directory. This feature
is especially useful when file sizes are changed because of
the addition or removal of .ZIP banners, BBS advertisement
files, etc.
/NOSORT Skips sort; may be used to force only size updates and/or
reports.
/R= Creates a complete file listing of directories processed.
Follow the /R= switch with the filename of the output file for
your report [ex.: /R=files.txt]. The filename given will be
used to produce a listing of the files in each .DIR file being
processed. It is produced -after- all other operations
[sorting and filesize updating] are complete, so it will
always reflect each file's last known size and the exact order
in which files are contained in a given .DIR file.
Note - If /NOSIZE and /NOSORT are used -and- /R= is omitted,
WWIVSort will have nothing to do!
[ WWIVSort 1.22 User Manual - Page 3 ]
There is no default filename for report output. If the /R=
option is specified, it -must- be immediately followed by a
filename or device to be used for output. If nothing follows
/R=, the program will abort with an error.
/D Adjusts 'Daten' timestamps. Each entry in a .DIR file con-
tains a timestamp field called Daten. This field indicates
the time a particular file was uploaded or, in the case of the
very first ['marker'] record, the time on which the .DIR was
last updated. Daten is a UNIX-format timestamp which measures
time in seconds elapsed since midnight on 01/01/1970.
Occasionally, because of bugs or errors in certain programs,
the Daten field for a file or marker record may be incorrect.
The /D option will force WWIVSort to make adjustments to any
Daten field it judges to be incorrect. In the cases of indi-
vidual files, this will mean a Daten value which appears older
than the actual upload date [which is held in a text field in
uploadsrec]. In the marker record, this will mean a Daten
value which is older than the most recently-uploaded file.
If a file's Daten appears to be incorrect, WWIVSort will
approximate a new value based on the date contained in the
text 'upload date' field. This new value may not be precisely
correct as far as the upload time, but it will at least set
the Daten to midnight on the correct upload date.
Note that under normal circumstances it will not be necessary
to use /D; it should usually be specified only if the BBS's
new file scan does not appear to be functioning properly. It
may also be necessary to use /D after running certain programs
which may have a tendency to write incorrect Daten values.
WWIVSort uses a 99-year calendar for Daten approximation; it
ranges from 1986 to 2085.
SORT METHODS:
/M=D Sort by description.
/M=E Sort by extension.
/M=N Sort by name [this is the default mode].
/M=S Sort by size.
/M=T Sort by times downloaded.
/M=U Sort by upload date/time.
/M=W Sort by 'who uploaded.'
Note - only one sort method may be specified. If more than one method is
specified, the first one given will be the method which is used - all else
will be ignored.
If no method or an invalid method is specified, WWIVSort will automatically
default to sorting by filename [method N].
[ WWIVSort 1.22 User Manual - Page 4 ]
ORDER:
/B Sort in reverse. Defaults to forward sort if omitted. There
is no switch to force a forward sort; simply omit the /B
switch to sort forward. For instance, to place newer files at
the top of the .DIR listing and older files at the bottom,
specify /M=U/B. To place newer files at the bottom of the
listing, use /M=U.
When performing a sort, WWIVSort will display the current method(s) being
used for each file. For example, if the message "Sorting SR..." appears,
this indicates the current directory is being reverse-sorted by size [as in
"Sorting Size Reverse"]. Abbreviations are used to prevent WWIVSort's
progress messages from using more than one line of text on the screen.
Before sorting any directory, WWIVSort performs an initial scan to deter-
mine whether or not that directory actually needs sorting according to the
current method. During this very brief scan, WWIVSort will display the
message "Scanning..." Afterward, you might see the message "Sorted
<method>." This indicates that no sort was either performed or necessary
because that directory was already sorted according to the specified
method.
The side-effect to this initial scan is that, when a sort -is- required,
there is a very brief amount of overhead time added to the sort process.
However, this preliminary scan can, under certain conditions, serve to
speed overall program execution time, since WWIVSort will not perform a
sort if it isn't necessary.
COUNT:
WWIVSort 1.2 now writes the total bytes used, both in individual direc-
tories and in total among all directories processed, when writing reports.
By default, the sizes of offline files are not included in this count, but
their sizes -are- listed in reports. The following switches may be used to
turn these defaults off:
/O When this switch is used, WWIVSort will replace the sizes of
offline files with ----- when writing reports. This makes it
easier to spot offline or missing files. The /O switch is
global and cannot be used in listfiles.
/C This switch will force WWIVSort to include the sizes of off-
line files in its count of bytes used. If it is omitted,
WWIVSort will count only the sizes of files which exist in
the directory. The /C switch is global and cannot be used in
listfiles.
[ WWIVSort 1.22 User Manual - Page 5 ]
/O and /C will be completely ignored if the /R= option is not active [no
report is being written]. They are not included in the initial check for
valid options when WWIVSort is run; if no other valid options are present
on the command line [/O or /C are used with no other options or
switches], WWIVSort will display the help screen.
USING LIST FILES:
As stated above, it is possible to create a list of directory names on
which WWIVSort will operate. Starting with version 1.1, it is now also
possible to specify sort method, order, /NOSORT, and /NOSIZE as command
line options within the list file. This means the options /M=, /B, /NO-
SORT, and /NOSIZE may now be appended to the filenames in list files. Here
is an example of such an entry in a list file:
SYSOP /M=D/B/NOSIZE
Each item in a list file which contains extra parameters will be processed
as follows: The /M= and /B options OVERRIDE any options given on the
command line. /NOSORT and /NOSIZE are COMBINED with the command line! If
the command line specifies /NOSIZE and the list file also specifies /NO-
SORT, neither sorting nor size updating will be performed for that partic-
ular directory. Note that if both /NOSORT and /NOSIZE are active but no
report is being generated [/R= option was not used], then WWIVSort will
have nothing to do for that directory.
The /R= option, if used in a list file, will be completely ignored. It is
not possible to write to a report other than the report which has been
specified on the command line.
WRITING REPORTS:
When the /R= option is used, WWIVSort will create a text file listing the
contents of each directory it processes. Each individual directory listed
in the report will contain a header which looks similar to this:
══════════════════════════════════════════════════════════════════════════════
CMI Products [Programs By Crossfire] Files: 4 Bytes: 168664
──────────────────────────────────────────────────────────────────────────────
[Filename] [Size] [Date] [DL] [Description]
──────────────────────────────────────────────────────────────────────────────
The top line of this header contains the name of the directory being lis-
ted, the number of files it contains in its database, and the number of
bytes used by the files listed. This byte count will -not- include offline
files if the /C switch was not used.
This header will then be followed by the filenames themselves:
[ WWIVSort 1.22 User Manual - Page 6 ]
FSORT10 .ZIP 36164 06/20/93 0 Sorts BBSLIST.MSG in GFiles directory.
TAGMV21 .ZIP 69373 06/20/93 0 TagMaster 2.1 - Random tagline generator.
UREC422 .ZIP 6338 06/20/93 2 QB Declarations for WWIV 4.22 userrec.
WWSORT12.ZIP 56789 04/05/94 3 WWIVSort 1.2 - Transfer section auto-sort
══════════════════════════════════════════════════════════════════════════════
At the end of the report will be a footer which shows the total number of
files listed and the total number of bytes they occupy:
Total files listed: 506
Total bytes listed: 10633702
Remember that the /O switch will replace the sizes of offline files with a
series of five dashes. For example:
UREC422 .ZIP ----- 06/20/93 2 QB Declarations for WWIV 4.22 userrec.
Also, keep in mind that the /C switch will force WWIVSort to count the sizes
of -all- files when it calculates the byte totals. If /C is not used, WWIV-
Sort will count only the sizes of those files which happen to be online,
regardless of whether or not they are shown as such in the report.
EXAMPLES:
WWIVSORT /F=GAMES /NOSIZE /M=T /B
Sorts GAMES.DIR by times downloaded, in reverse order [most-frequently
downloaded files first], does not check and update sizes of files.
WWIVSORT /NOSORT /R=\BBS\FILES.TXT
Acts on all *.DIR files, does not sort, updates file sizes, and creates
a file listing in \BBS\FILES.TXT.
Note - If the /NOSORT switch is used, any options regarding sort method
or order will be ignored.
WWIVSORT /M=D /F=@SORT.LST
Sorts by description, operating only on the files given in SORT.LST.
SETTING WWIVSORT DEFAULTS:
It is possible to use an environment variable to set a default mode of
operation for WWIVSort. This environment variable, WWIVSORT=, follows
precisely the same syntax as the normal command line options. For in-
stance, if you would like WWIVSORT to default to sorting only SYSOP.DIR by
filename, not updating the sizes, and creating a report called FILES.TXT,
you would issue this command at your DOS prompt:
[ WWIVSort 1.22 User Manual - Page 7 ]
SET WWIVSORT=/F=SYSOP/M=N/NOSIZE/R=FILES.TXT
If the WWIVSort environment variable exists and WWIVSort is run without any
command line options, WWIVSort will use the contents of the environment
variable exactly as if they had been passed to the program as command line
options.
APPENDIX A - WWIVSORT MESSAGES AND ERRORLEVEL CODES:
Version 1.2 now returns ERRORLEVEL values to DOS for extended flexibility
during batch use. Most of these conditions will also display a visual
error message, usually containing such data as the names of files which
could not be processed, etc.
In the chart below, "Message:" indicates the message which will be displayed
by WWIVSort. "<dirname>" means the name of a particular .DIR file. For
instance, if the file in question is SYSOP.DIR, <dirname> will be SYSOP.DIR.
"<datapath>" is the name of your BBS DATA directory. ErrorLevel is the
value which will be returned to DOS under each specific condition. [If no
error condition exists, WWIVSort will return 0.]
Message:
WWIVSORT: Nothing to do!!!
Meaning:
WWIVSort was passed a set of options which it cannot process. For in-
stance, if /NOSORT and /NOSIZE are specified but /R= is not, WWIVSort
can't proceed because it is not sorting, not performing size updates,
and not writing a report.
ErrorLevel: 1
Message:
ERROR: Unable to open report file for output! Exiting...
Meaning:
The filename given after the /R= option is, for some reason, invalid.
This may be the result of an invalid path specification or invalid
characters within the name itself.
ErrorLevel: 2
Message:
ERROR: /R= option used, but no output file specified! Exiting...
Meaning:
Self-explanatory. /R= was not followed by a filename under which
WWIVSort should write its report [file listing]. There is no default
filename; if none is specified, WWIVSort will be unable to proceed and
will abort.
ErrorLevel: 3
[ WWIVSort 1.22 User Manual - Page 8 ]
Message:
ERROR: /F= option used, but no filename specified! Exiting...
Meaning:
Also self-explanatory. /F= was not followed by the name of an indi-
vidual .DIR file to be processed.
ErrorLevel: 4
Message:
ERROR: /F=@ option used, but no list file specified! Exiting...
Meaning:
Also self-explanatory. Lacking a listfile name on which to operate,
WWIVSort will be unable to continue. WWIVSort will abort under this
condition.
ErrorLevel: 5
Message:
ERROR: Unable to open list file '<listname>'! Exiting...
Meaning:
/F=@ was followed by the name of a non-existent file or one which WWIV-
Sort is unable to locate. WWIVSort will not be able to process that
listfile and will abort.
ErrorLevel: 6
Message:
ERROR: Unable to find and/or open CHAIN.TXT! Exiting...
Meaning:
WWIVSort was not able to locate CHAIN.TXT, either in the current direc-
tory or along your DOS PATH. Without CHAIN.TXT, WWIVSort will not be
able to locate the path to your BBS DATA directory, which it needs in
order to locate DIRS.DAT.
ErrorLevel: 7
Message:
ERROR: Unable to find and/or open <datapath>\DIRS.DAT! Exiting...
Meaning:
This error should be very rare, if it ever occurs at all. It indicates
that CHAIN.TXT has been properly read but that WWIVSort still cannot
locate DIRS.DAT in your DATA directory. This may be the result of
DIRS.DAT having been moved, renamed, or deleted.
ErrorLevel: 8
Message:
ERROR: DIRS.DAT structure has been modified or is incompatible!
Unable to proceed. Exiting...
Meaning:
WWIVSort has located DIRS.DAT and attempted to read it; however, there
is for some reason an incompatibility in the structure of DIRS.DAT.
DIRS.DAT must always be in unmodified stock form in order for WWIVSort
to be able to process it. ["Gold" mods which add fields to DIRS.DAT
and/or to *.DIR are not supported by WWIVSort.] If DIRS.DAT can't be
processed, WWIVSort will abort.
ErrorLevel: 9
[ WWIVSort 1.22 User Manual - Page 9 ]
Message:
ERROR: Unable to correctly read <datapath>\DIRS.DAT! Exiting...
Meaning:
This error should also be extremely rare. It indicates that DIRS.DAT
has been succesfully located and appears to be unmodified, but for some
reason WWIVSort -still- can't read it properly.
ErrorLevel: 9
Message:
ERROR: Unable to find <dirname> in DIRS.DAT!
Meaning:
Before processing any given .DIR file, WWIVSort will scan DIRS.DAT to
see if it contains the name of the .DIR file; if <dirname> is not found
in DIRS.DAT, WWIVSort assumes <dirname> is not a valid part of the
board's transfer section, and <dirname> will not be processed.
ErrorLevel:
1] 10 if a single file [/F=] is being processed [WWIVSort exits under this
condition].
2] None if /F=@ is active.
3] DOES NOT APPLY if neither /F= or /F=@ are active.
Message:
ERROR: Unable to open '<dirname>'!
Meaning:
WWIVSort is unable to locate and/or open a particular .DIR file. This
may be the result of a .DIR file name existing in DIRS.DAT but not in
the BBS DATA directory itself. This error may occur regardless of
whether a single file/listfile has been specified or not.
ErrorLevel:
1] 11 if a single file [/F=] is being processed [WWIVSort exits under this
condition].
2] None if neither /F= or /F=@ are active.
Message:
<dirname>: Nothing to do!!!
Meaning:
WWIVSort is unable to perform any processing on <dirname>. This will
occur when /NOSORT and /NOSIZE are active at the same time while using
a listfile and no report is being written. It can only occur when /F=@
is active. Be sure not to mix /NOSORT and /NOSIZE if you are not
writing a report with the /R= option.
ErrorLevel: None.
Message:
ERROR: Could not read <dirname>!
Meaning:
<dirname> may have been modified. For whatever reason, WWIVSort is
unable to correctly read and process <dirname>.
ErrorLevel:
1] 12 if a single file [/F=] is being processed [WWIVSort exits under this
condition].
2] None if neither /F= or /F=@ are active.
[ WWIVSort 1.22 User Manual - Page 10 ]
Message:
ERROR: No files in database <dirname>!
Meaning:
<dirname> was located and opened, but does not contain any files in its
database.
ErrorLevel:
1] 13 if a single file [/F=] is being processed [WWIVSort exits under this
condition].
2] None if neither /F= or /F=@ are active.
Message:
^C encountered... Aborting.
Meaning:
CTRL+C was pressed during WWIVSort's run; this aborts the program and
closes all open files being used by WWISort.
ErrorLevel: 14
Message:
Unrecoverable error ## encountered. Exiting...
Meaning:
WWIVSort has encountered an internal error relating to QuickBASIC
itself. In this case, ## will indicate the internal code of the error.
ErrorLevel: 99
Message:
Packing <dirname>...
Meaning:
WWIVSort has detected unused 'junk' records in a particular .DIR file
and is removing them to conserve space.
ErrorLevel: None
Message:
Reading <dirname>...
Meaning:
WWIVSort is in the process of loading a .DIR file's data into memory for
processing.
ErrorLevel: None
Messsage:
Scanning...
Meaning:
WWIVSort is performing an initial scan on a .DIR file's data to deter-
mine whether the data needs to be sorted under the given method. This
may add a bit of overhead to the processing time, but can frequently
save time by preventing sorts which are not necessary.
ErrorLevel: None
Message:
Updating sizes...
Meaning:
WWIVSort is checking the sizes of available files and updating their
records in the current .DIR file. This can be skipped by using /NOSORT.
ErrorLevel: None
[ WWIVSort 1.22 User Manual - Page 11 ]
Message:
Sorting <method>...
Meaning:
WWIVSort is performing a sort of the current .DIR file according to
<method>.
ErrorLevel: None
Message:
Sorted <method>...
Meaning:
WWIVSort has determined that the current .DIR file is already sorted
according to the chosen method; thus, the sort process has been skipped
for that .DIR.
ErrorLevel: None
Message:
Writing report...
Meaning:
WWIVSort is in the process of writing a text listing of all files in the
current .DIR.
ErrorLevel: None
APPENDIX B - CONTACTING THE AUTHOR:
The author may be reached by e-mail at any of the following:
USLink 1@1
IceNET 1@8854
WWIVnet 1@3800
TerraNET 1@8854
WWIVLink 1@18867
Or you may dial ModeMANIA BBS [Temple City, CA] directly at:
818-451-0936 [Up to 14400 8N1]
APPENDIX C - REVISION HISTORY:
07/1996: Version 1.22 released. NOTE: This version was released mainly to
fix a corruption of the .EXE in certain copies of the WWSRT121.ZIP
archive. Very minor patches to existing v1.21 code - multi-
instance file locking/unlocking should now be more reliable, and
file listings now show the descriptions instead of the uploaders'
names. Version 2.00 is expected to be a near-total rewrite and
will probably use a GUI screen instead of the plain-text display.
It will use WWIV.INI registration codes and option settings.
There is no projected release date for v2.00 at this time.
[ WWIVSort 1.22 User Manual - Page 12 ]
12/1994: Version 1.21 released. Completely new sort routine results in a
significant speed increase. New file-open routine which should
make WWIVSort compatible with multi-instance operation. Minor
adjustments to report generation routine. Elapsed time shown.
04/1994: Version 1.2 completed and released. WWIVSort now returns an
ERRORLEVEL to DOS on exit. Added ^C checking to abort program at
various points. Report feature now includes counts of total bytes
used, both for individual directories and all listed directories
in total. Added /O switch to replace offline files' sizes with
----- when writing reports. Added /C switch to include sizes of
offline files in byte counts. Minor tweaks for speed and to
conserve internal string space. Added search of DOS PATH when
trying to locate CHAIN.TXT. Added code to check and correct
'Daten' fields in .DIR files. Thanks again to JAFO, The Bishop,
and Thunderbolt for their comments, suggestions, and support.
06/1993: Version 1.1 completed and released. Bug fix to correct unwanted
use of junk records in .DIR files, which could lead to corrupted
data. Program now automatically packs .DIR files when necessary.
Added features for the use of optional switches in list files.
Progress display now shows method when sorting. Minor enhance-
ments to speed and structure. Minor corrections to documentation.
Added data pre-scan prior to sort to determine if a sort is
necessary. Thanks to JAFO for his suggestion to include sort
method options within list files.
06/1993: Version 1.0 completed and released.
APPENDIX D - TRADEMARKS / ADDITIONAL:
Software vendors may distribute this program provided it is kept in its
complete and unmodified original form, including all accompanying
documentation, and provided that persons receiving the program are made
aware that any fees charged for receipt of the program by any agent
other than the author DO NOT constitute purchase or registration of the
program. These restrictions also apply to bulletin board operators and
to users of the program. Commercial vendors are requested to contact
the author at the address above prior to distributing this program in
any medium. Vendors may request fees for the medium carrying the
program and/or for shipping and handling of the medium, NOT for the
program itself. All applicable domestic and international rights
remain the exclusive property of the author.
CMI [California Microdata International] is an unregistered trade name of
the author and is not affiliated with, or a representative of, any other
group or organization bearing the initials CMI.
WWIV is a trademark of Wayne Bell / WWIV Software Services.
QBasic, QuickBASIC, and PDS [Professional Development System] are trademarks
of Microsoft Inc.
[ WWIVSort 1.22 User Manual - Page 13 ]