home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
CLNDIZ20.ZIP
/
CLEANDIZ.DOC
< prev
next >
Wrap
Text File
|
1994-11-26
|
56KB
|
1,519 lines
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
CLEANDIZ The Ultimate Trash Removal System!
For FILE_ID.DIZ Description Files!
By Larry Paul
Co-SysOp, The Howling BBS!
(810) 640-1584
USR Courier Terbo, v32bis v42bis
1200 to 21,600 bps
7 days, 24 hours
Running Wildcat 3.91!
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 1
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
ALL RIGHTS RESERVED. No part of this manual shall be reproduced,
stored in a retrieval system, or transmitted by any means, electronic
mechanical, photocopying, recording, or otherwise, without written
permission from Lawrence Paul. While every precaution has been taken
in the preparation of this manual, Lawrence Paul assumes no
responsibility for errors or omissions. Neither is any liability
assumed for damages resulting from the use of the information
contained herein, or for the use of the software in which this manual
was intended.
CleanDiz is the sole and exclusive property of Lawrence Paul.
CleanDiz is being released as donation warz, Meaning, If you use
this program and like it, then a donation of $ 5.00 is required for
it's continued use. An evaluation period of 30 day's should be
enough time for you to determine if you like the program or not.
After 30 day's you MUST remove this program and it's support files
from your system if you don't plan on making a donation for the effort
put into CleanDiz.
I know, the above statement sound's more like shareware. Well,
CleanDiz unlike "shareware" programs IS fully functional with no
limitations in the program what so ever, and shareware is sold. With
CleanDiz, your donations will only encourage me to update the program
and fix any bugs that may exist in a released copy. If no donations
are made to keep me encouraged enough to keep updating the program
then, It will no longer be released to the general public.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 2
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
TABLE OF CONTENTS
INTRODUCTION...........................................4
PROGRAM REQUIREMENTS...................................6
THINGS TO COME.........................................7
KNOWN PROBLEMS, DRAWBACKS & FIXES.....................8
DOLOG OPTION...........................................9
DELETE LIST FILE......................................10
COMMAND LINE OPTIONS..................................11
ENVIRONMENT VARIABLES.................................12
COMMUNICATIONS........................................14
SCANFILE.BAT and FILEDESC.BAT.........................15
SUPPORTED ARCHIVERS...................................16
MERGE FUNCTION........................................17
TECH SUPPORT INFORMATION..............................18
WHAT'S NEW............................................19
QUESTIONS & ANSWERS...................................21
DONATION INFORMATION..................................23
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 3
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
INTRODUCTION
CleanDiz was created because theres to many people these days wanting
to add crap like,
__ /\ \ /\ \ __ /\ \
/\ \ //\\_\ / \\ \/\ \ __ / \\_\
//\\ \/ / // / \\_\\\ \/\ \/ // /
\ \\/ // / \ \ // / \\/ \\// / /
\ / / /_ _\ \/_/\ \/ / /
\ // / V \\ \ \ \ / / /
\\////\\ ! / \\_\ \\//\\// /Tu
<===\/_/==\_______/_/==\/_/\/_/==>
P r o u d l y P r e s e n t s :
to FILE_ID.DIZ files. I guess it's supposta be artwork but in my opinion
it looks like SHIT! Looks even worse when it gets imported into your file
database, not to mention what it does to your keyword searches! Nothing
but TRASH! A short message to the creators of this kinda stuff "GET A
LIFE!" and "NO IT DON'T EVEN LOOK GOOD ON PcBoard!" I have no problems
with giving credit when credit is due, But if you want to make DIZ files
like above or put the credits before the actual description. May as well
remove the credit also!
What CleanDiz does is removes unwanted ASCII characters and phrases
from the FILE_ID.DIZ file prior to uploading to a bulletin board service,
or can be used by bulletin board services as an upload pre-processor.
When used as a upload pre-processor by bulletin board services, the
description file (FILE_ID.DIZ) will be checked for high ASCII characters or
unneeded ASCII characters and phrases, remove these characters then
re-insert the description file back into the uploaded file before the trash
can be imported into your databases.
Some of the high ASCII characters used by some of these groups
(immature kids) can be rather damaging to the operation of a BBS, They may
either clear the screen, send printer control characters, send
control/line feeds to the local & remote screen, Just to name a few of
several combinations of damaging high ASCII codes.
So the object of CleanDiz is to remove this stuff before it gets a
chance to do any damage, Not to mention, Make your BBS look much neater
and well organized! Give CleanDiz a run, You'll defiantly be pleased!
continued on next page.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 4
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
INTRODUCTION CONTINUED
CleanDiz extracts the FILE_ID.DIZ file from the archive, scans it for
unwanted characters, removes these characters then scans what's left for
unwanted phrases then re-archives it back into the original archive.
CleanDiz uses an expandable delete list file ("CLEANDIZ.LST") to remove
unwanted phrases, once a phrase is added to the delete list that phrase
will be removed from all FILE_ID.DIZ files processed by CleanDiz in the
future, As these kids expand there vocabulary, you expand your delete
list to remove the new words they learned <grin> (seems they don't learn
anything clean these days!)
CAUTION, There will be some characters that will never be removable
for one reason or another, for instance the example on page 4 (above)
has 2 characters "Tu" Well for obvious reasons, this cant be added to the
CLEANDIZ.LST! Ok, for those of you that don't understand why, Say the
actual description of the file starts with "Tu", Get the picture?
Yes, it WILL be removed even if it is supposed to be in there!
So use the CLEANDIZ.LST with caution and common sense!
CLEANDIZ.LST is a pure ASCII text file and can be edited with any text
editor (DOS's EDIT.EXE, Qedit etc.) or the DOLOG option of CleanDiz can
be used to add unwanted phrases/lines. See the DELETE LIST section for
more information on the proper format of CLEANDIZ.LST, See the DOLOG
section for more information on the DOLOG option.
CleanDiz also creates a log ("CLEANDIZ.LOG") located in the directory
that contains CLEANDIZ.EXE and records all lines from FILE_ID.DIZ files
processed by CleanDiz, The log file will help you in tracking down new
lines/phrases as they are created. For more information on the log file,
see the DOLOG section of this manual.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 5
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
PROGRAM REQUIREMENTS
DOS 3.3 or higher
286 or better CPU 486 or above recommended for best performance.
228k of free RAM 114k Available to CleanDiz + 114k for PAK V2.51!
PAK has the highest memory requirements of all the
supported archivers, CleanDiz will require less
memory when other archive types are processed.
For example, if working on a DWC archive the RAM
requirements would be, 114k for CleanDiz + 51k
for DWC.EXE for a total of 165k available RAM
needed.
Supported Archivers Must be accessible from your path, See the
section on supported archivers for a list of
archivers.
Note, you don't have to have all of the supported
archivers (even though recommended) in order for
CleanDiz to work. If the needed archiver cannot
be located, CleanDiz will gracefully exit.
SORT.EXE MS-DOS's sort must be accessible from your path
for the DOLOG and MERGE options to function
properly. See your DOS manual for more
information on SORT.EXE.
CLEANDIZ.EXE and Must be accessible from your path, CLEANDIZ.LST
CLEANDIZ.LST must be located in the same directory as
CLEANDIZ.EXE
CleanDiz also requires that a few environment variables be set in
order for the status screen to be displayed to remote callers and other
various options. See the ENVIRONMENT VARIABLES section for more
information.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 6
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
THINGS TO COME
By the time you receive this program, more than likely a newer
version of it is being developed and or beta (goof) tested. Rather than
attempt to add all options planned, then test it, search for a problem,
fix it, release it. I would rather add an option or two (maybe more?),
Test it, fix it if needed, release it. Makes life easier on me that
way, Not to mention a more stable program.
Other BBS types Currently only Wildcat is supported for
communications output, CleanDiz will currently
work with other BBS types, But will not display
the status screen to a remote user.
115,200 DTE support Currently only up to 57,600 DTE is supported.
RIP Graphics Currently only B&W and Color ANSI screens will be
displayed to your remote caller. At the present
time I have no way to check RIP screens for proper
output because my 2'nd computer died :( And as
you well know already, RIP don't display locally!
ANSI Interpreter Currently ANSI.SYS must be loaded in order to see
what a remote user calling in ANSI mode see's.
ANSI.SYS need not be loaded when CleanDIz is ran
in local mode.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 7
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
KNOWN PROBLEMS, DRAWBACKS & FIXES
So far any problem encountered has been fixable, however they do come
at a price in one way or another. Previously the program was having some
trouble removing a couple different lines that were located in the
CLEANDIZ.LST file, You may have noticed a line or 2 in my released list
file that was marked as "Having a hard time removing this one" Well,
needless to say, Them remarks were notes to myself. Some lines happened
to slip through even though they were trash if they either began or ended
with certain characters even though the character was in the delete list
file and/or the internal list of characters. The solution to this problem
was to remove anything but a valid A to Z (upper and lower case) or number
0 to 9 on the programs initial pass. Which of course is the cost of the
fix as stated above, and also somewhat of a drawback. By removing
anything but an A to Z & 0 through 9, some valid characters will be
removed! But your file description will remain readable and intact!
Items like [1/5] for disk numbers, to me the "[]" around disk numbers
looked more organized & neater. So an example of the above case would be;
Original description:
Line 1: ///\\\\\\\\\File Description, whatever version [1/3] ////\\\\
Line 2: ///______________________Proudly Presents!_________________\\\\\
would end up like this,
New description:
Line 1: File Description, whatever version [1/3
Only the right bracket in the above example would be removed because the
(far most) left letter in the description is a valid character "F" which
is where CleanDiz would stop chopping on the left side of the line, and
the "3" on the right of the description is a valid character and is where
the program would start chopping characters. Line 2 would be chopped down
to "Proudly Presents" on CleanDiz's initial pass, then if this statement
was located in your delete list file ("CLEANDIZ.LST") it would be removed
also, leaving you with Line 1: for your file description "All that's
really needed!" No big deal really, But the "[1/3]" definitely looks
better than the "[1/3" (to myself atleast).
Now if the "[1/3]" happened to be located in a line by its self (or
contained trash characters to the right and/or left) the line would be
shortened to "1/3" This hardly ever happens (disk numbers on a line by
themselves), but I thought I'd let you know what would take place anyway.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 8
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
DOLOG OPTION
The dolog option should be ran daily/weekly/monthly depending on the
amount of uploads your board receives. Needless to say, the more uploads
you receive, the more you should run the dolog option.
Before I get to far into this, Let me explain the logging feature of
CleanDiz, As CleanDiz processes your uploads (or when ran locally)
removing lines, characters etc. it creates a log file located in the same
directory that CLEANDIZ.EXE and CLEANDIZ.LST is located. Each and every
line that is contained in every FILE_ID.DIZ file processed by CleanDiz will
be recorded to the log file (with the exception of removed lines of course)
Valid descriptions or trash that may have made it past the initial check!
(Be sure to keep this in mind, Valid descriptions ARE added to the log
file!)
Running CLEANDIZ DOLOG;
To start the dolog option type "CLEANDIZ DOLOG". Dolog reads your
CLEANDIZ.LOG file (explained above) line by line, prompting you to either
add the line shown to the delete list file or to skip the line. By
picking Yes, the line shown on your screen will be added to the delete
list file. Picking No, of course, skips the line. You will single
step through the entire log file, line by line until the last line is
reached or you choose Quit. When the end of the log is reached, the log
file is deleted and ready to begin logging activity again.
Choosing Quit ends your current session, Any lines processed to the
point where you choose to quit will be removed from the delete list file
and any remaining lines in the log will remain in the log until your next
session. So don't be afraid to quit when you get tired of looking at that
screen, or something comes up. But be aware of the fact that if you
don't completely finish the log that lines left in the log will remain and
new lines will be added as more files are processed by CleanDiz, Don't
worry too much about your log getting too large, CleanDiz will check the
log on each run, and if the log gets too large CleanDiz will
automatically delete it and start over.
Maximum log size will be 512k, ½ a meg. When 512k is reached, CleanDiz
will assume you have died and wont allow it's log to overrun your hard
drive, So CleanDiz will delete the log after 512k is reached. Since
CleanDiz will maintain its self, taking a vacation (or death :) you
wouldn't have to worry about coming home (or reincarnation :) and seeing
the words "Hard drive full" on your screen (Well, from CleanDiz atleast!)
Anyway, it would be wise to run DOLOG on a daily basis so that these
new phrases can be caught ASAP and added to the delete list so that they
will never bother you again!
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 9
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
DELETE LIST
CLEANDIZ.LST is a pure ASCII text file and may be edited with any
ASCII text editor (DOS's EDIT.EXE, Qedit etc.) CLEANDIZ.LST is also case
sensitive, meaning upper "CASE" is not treated the same as lower "case".
Any line and/or phrase may be added to this list and will be removed from
the FILE_ID.DIZ by CleanDiz as long as it is properly entered. But these
lines and/or phrases will only be removed from the FILE_ID.DIZ if the
line/phrase is either on a line by its self or to the right or left of a
valid description line. They will NOT be removed from the middle of what
appears to be a valid description to CleanDiz. Also, You may not begin
or end a line or phrase with anything but a valid letter (A-Z) or number
(0-9) meaning, ABC or ABC9 would be ok, ~ABC or ABCó would be ignored.
If you have an existing CLEANDIZ.LST (from version 1.0 or 1.5 of CleanDiz)
you will need to make changes to your current list and remove all
characters (except valid letters & numbers, A-Z & 0-9) from the left or
right of every line in your list. Examples are as follows.
Versions 1.0 to 1.5 Versions 2.0 & up
CLEANDIZ.LST format! <----change to!----> CLEANDIZ.LST format!
-------------------- --------------------
TRiSTaR <-ok-> TRiSTaR
& ReD <-change-> ReD
Pirates <-ok-> Pirates
'94 <-change-> 94
RED SECTOR <-ok-> RED SECTOR
--- -- -∙|_____/∙-[NEXUS'94]-∙ <-change-> NEXUS'94
This is just a short example, But from this you should get the idea
on how your current list will need to be changed.
A faster, possibly easier method of getting these needed changes done
would be to rename your CLEANDIZ.LST to FILE_ID.DIZ, Zip FILE_ID.DIZ into
a temporary archive and run the archive through CleanDiz, Extract
FILE_ID.DIZ from the temporary archive then rename FILE_ID.DIZ to
CLEANDIZ.LST, delete the temporary archive. This method would defiantly
be faster and easier if your delete list file has grown a bit since you
first started running CleanDiz. Don't worry about the actual length of
your CLEANDIZ.LST, CleanDiz has no limits to the length of file it
processes. I have not attempted this myself, But I'm positive it will
work. Just make sure to rename your current CLEANDIZ.LST to FILE_ID.DIZ
rather than copy it! If your CLEANDIZ.LST is still located in
CLEANDIZ.EXE's directory, you will wind up with a empty CLEANDIZ.LST
file.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 10
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
COMMAND LINE OPTIONS
CLEANDIZ %1 Added to your SCANFILE.BAT (Wildcat systems)
check's/clean's every upload before being added to
your database. Where %1 is the name of the
uploaded file.
CLEANDIZ filename.zip Processes filename.zip
Wildcard's & Path's
Complete drive & path's may also be used, along
with wildcards to specify multiple or single files
to process.
i.e. CLEANDIZ d:\download\*.zip
All .ZIP files in D:\DOWNLOAD would be processed.
All valid DOS wildcards may be used with CleanDiz,
For more information on using wildcards see your
DOS manual.
CLEANDIZ filelist.lst Where filelist.lst is a pure ASCII text file with
complete drive\path\filename of archived files to
be processed. Will work with several upload
scanners runlater list's, CleanDiz expects the
list file to have the extension .LST in order to
run. You may specify drive\path\filename of any
.LST file.
i.e. CLEANDIZ c:\ulscan\runlater.lst
See your upload scanners manual for more
information on there runlater list file.
NOTE: Some upload scanners name there runlater
list file with a extension of .TXT, You will need
to rename this file with an extension of .LST in
order for CleanDiz to use there runlater listing.
CLEANDIZ dolog Use this to access the interactive delete list
updater. Trims CLEANDIZ.LOG as it updates your
delete list file. See the DOLOG section of this
manual.
CLEANDIZ merge filename Use this to join 2 delete list's together.
Where filename is the list to join with your list.
See the MERGE FUNCTION section of this manual.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 11
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
ENVIRONMENT VARIABLES
This is a list of needed and/or optional environment variables,
Variables that are marked as optional are optional :) the rest will be
required for the proper operation of CleanDiz while running under Wildcat
BBS! software, Even if your running a single line system! Sorry single
liner's, But the variables are much simpler to work with than multiple
configuration files when running on a multi-line system. If the
environment variables are not correct on multi-line systems, Wildcat wont
run right! If there set correctly, then CleanDiz is also getting the
correct information! Understand? So, single liner's, just grin &
bear it :)
WCNODEID Wildcat's node identifier.
WCHOME Wildcat's home path. (C:\WC30 or C:\WILDCAT)
WCPORTID The communications port number used by Wildcat.
WCBASEID The communications port base address used by
Wildcat.
WCIRQID The communications port IRQ address used by
Wildcat.
CLEANDIZ OPTIONAL - Used by non-registered users of PkZip,
set to NOREG if your copy of PkZip is
unregistered. Registered users of PkZip should
ignore this variable.
Continued on next page.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 12
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
ENVIRONMENT VARIABLES CONTINUED
To set these variables add these lines to your batch file that starts
your BBS.
SET WCNODEID=# Where # is the node number.
(1 for single line systems)
SET WCHOME=C:\WILDCAT Path where WILDCAT.EXE is located.
Normally C:\WILDCAT
SET WCPORTID=# Where # is the communications port number
used by the node your loading.
SET WCBASEID=#### Where #### is the base address of the
communications port for the node your loading
SET WCIRQID=# Where # is the IRQ address of the
communications port for the node your loading
SET CLEANDIZ=NOREG OPTIONAL - Unregistered users of PkZip will
need to set this variable so that any -AV
stamped files will be bypassed.
Registered users of PkZip may also use this
variable if you don't want -AV stamped files
processed by CleanDiz. If this variable is
used, place this statement into your
AUTOEXEC.BAT so the variable becomes global.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 13
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
COMMUNICATIONS
CleanDiz displays a status screen to your remote user when run under a
BBS system (Wildcat only, at this time) while processing a file, But a
few environment variables need to be set, See the ENVIRONMENT VARIABLES
section of this manual.
CleanDiz supports up to 57,600 locked DTE, and all serial ports, as
well as DigiBoard's, using INT14/EBIOS or can directly access the
Digiboard its self. The format for the Digiboard configuration file is
shown below. NOTE; Due to technical problems at my beta test site,
DigiBoard support may or may not be working 100%, Please inform me if you
have any problems with your DigiBoard.
CLEANDIZ.DIG Digiboard configuration file;
------------------------------------------
DIGIBOARD
D000
320
4
Explanation of the lines in CLEANDIZ.DIG;
-----------------------------------------
Line 1 - The Digiboard interface type to use:
DIGIBOARD = Direct Digiboard Programming Interface, Must be
used in conjunction with a program called
RESETDIG.EXE. If you don't have this program but
have a Digiboard, then use the following option.
INT14/EBIOS = Indirect Digiboard Support via a device driver,
All Communications to the Digiboard (or any board
that supports INT14/EBIOS) are performed via a
software interrupt that the device driver handles.
Line 2 - If using a Digiboard, this is the memory window, or the address
the card uses as a communications area between the card and host
computer. Only needed if the Interface is set to DIGIBOARD.
Set to 0 if using INT14/EBIOS.
Line 3 - This is the I/O port address that the Digiboard is attached to.
Only needed if using an Interface set to DIGIBOARD. Set to 0 if
using INT14/EBIOS.
Line 4 - This is the channel number for this port on the Digiboard. This
is REQUIRED for DIGIBOARD and INT14/EBIOS interfaces. This is
normally 1 - 8 for the DIGIBOARD interface and 4 - 11 for the
INT14/EBIOS interface. This number tells CleanDiz which of the
com. ports on the Digiboard it should use.
If using a Digiboard, the file ("CLEANDIZ.DIG") must be located in
your node work directory (i.e. C:\WILDCAT\WCWORK\NODE#) each node using a
Digiboard MUST contain this file with the proper settings for that node and
MUST be named CLEANDIZ.DIG.
This is not required for standard serial ports, and MUST NOT be used
with standard serial ports. Information on standard serial ports needed
by CleanDiz will be read from your environment variables by CleanDiz. See
the section on ENVIRONMENT VARIABLES for more information.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 14
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
SAMPLE SCANFILE.BAT file
@ECHO OFF Suppresses the commands from
being displayed on your screen
CLEANDIZ %1 CleanDiz command line.
SCANNER %1 Where SCANNER is your upload scanners
command line.
SAMPLE FILEDESC.BAT (Wildcat 4.XX systems)
@ECHO OFF Suppresses the commands from
being displayed on your screen.
CLEANDIZ %1 CleanDiz command line.
Thats it! No need to have CD\WILDCAT\WCWORK\NODE%WCNODEID% to change
to your node work directory, CleanDiz will do that for you if not already
located in the work directory when ran. In either of the above examples
CleanDiz will extract the FILE_ID.DIZ file from the uploaded file (i.e. %1)
clean the garbage up and re-insert it back into the file.
Do not place CleanDiz in both batch files (SCANFILE.BAT &
FILEDESC.BAT) use it in one or the other, depending upon your preference.
CleanDiz will still function properly and will not harm the uploaded file
if used in both batch files (SCANFILE.BAT & FILEDESC.BAT) together, but
there is no reason to place it's command in each, it will only slow down
the processing of uploaded files.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 15
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
SUPPORTED ARCHIVERS
Archiver Tested Versions
--------------- ---------------------------------------------
PKZIP & PKUNZIP Version 2.04G, Registered & UnRegistered.
See the ENVIRONMENT VARIABLES section for
information on usage of non-registered
versions of PkZip.
ARJ Version 2.30, UnRegistered version, An ARJ
archive with a security envelope could
present a problem? Contact me if you have a
problem with ARJ's security envelope.
See TECH SUPPORT section.
DWC Version 5.10, UnRegistered version.
HYPER Version 2.5, UnRegistered version.
PAK Version 2.51, UnRegistered version.
PKPAK & PKUNPAK Version 3.61, UnRegistered version.
ZOO Version 2.1, UnRegistered version.
All supported archivers MUST be accessible from your path in order for
them to function with CleanDiz. See your DOS manual for more information
on your path variable.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 16
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
MERGE FUNCTION
The merge function takes 2 delete list files and joins them together.
Much like the command copy file1 +file2 file3, but with a little
difference, The merge function first copies the new delete list that you
obtain from another sysop using CleanDiz into your current delete list,
Then CleanDiz will make a call to DOS's SORT.EXE and sort the file, After
the delete list has been sorted CleanDiz will check the newly sorted delete
list file for duplicate entries and removes all duplicates it finds, And
re-creates the delete list file ("CLEANDIZ.LST") simple as that!
To start the merge just start CleanDiz with the following command;
CLEANDIZ MERGE drive\path\filename where filename is the list file that
you acquired from another user of CleanDiz, NOT YOUR CLEANDIZ.LST! The
entire merge process only takes a few seconds, depending on the size of the
list files to merge together, and your CPU speed. CleanDiz then exits
and reports the number of lines added to your delete list file. Thats all
there is too it!
Do NOT run the merge function in a multi-line environment, Strange
things will happen. Instead, either take the board down completely,
then run it, or run it during a system wide event. In either case, the
board would be completely down and there would be no chance of a remote
user accessing CleanDiz while the merge is taking place.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 17
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
TECH. SUPPORT INFORMATION
Tech support is available through the Howling BBS! (810) 640-1584 by
leaving E-Mail to Night Stalker in any available conference. Or through
Mustang Softwares HQ BBS! by leaving E-Mail to Lawrence Paul in conference
0 - private mail only (the only conference on MSI HQ I scan due to them
costly L/D charges) Although I welcome any and all comments and
suggestions to CleanDiz, Tech support is only available to supporting
users of CleanDiz.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 18
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
WHAT'S NEW
Ver Release
# Date Features
--- ------- ------------------
1.0 5/29/94 First working copy "I got there number" :)
---------------------------------------------------------------------------
1.5 6/4/94 Added a logging feature, with a interactive routine to
add complete lines from the log to the delete file.
See to DOLOG section in the CLEANDIZ.DOC for further
information.
Expanded the internal list of characters to be removed on
the programs initial pass.
---------------------------------------------------------------------------
2.0 11/26/94 Added a status screen. Much like other upload scanners
status screens. Now you can see what's going on while the
files being processed.
Added communications port output, Now your users will know
what's going on while CleanDiz process their file.
Supports standard serial ports and Digiboard's.
See the COMMUNICATIONS section of the manual.
Expanded the internal list of characters to be removed, Now
removes all ASCII characters except a valid A-Z and 0-9 on
the initial pass.
See the KNOWN PROBLEMS, DRAWBACKS & FIXES section of
the manual for further information.
Optimized high ASCII character removal code for increased
speed and a more complete cleaning of the DIZ file.
With the change to the ASCII character removal, your
currently installed delete list file "CLEANDIZ.LST" will
need to be changed. See the DELETE LIST section of
the manual for more information, and the CLEANDIZ.LST
packaged with this release.
Added support for non-registered users of PKZIP, See the
ENVIRONMENT VARIABLES section of the manual.
Added support for ARJ/DWC/HYP/PAK/ARC/ZOO archives.
See the SUPPORTED ARCHIVERS section of the manual.
Enhanced multi-line support.
Continued on next page.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 19
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
WHAT'S NEW CONTINUED
Ver Release
# Date Features
--- ------- ------------------
2.0 11/26/94 Fixed a oversight (bug) of mine in the DOLOG routine,
previous versions would report multiple occurrences
of descriptions when you ran DOLOG. Now when you run DOLOG
CleanDiz will first make a call to DOS's SORT.EXE sorting
the log, then remove any duplicate descriptions in the log
file so you will not be prompted to add/not add the same
line multiple times.
Fixed another bug in DOLOG that wasn't allowing the last
line in the log file to be read by DOLOG, Now DOLOG will
read every line in the log file allowing you to add/not add
every line in the log file.
Added support to automatically delete the log file if it
gets larger than 512k in length (½ a meg), For those of
you who don't have time to mess with the DOLOG option on a
regular basis. This will keep the log from getting
oversized and unmanageable.
Added support for DOS's wildcard characters while entering
files to be processed locally. See your DOS manual for
more information on the use of wildcards,
See the COMMAND LINE OPTIONS section of the manual for a
more detail description on wildcard usage.
Added support for reading a list file of files to be
processed. See the COMMAND LINE OPTIONS of the manual for
more information on using a list file.
ZIP files processed will now retain there original date
rather than update the ZIP date to the current date. For
those of you who are date checking files by ZIP date rather
than internal file dates.
Added a merge function, multiple delete list files can be
joined together to expand your delete list files.
See the section on the MERGE FUNCTION for more information.
Added support for Wildcat 4.0's new FILEDESC.BAT.
A MUCH needed re-write of this documentation, I'll admit
it, I stink at writing doc's, I'm sure you'll agree if
you've seen the older versions out there :) These doc's
are a whole lot better, Well I think atleast :)
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 20
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
QUESTION'S AND ANSWERS
Q: Why should I run CleanDiz on uploaded files?
A: Completely up to you! If you've never experienced a file description
with high ASCII characters and/or phrases such as "Mutha F***in" that
was imported into your file database, or needed to do keyword
search with characters like "///\\\\\" CleanDiz probably would be a
waste of your efforts, But from what I've seen in the BBS world,
Every board gets these types of file descriptions sooner or later.
So you may as well stay ahead of the game.
Q: Why should I donate money for this program? If you want money for
it, just make people pay for it!
A: Completely up to you! Donations will help keep me interested in
making the program better/faster/smaller and as bug free as possible.
I figured that I would make the program donation warz rather than key
the program & force you to pay for it. Rather than doing that I
decided I would use the "HONOR SYSTEM" of registration. If you like
the program & use it longer than 30 days, then send in $ 5.00 to
ensure it's continued existence. If you don't like the program,
nuke it and be plagued with "ªàÉ⌠Θ·⌡" for file descriptions forever!
Q: CleanDiz is not displaying the status screen to a remote caller.
A: Make sure the environment variables are set, See the ENVIRONMENT
VARIABLES section for information on how to set these variables.
If your using a Digiboard make sure you have the CLEANDIZ.DIG file
located in your node work directory with the correct settings for your
Digiboard. See the COMMUNICATIONS section.
If your not using a Digiboard, check to see if the file CLEANDIZ.DIG
is located in your node work directory. If one exist, remove it!
Q: Since upgrading to CleanDiz 2.0, theres phrases that are not being
removed anymore! CleanDiz 1.5 used to remove these lines?
A: The format for the delete list has changed with version 2.0. See the
DELETE LIST section for more information.
Continued on next page.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 21
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
QUESTIONS AND ANSWERS CONTINUED
Q: Even though CleanDiz is located in my current directory, when I try
to run the program it comes up with a message saying that
"CLEANDIZ.EXE is not located in my path! Aborting" Why? Its in the
current directory?
A: CleanDiz expects to find its .EXE file and .LST file from the path
environment variable and your current directory is not located in
DOS's search path. To correct this, move CleanDiz's .EXE, .LST
files to a directory accessible from DOS's search path.
See your DOS manual for more information on DOS's search path.
Q: PkZip is displaying a help screen after an upload, What's going on?
A: The upload you received has a -AV stamp in it and you are not running
a registered copy of PkZip. To fix this problem set the environment
variable CLEANDIZ to NOREG see the ENVIRONMENT VARIABLE section
and/or your DOS manual for more information on environment variables.
Or register PkZip (PkWares PKZIP is well worth the money!)
CleanDiz uses the -! to insert the FILE_ID.DIZ file back into the
uploaded ZIP file if the file has an -AV stamp, the unregistered
version of PkZip don't support the -! option. When CLEANDIZ=NOREG
variable is set, -AV stamped files will be bypassed.
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 22
---------------------------------------------------------------------------
CleanDiz Version 2.00 November 26, 1994
---------------------------------------------------------------------------
DONATION INFORMATION
CleanDiz unlike other "shareware" programs is being released in more
of an "honor system" of registration, CleanDiz is fully functional with
no limitations in the program what so ever. Rather than key the program &
bloat the code with algorithms that I hardly understand anyway, It's up to
you to send in a donation for the program. Use it for 30 day's, if you
like it then help out by making a donation for it's continued existence.
If after 30 days you don't feel that you'd even send in 5 bucks, type in
DEL CLEANDIZ.* simple as that. From the other programs out there that
I've seen that do the same thing as CleanDiz, CleanDiz is the best
without a doubt, handles more archivers, wont compromise the integrity of
a -AV stamped ZIP file, has communications port output, just to name a few
things that make it the best! So it's got to be worth something to you.
Mail all donations to;
Lawrence Paul
P.O. Box 361
Genesee, MI. 48437
Send check or money order payable in U.S. Currency only!
DO NOT SEND CASH!!
---------------------------------------------------------------------------
(C) Copyright Lawrence Paul, 1993 - 1994, All Rights Reserved. Page 23