KBGfileGenerator v1.0 ~~~~~~~~~~~~~~~~~~~~~~~ by Kasper B. Graversen ~~~~~~~~~~~~~~~~~~~~~ NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE The author cannot be held liable for the suitability or accuracy of this manual and/or the program it describes. Any damage directly or indirectly caused by the use or misuse of this manual and/or the program(s) it describes is the sole responsibility of the user her/him self. KBGfileGenerator, (c) Copyright 1994, Kasper B. Graversen. All rights reserved. This program is ShareWare, so donations ARE required. You may use this program for 14 days after that you MUST either pay the registration fee or delete the program again! This program may be freely distributed, as long as all documentation and executable remain unchanged, and are included with the distribution. Also no profit is to be made by selling this program (except a small copy fee of max. $2) YAWN - Yet another doc-file.. hmm I'mm make it short this time! .-) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTRODUCTION. ~~~~~~~~~~~~~ This is a filelist generator for the MAXs BBs system. It has been tested on v1.52 and v1.54 and should work older versions also. When registered it is (what I believe) the best filelist generator for the MAXs BBs system! USAGE. ~~~~~~ At first KBGfileGenerator may seem a bit heavy to work with because of all the parameters, But it was designed to be activated from a script so it really isn't that bad.. :) The template is as follows: KBGfileGenerator ALL [file.data-file] [area-file] [output-file] ALL - Is a flag to be set so KBGfileGenerator know what type of filelist to generate. In the unregistered version you can only generate one type of filelist though. file.date-file - This is the filename of the file "file.data" MAXs' is creating. But you should not only write the name, but the whole path. In my case it's "bbs:files/file.data" area-file - KBGfileGenerator needs an area file telling it the names of the different file areas. output-file - Here you specify the outputfile + path. Eg. "T:filelist.txt". The Area file. ~~~~~~~~~~~~~~ The Areafile is a simple ASCII file. It contains the names of the different areas on your BBs. Each line contains the name of the equivalent file area (section). In other words - If you write "free files" on line 1 and you generate a filelist, and have some files in section one, the file area will be named Free files in your file list. To edit the area file you can use an ordinary fileeditor, but remember that the areafile must contain 99 lines, if you start deleting "empty area numbers" the file area names in the file list will screew up! So if you haven't got any files in section 10 and 11 but in 9 and 12, just let the numbers "10" and "11" be where they are. You can make some nice filelists by adding some ansi in the area names - try it! Eg. you can make the areanames in one colour and the filenames in another by writing: (ansi code col2) free files (ansi code col3) By doing so the area names will be colour 2, while the filenames will be colour 3. You could specify different ansi colour codes after the area name so your filelist could contain all the colours of the rainbow :-) SCRIPT. ~~~~~~~ Here is the script I execute every time I'm updating my filelist. bbs:kbgfilegenerator ALL bbs:files/file.data bbs:kbgfilegenerator.areas t:filelist.txt delete bbs:files/freefiles/filelist.txt copy t:filelist.txt bbs:files/freefiles/filelist.txt delete bbs:files/freefiles/filelist.lha lha a bbs:files/freefiles/filelist.lha t:filelist.txt delete t:filelist.txt Simple, eh? :-) GOODIES. ~~~~~~~~ I've kept some goodies for the registered users: + You can specify which file areas that should not be in the filelist (eg. SYSOP FILES, MEMBERS ONLY etc. etc.) + You can make a filelist containing files that are up to n days old. n is a number you specify when you run KBGfileGenerator - Now it's no problem making filelist covering the last 7 days files. + You can make a list of files that are not yet published. This was Rene Jensen's idea, thanx.. it's really useful! + KBGfileGenerator will put a * after all files that are less than 30 days old. This will make the output like this: PT315.lha 96989 * [00] 01-09-94 ProTracker v3.15 aga instead of: PT315.lha 96989 [00] 01-09-94 ProTracker v3.15 aga REGISTERING. ~~~~~~~~~~~~ The prices. 40 Dkr (KBGfileGenerator) (40 Dkr = 10 DM) 5 Dkr (for a brand new 3.5" floppy disc) 6 Dkr (postage for people living in Scandinavia) 10 Dkr (postage for people living in Europe) 12 Dkr (postage for people living outside Europe) I prefer danish money, but accept foreign currencies aswell. If you pay with a foreign currency please add a some extra cash to cover some of the exchange fees I have to pay in the bank. You can send your money to me by mail at this address, but REMEMBER it is on your OWN risk. I can not in any way be responsible for lost letters! Kasper B. Graversen Sandhoej 9 5700 Svendborg Denmark E-mail: 2:237/15.48 (FidoNet) 39:141/105.60 (AmigaNet) You can also reach me on my hotline phone: (+45) 62 21 64 74 You can also send the money in a more secure way.. through your bank. Transfer your money to: Svendborg Sparekasse Centrumpladsen 19 5700 Svendborg Denmark Name: Kasper B. Graversen. reg. nr: 0844 account nr: 815-57-28982 If you live in Denmark or you got a free phone you can save some money by collecting the registered version of KBGfileGenerator at my BBs! TO DO. ~~~~~~ I've got some few things in my TODO list. + You can add an ASCII file automatically in the filelist, with eg. a message telling that the filelist is is the filelist for YOUR BBs. + Add some more statistics. + YOUR ideas... These things will NOT be implemented in KBGfileGenerator unless I see some response from users. So please support me! I've also done some postcardware programs, so it's not profit all of it! I've spent HOURS doing this one and some of the code has been used in some other MAX utils I'm working on now... ps: ~~~ I myself got an A1200, but even though I've got a 020 in my machine I've only put a 000 version in this archive because there really weren't much difference in speed - so why double the size of the archive when it really doesn't matter? C ya m8 - Kasqer..