home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
PBFM105.ZIP
/
PBFILMAN.DOC
< prev
next >
Wrap
Text File
|
1995-05-06
|
15KB
|
340 lines
PBFILMAN v1.05 (Public release)
PEFILMAN is written by Jeff Paul, All Rights Reserved
Jeff Paul may be reached at RoboNERDS BBS
1-615-890-4796 (v.32bis), the ProBoard Support Echo (FIDO)
or netmail to FIDO 1:116/137 or Internet mail to
Jeff.Paul@137.trapper.isdn.net
Welcome
=======
Welcome to PBFILMAN. PBFILMAN is a utility program designed and coded JUST
for ProBoard. It has been tested with ProBoard v2.00, 2.01 and should work
with the yet to be released 2.02.
I wrote PBFILMAN as a utility to get myself a means of moving files (along with
their descriptions) from one file area to another.
I also wanted a program that anyone can run the minute that it is installed
without reading too much of this DOC.
What's NEW in version 1.05
==========================
Under Configure is a new option for setting up how you want PBFILMAN to
sort each of your hard drive file areas. Please select this option and
tell PBFILMAN how you want things sorted. The program will default to
"Natural Order" if none is selected.
File listings will now list in the sorted order.
Files beginning with "!" should now work. (Bug fix)
When moving a group of files PBFILMAN was leaving an Orphan file description.
This has been fixed. (Bug Fix)
When moving files, if the last file in a listing was moved to another area
then the last line of a multi-line description would be lost.
This has been fixed. (Bug Fix)
New "Remove" option will remove the description from the file list but will
not delete the file from the hard drive.
New command line option.
/S# Will sort file area #.
For example: PBFILMAN /S5 This will sort file area number 5 in what ever
order is set up in the sort configuration file. If you want to sort several
file areas then just repeat the process in your batch file. For Example:
PBFILMAN /S1
PBFILMAN /S3
PBFILMAN /S15
PBFILMAN /S55
This would sort file areas 1,3,15 and 55.
The command line option /NH for "No Header" will leave an existing header if
one already exists but will not add PBFILMAN's header.
The command line option /I can now be followed by a number to tell what
column to start multi-line descriptions. For example PBFILMAN /I10 would
start the multi-line descriptions at the 10th column.
ALL NEW editor for editing a files description. Full functions with word wrap,
line delete, etc.
What's NEW in version 1.04
==========================
From the main menu there is a new option called "Configuration"
This will call a menu that allows you to select the file areas that are to
be used for each of the four available Allfiles or Newfiles listings.
Just tag the file areas that you want included in the listings.
NOTE: Unregistered users of PBFILMAN can only set up 1 set of file areas for
the ALLFILES and NEWFILES listings. Registered users are able to set up 4
sets of file areas for the listings - giving the ability to create a total
of 4 Allfiles listings and 4 Newfiles listings.
You MUST take the Configuration option and select the areas to include in the
Allfiles/Newfiles listings before any of the listings can be created.
To create an Allfiles listing you run PBFILMAN with command line options.
New command line options:
/A1(Path and Filename) - Will create an allfiles list with the areas selected
for the number 1 listing. The allfiles listing will
be created using the named path and filename.
/A2(Path and Filename) Same as /A1 except uses number 2 listing.
/A3(Path and Filename) Same as /A1 except uses number 3 listing.
/A4(Path and Filename) Same as /A1 except uses number 4 listing.
For Example:
PBFILMAN /A1C:\NEWFILES\ALLFILES.TXT
This command will create an allfiles listing called ALLFILES.TXT in the
C:\NEWFILES directory on drive C:. The areas in the listing are from the
Allfiles 1 Configuration.
PBFILMAN /A1ALL1.TXT /A2ALL2.TXT /A3ALL3.TXT /A4ALL4.TXT
This will create all four allfiles listings in the current directory with the
names ALL1.TXT, ALL2.TXT, ALL3.TXT and ALL4.TXT.
Newfiles listing.
==================
New command line options:
/NF<NUMBER DAYS> When this option is added to the command line for creating
ALLFILES listings it will create NEWFILES listings instead.
For Example:
PBFILMAN /A1NEW1.TXT /A2NEW2.TXT /NF30
This example will create two NEWFILES listings with the names NEW1.TXT and
NEW2.TXT. They will both include files that are no more than 30 days old.
NEW1.TXT will include file areas selected for listings number 1 configuration.
NEW2.TXT will include file areas selected for listings number 2 configuration.
What's NEW in version 1.03
==========================
New features in version 1.03 include a duplicate file finder, remove off-line
files, memory status, file area displayed and number of files display at top
of screen. Moving files on the same drive now runs MUCH faster.
NEW command line options.
/I Indent
Will cause PBFILMAN to indent extended descriptions so they line up with
the first description line of a file. Normally extended descriptions
start in column two. This works with the DIZ, ADOPT, and EDIT functions.
/NH No Header
Normally PBFILMAN will add a header to the top of the files.bbs list
when it updates the list. If you do not want a header created then use
this switch.
For example: PBFILMAN /I /NH
Will run PBFILMAN and will not create headers and will indent extended
descriptions when a DIZ, ADOPT, or EDIT is done.
Installation
============
Just copy the main program (PBFILMAN.EXE) into your PB directory.
This is usually C:\PB.
PBFILMAN "MUST" be run from the ProBoard main directory.
Copy PBFILMAN.NOT to the PB directory. This is a plain text file that
contains the file names of any files that you DO NOT want the ADOPT
option to add to your file listings. For example FILES.BBS FILES.BAK etc.
!!! NOTICE !!! If you want PBFILMAN to import FILE_ID.DIZ descriptions from
ZIP and ARJ archives then PKUNZIP.EXE and ARJ.EXE MUST be in the same
directory as PBFILMAN. (This is usually C:\PB)
That's it.
After you register your copy of PBFILMAN you will receive a file named
PBFILMAN.KEY that must also be copied to the same directory as PBFILMAN.
What will PBFILMAN do for me?
=============================
PBFILMAN can do the following:
Move one file from one file area to another.
Delete one file from current file area.
Tag files in current file area.
Move all tagged files from current file area to another.
Delete all tagged files from current file area.
Multi word description searches.
Edit file descriptions.
Sort file areas by your choice of File Name, File Date, Reverse File Date.
Import FILE_ID.DIZ descriptions from ZIP and ARJ archives.
Adopt new files (along with their FILE_ID.DIZ descriptions) into an area's
FILES.BBS listing.
Remove Off-Line files from the BBS listing.
Create a display listing Duplicate file names and the file areas where the
duplicates can be found.
Tag files that have a duplicate in another file area.
Memory Status display.
ALLFILES and NEWFILES listings.
If no changes are made to an area, you can now exit WITHOUT sorting or updating
the Files.BBS.
Mostly, PBFILMAN is easy to set up, easy to use, and will save any ProBoard
sysop allot of time.
How to Use
==========
To start PBFILMAN just change to the PB directory and type "PBFILMAN".
PBFILMAN will load and give you a list of all Hard Drive file areas on your
BBS. Full mouse support makes program use very easy, but if you don't have a
mouse then buttons can be selected by pressing ALT and the highlighted letter
on a button. Scrolling bar options can be selected with a double mouse click
or by pressing the Enter key. All screens can be exited by pressing the ESC
key. The UP and DOWN arrow keys and the Page Up and Page Down keys will
move up and down the current listing.
PBFILMAN only supports file areas that are stored on the Hard Drive. The main
reason for PBFILMAN is to move files around so there is no need to show CD-ROM
areas. When you select a file area, PBFILMAN will load in the file descriptions
and file dates for all the files in that area. The listing will be displayed
in file name sorted order. From this listing you can do the following:
Tag - This option will place a check mark next to the highlighted file so
that it may be processed with a group of tagged files. Selecting
Tag on a file that is already tagged to clear the tag.
Untag All - This option will clear ALL tags for all "tagged" or "marked for
delete" files.
Delete - This option will place a "D" next to the highlighted file and mark
it for Delete. Marked files are not actually deleted until you Exit
the current file area. Selecting Delete on a file that is already
marked for delete will clear the delete flag.
Delete Tagged - This option will mark all Tagged files for Delete.
Move File - This option will move the highlighted file and description to
another file area of your choice.
Move Tagged - This option will move ALL Tagged files and their descriptions
to another file area of your choice.
Search - This option will prompt for up to two words to search for in the
current file area descriptions. All files that match the search
will be Tagged. After the search, the first file tagged from this
search will be highlighted. Searches never clear tags. If you
search on the word "Window" then you will have all files with
"Window" in the description Tagged. If you then search on the word
"VGA" you will have a listing with files tagged from both searches.
If you enter both a Primary and Secondary search then both words
must exist before a file will be tagged.
Edit - This will allow you to edit the description for the highlighted file.
DiZ - This option will import the FILE_ID.DIZ description from a ZIP or ARJ
archive file. NOTICE - for this option to function - PKZIP.EXE and
ARJ.EXE must be located in the main ProBoard directory.
Adopt - This option will import any new files that are not already in the
area's FILES.BBS listing. If any of the files are ZIP or ARJ
archives then PBFILMAN will try to import their FILE_ID.DIZ.
If no FILE_ID.DIZ is found then the description will be set to
"Description not available."
Other - This will display a menu of some less used options. Under the
Other menu you have the following choices.
Remove Off-Line Files - This option will scan the displayed file area
and remove the files and descriptions for all
files that display "Off-Line" next to the
file name. If you ever use the DOS delete
command to delete files from a file area this
option can save allot of time cleaning up the
files.bbs.
Duplicate File Name List - This option will read the file index that
PBUTIL FI creates and will display a list
of all the files that exist in more than
one file area. The displayed list will
show the file name, Area number, and the
file area description. Depending on how
many files exist on the BBS this option
can take from a few seconds to several
minutes to run. Make sure your file index
is up to date before taking this option.
It will only create this listing once.
If you take this option a second time it
will just display the current list of
duplicates.
Tag Duplicate Files - NOTE: You MUST take the "Duplicate File Name
List" before this option can be selected.
This option will tag any files in the displayed
file area that have a duplicate in any other
file area.
Memory Status - This option will display the amount of free
Conventional, Virtual, and Largest Virtual Block.
The main one to watch is the Virtual amount. For
best performance it should have at least 4 Meg.
If it is below this amount then you need to free
up some disk space.
Exit - Will exit to the main file area screen.
Exit - This option will present a screen so that you may select the order of
the file listing. The listing may be sorted by your choice of
Filename, Date (old to new), Reverse Date (new to old), or Natural
Order (No Sorting). After this selection the file listing is
updated and files flagged for delete are deleted.
There is now a new option. If you have made no changes in the current
file area, then you have the option of selecting the "Exit No Update"
button. If changes have been made then you must select a sort option.
Notice
======
Remember to run PBUTIL FI after you make any changes.
PBFILMAN should not be run while anyone is using the BBS.
It's always a good idea to backup your file listings before using any new
utilities.
Shareware
=========
This program is being distributed as Shareware. You may use this program for a
period of 30 days. After this 30 day trial period you must either register or
quit using PBFILMAN. If you register you will be sent a KEY file that will
remove the NAG screen and show that you are a registered user. Registration is
good for this and ALL future versions of PBFILMAN. Please see the file named
REGISTER.DOC for registration information.
Disclaimer
==========
USE OF THIS PROGRAM IS AT YOUR OWN RISK. Even though PBFILMAN has been very
well tested, there is always the possibility of an unknown problem. There is no
warranty either expressed or implied. The author Jeffrey C. Paul, and everyone
associated with RoboNERDS BBS, can in no way be held responsible for any damage
caused by the use of PBFILMAN. The only thing PBFILMAN is guaranteed to do is
take up disk space. By using PBFILMAN you are hereby held to the above terms.