                                   BSUp
                                 ========

                    'THE' Bulk uploader for DLG BBS OS


Disclaimers.
============
- This is a PD file. No money is requested.
- BSUp can be distribute all around and can be used free, but remember to
  spread entire packet.
- BSUp isn't guaranteed, you use it at your own risk!.
  It can destroy your HD contents or can cause great damages. The Author
  undertakes no liability for any damage caused by appropriate or not
  appropriate use of this programs.
- Donations accepted. Donations will be devolved to AIRC (Italian
  Association for Cancer Research).
- If you send a donations greater than 10$ (US $), i can send you sources,
  if you want.


Author.
=======
Felice Murolo - Via Posidonia 205 - 84128 - Salerno - Italy
Sysop of MAX BBS - 2:335/206@fidonet 39:102/5@amiganet
39 89 756281 HST/V32terbo - 24h


History:
========
1.0   first version, for internal use
1.1b  recompiled with SASC 6.3, bugs fixed. First public release


What is BSUp?
=============
BSUp is a bulk uploader for DLG. I've seen more of these programs all
around, but no one of these was good for my needs.
So, I've written my own program.


What is a Bulk Uploader?
========================
A bulk uploder is a program who adds (uploads) some files to a file area.
Normally, you must copy some new files into a file area directory and then
you want to add these files to the list. So, you recall a bulk uploader who
adds files to the file area for you.


How works BSUp?
===============
BSUp reads file area list of the area you've specified, reads the dos
directory list of the area, compare the two lists and then adds new files
to the file area list. It uses filecomment of new files for description,
current date/time for date/time, filesize for size, "Sysop" or any other
string you specify with -S switch for Sysop Name.
It also can delete files deleted from file area list, if you specify
the FRESHEN switch.


Usage.
======
Type BSUp from CLI.


Step by Step for Upload.
========================
This is an example for your Upload.

- You've some new files in MAIL:INBOUND (you have made a file request).
- Set a filenote which contain a description for each files and copy files
  in the rigth area (sorry, 80 char max).
- From CLI (or from DOPUS or any other directory util) execute
  BSUP <area_number>
- Some infos will be printed in stdio and the files will be added to file
  area list of <area_number>



Bugs.
=====
Day of the week abbreviation is in the language you've set in LOCALE.



Limits.
=======
- 1000 file max per area. If you have more than 1000 file into an area,
consider to split it. Is more difficult to list 1000 voices for a user.
- 400 file areas max. If you have more than areas, write me.



Enjoy.

Ciao
Felix

