home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-387-Vol-3of3.iso
/
f
/
fdude30.zip
/
FILEDUDE.DOC
< prev
next >
Wrap
Text File
|
1993-03-21
|
19KB
|
618 lines
F I L E D U D E
version 3.0
"The final answer to the Renegade file management woes."
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Copyright (C) 1992,1993 Edhanced Software
All rights reserved
written by Edward Stangler
Operating Manual
____________________________________________________________________________
Contents:
__________________________________________________________
Introduction
What FileDude does ............................... 1
Special thanks ................................... 1
Features ......................................... 1
__________________________________________________________
Usage
Quick Start ...................................... 2
Commands ......................................... 3
In-Depth Command Summaries ....................... 4
__________________________________________________________
Miscellaneous
Registration ..................................... 9
Legal information ............................... 10
____________________________________________________________________________
FileDude v3.0 _________________________________________________ Introduction
What FileDude does...
~~~~~~~~~~~~~~~~~~~~~
FileDude is the final answer to your Renegade file management woes.
The original purpose of this utility was to just plain upload. Over the
past few months, however, it's grown to do much more.
FileDude v3.0 does just about everything you need to adequately
maintain your file lists (.DIRs) and fix them when disaster strikes.
It does not promise miracles - but it goes further than Renegade will.
Special thanks
~~~~~~~~~~~~~~
I'd like to thank all the beta sites for testing FileDude and
putting up with the small problems and inconsistencies. Your comments
paid off in the end.
I'd like to extend a large "Thank You!" to Craig Landgraf. Yes,
Cott - Craig Landgraf. FileDude would not have been released if it
wasn't for him. In fact, FileDude was created because Craig mentioned
(or rather hinted) he'd like to have such a utility. Thanks!
Features
~~~~~~~~
Major features:
o Automatic upload of files not listed in .DIRs
o Finding and applying any internal descriptive files,
such as FILE_ID.DIZ and DESC.SDI
o Applying descriptions for files from a descriptive file list,
such as FILES.BBS
o Conversion of all archives to a default archive type
o Extremely flexible file lister, utilizing several "template"
files to provide the SysOp with complete control over the
look of the file lists
____________________________________________________________________________
FileDude v3.0 Page 1 Introduction
FileDude v3.0 _________________________________________________ Introduction
Fixing features:
o Fixing file sizes
o Fixing OFFLINE status flag to show whether a file actually
exists or not
o Deleting entries with the OFFLINE status flag
o Fixing vpointers (extended description pointers)
o Delete blank or NULL entries
Other features:
o Set validation of uploads
o Set or change file points on all or uploaded files
o Exclude or include on certain directories or files
Quick Start
~~~~~~~~~~~
The best way to see all the commands is to just run FileDude with
no parameters. This will bring up pages of help, designed to be straight
and to the point.
The basic syntax for what you'll probably need is:
FILEDUDE /LISTCFG=[path][FBASES.DAT] /EXTENDED=[path][EXTENDED.DAT]
This will automatically upload any files encountered, which are not
on the .DIR lists, with the default description. It will also
fix vpointers (a default, non-changeable option).
The parameters you will probably most want to use are:
/OG - Only upload when non-default description found
/ID - Try to find FILE_ID.DIZ inside uploaded archives
/IDM - Try to find FILE_ID.DIZ inside archives already in .DIRs
/NU - Don't upload at all
/UI - Ask me for the descriptions!
/FS - Fix file sizes
/FO - Fix OFFLINE flags
/DO - Delete files with OFFLINE flags
____________________________________________________________________________
FileDude v3.0 Page 2 Usage
FileDude v3.0 ________________________________________________________ Usage
Commands
~~~~~~~~
Syntax:
FILEDUDE /LIST=[file area listing] /DIR=[directory spec]
or
FILEDUDE /LISTCFG=[file area configuration]
Options:
/UI - Ask for descriptions /NU - Don't upload
/FO - Fix OFFLINE /NN - Don't mark as new
/FS - Fix SIZE /NV - Don't validate
/DO - Delete OFFLINE /NF - Don't remove description
/ID - Scan uploads for FILE_ID.DIZ file (FILES.BBS)
/IDM - Scan existing for FILE_ID.DIZ /NC - Don't delete original
/OG - Only upload when description archive after converting
found (not default or user input)
/EXTENDED= - Use [path][filename] (EXTENDED.DAT) to store extended
descriptions; required if using /ID, /IDM, /ID=, or /IDM=
/FILELIST= - Generate list of files called [path][filename]
/T= - Use templates ending with [3-letter extension]
Advanced switches:
/AUTO= - Use [path][filename] (FILEDUDE.DAT) for directories to process
/EXEMPT= - Use [path][filename] (EXEMPT.CFG) for omitting filespecs
/DESC= - Use [filename] (FILES.BBS) for descriptions
/CONVTO= - Convert all archives to [3-letter arctype]
/ID= - Scan uploads for [filename] internal description file
/IDM= - Scan existing for [filename] internal description file
/FP= - Points per 1k (default: FREE) (Can be a decimal) for uploaded
/FPM= - Points per 1k (default: FREE) (Can be a decimal) for existing
____________________________________________________________________________
FileDude v3.0 Page 3 Usage
FileDude v3.0 ________________________________________________________ Usage
In-Depth Command Summaries
~~~~~~~~~~~~~~~~~~~~~~~~~~
/UI - Ask for descriptions
If unable to find a non-default description, FileDude will prompt
you for a description. Several Renegade-like commands are
available:
.S - Skip to next file
.D - Delete current file from DOS
.N - Go to next file area (skip current file, too)
. - Quit FileDude immediately
\ - (Placed at beginning of description)
Enter an extended description. Though FileDude will keep
allowing you to enter lines until a blank line is encountered,
only the first 4 lines of an extended description will be
saved (making 5 lines total for a description.)
/FO - Fix OFFLINE
FileDude will check all files to see whether they really exist or
not. The OFFLINE flags are updated accordingly. File dates
are updated only if a file's OFFLINE flag is incorrect.
/FS - Fix SIZE
FileDude will check all files to see whether the .DIR has the
correct file sizes. File dates are updated only if the file size
is incorrect.
/DO - Delete OFFLINE
FileDude will delete any files which have an OFFLINE flag. First,
however, FileDude will check to see whether a file actually
exists or not.
____________________________________________________________________________
FileDude v3.0 Page 4 Usage
FileDude v3.0 ________________________________________________________ Usage
/ID - Scan uploads for FILE_ID.DIZ
An attempt to extract FILE_ID.DIZ from any uploaded archives will
be made. If FILE_ID.DIZ is found, it will be used for the
description. It overrides the default and FILES.BBS descriptions.
The ARCHIVE.CFG file must exist in the FileDude directory to use
this feature.
/IDM - Scan existing for FILE_ID.DIZ
An attempt to extract FILE_ID.DIZ from all archives will be made.
If FILE_ID.DIZ is found, the description will be tested against
the existing description. If they do not match, the extracted
description will be applied. It overrides the default and
FILES.BBS descriptions. The ARCHIVE.CFG file must exist in the
FileDude directory to use this feature.
/OG - Only upload when description found (not default or user input)
FileDude will only upload files when it finds a non-default
description automatically. In other words, if it doesn't have
to use the default description or ask the user for input, the
file will be uploaded. Great parameter!!
/NU - Don't upload
FileDude will not upload at all. Not for a million dollars.
Not for all the file points in the universe. No siree -
NOT AT ALL! :)
/NN - Don't mark as new
FileDude will not update the date of any file whatsoever.
/NV - Don't validate
FileDude will not validate any file uploaded. No siree -
it will not budge. It will stand fast in the face of
adversity. It will... it will... well, you get the point.
____________________________________________________________________________
FileDude v3.0 Page 5 Usage
FileDude v3.0 ________________________________________________________ Usage
/NF - Don't remove description file (FILES.BBS)
FileDude will not remove any description file. It will
spare the bytes of any FILES.BBS-type file it encounters.
/NC - Don't delete original archive after converting
When FileDude converts an archive, it will not delete the
original. Great in case lightning strikes the computer. :)
/EXTENDED= - Use [path][filename] (EXTENDED.DAT) to store extended
descriptions; required if using /ID, /IDM, /ID=, or /IDM=
This parameters will probably be a MUST for anything you do.
It tells FileDude where to find the extended description storage
file.
/FILELIST= - Generate list of files called [path][filename]
FileDude will generate a list of files using the "template"
files (see /T= parameter).
FileDudeMCI codes (used in the templates) are as follows.
Consistency with Renegade's MCI code system has been attempted.
MCI CODES ARE CASE SENSITIVE!
@a Current date which file list is being compiled on
@r Date that file was uploaded
@x Name of current file being processed
@y Size of current file being processed
@z Description of current file being processed
@Y Name of current file area being processed
@v Total bytes in current file area processed to that point
@w Total number of files in current file area processed to that
point
@s Total bytes processed to that point
@t Total number of files processed to that point
@u Total number of directories process to that point
____________________________________________________________________________
FileDude v3.0 Page 6 Usage
FileDude v3.0 ________________________________________________________ Usage
@1 Extended description of current file - Line #1
@2 Extended description of current file - Line #2
@3 Extended description of current file - Line #3
@4 Extended description of current file - Line #4
/T= - Use templates ending with [3-letter extension]
Template files with this 3-letter extension will be used in
making the file list. ANS, ASC, and AVT are three popular
extensions. As you might have guess, this refers to what
type of coloring system, etc. used.
The following template files are currently used by FileDude:
(replace 'xxx' with the 3-letter extension)
HEADERS.xxx - Before file list
This file is displayed before any of the files
are listed. Typically, one could use this for
BBS advertisement, message to users, file list
title, general introduction, etc.
PREBODY.xxx - Just before directory
This file is displayed before each .DIR listing
of files. It contains the directory
description, header info on the file info, etc.
BODY.xxx - Displayed for file entry without extended description
For every file entry which does NOT have an
extended description, this file is displayed.
BODYE#.xxx - Displayed for file entry WITH '#' of extended lines
For every file entry which DOES have an extended
description, this file is displayed. The '#'
is replaced with the number of lines of the
extended description.
POSTBODY.xxx - Just after directory
This file is displayed right after each .DIR's
files are all displayed. Totals, etc. are included.
____________________________________________________________________________
FileDude v3.0 Page 7 Usage
FileDude v3.0 ________________________________________________________ Usage
FOOTERS.xxx - After file list
This file is displayed after the file list. Totals
are also included in this file.
/AUTO= - Use [path][filename] (FILEDUDE.DAT) for directories to process
FileDude will include all .DIRs listed in this file.
An entry in this file looks like this:
[name of .DIR file, without the extension]
[DOS directory containing the files]
If the /LISTCFG= parameter is used, the second line
of the above entry may be omitted.
/EXEMPT= - Use [path][filename] (EXEMPT.CFG) for omitting filespecs
Filespecs on each line of this file will be omitted.
Example:
*.GIF
FDUDE30.ARJ
WOW.*
(files matching those criteria would not be processed.)
/DESC= - Use [filename] (FILES.BBS) for descriptions
FileDude will read this file for descriptions. These
descriptions will be used for uploads and to update
existing files. Even if some files in this list do
not actually exist, they will be uploaded. File dates
will be updated.
The format for an entry in this file is:
[filename] [description]
(The number of spaces between [filename] and
[description] may be any number greater than 0)
____________________________________________________________________________
FileDude v3.0 Page 8 Usage
FileDude v3.0 ________________________________________________________ Usage
/CONVTO= - Convert all archives to [3-letter arctype]
If a file's archive type isn't this one, FileDude
will convert it. Any errors will prevent any update
to the .DIR file. If the target archive already exists,
there's an error. The ARCHIVE.CFG file must exist in the
FileDude directory to use this parameter.
/ID= - Scan uploads for [filename] internal description file
Same as /ID parameter, except you substitute a
[filename] for FILE_ID.DIZ.
/IDM= - Scan existing for [filename] internal description file
Same as /IDM parameter, except you substitute a
[filename] for FILE_ID.DIZ.
/FP= - Points per 1k (default: FREE) (Can be a decimal) for uploaded
FileDude will set these amount of file points per
ever 1k for each file uploaded. Decimals are
allowed. 0.5 file points per 1k = 2k per 1 file point
/FPM= - Points per 1k (default: FREE) (Can be a decimal) for existing
Same as /FP=, except FileDude alters existing files.
Registration
~~~~~~~~~~~~
I've spent many months working on this program. It's saved me
hundreds of hours maintaining my bulletin board system - as I'm sure it
will do for you. So if you find this utility useful, PLEASE register
it. It's simple: just fill out the REGISTER.FRM file, print it out,
include $15, and send the envelope to:
Edward G. Stangler
P.O. Box 38553, Suite #247
Houston, TX 77238-8553
____________________________________________________________________________
FileDude v3.0 Page 9 Miscellaneous
FileDude v3.0 ________________________________________________ Miscellaneous
Legal Information
~~~~~~~~~~~~~~~~~
All brand and product names referenced in this document are trademarks,
registered trademarks, or copyrighted works of their respective holders.
This software and documentation is protected by both United States copyright
law and international treaty provisions.
You are free to make copies of the software and documentation, however, all
materials relating to this license statement, software, documentation, order
information, copyright and trademark statements must remain intact as
supplied in the original shareware package. You may not distribute, rent,
sublicense, integrate or lease the software or the documentation. You may
not alter, modify, or adapt the software or documentation, including but not
limited to translating, decompiling, reverse assembling, or creating
derivative works.
The author disclaims all warranties, either express or implied, including
but not limited to implied warranties of merchantability and fitness for a
particular purpose, with respect to the software and any accompanying
written materials. In no event shall the author be liable for any damages
whatsoever (including, without limitation, damages for loss of business
profits, business interruption, loss of business information, or other
pecuniary loss) arising out of the use and/or misuse of this product, even
if the author has been advised of the possibility of such damages. Because
some states do not allow the exclusion or limitation of liability for
consequential or incidental damages, the above limitations may not apply to
you.
Whew!! Now, go enjoy this program!
Edward Stangler, author of Filedude
CompuServe: 74620,2333 Call our support board:
Fidonet: 1:106/1076 Mr. Ed's Corner
ITCnet: 85:841/805 (713) 447-6119
SGA-Net: 30:30/0 300-19200 bps
____________________________________________________________________________
FileDude v3.0 Page 10 Miscellaneous