@database ListIt.guide @master DH3:LISTIT/ListIt.guide @$VER: @author "Larry Cloud" @(c) "1994" @remark Created with Heddley v1.1 (c) Edd Dumbill 1994 @node "Main" "ListIt Utility AmigaGuide Manual" Manual for ListIt 1.0 © Larry Cloud & Keith Townsend 1994 @{"     Introduction                        " link "1" 0} @{"     Requirements                        " link "6" 0} @{"     Why use ListIt?                     " link "2" 0} @{"     How do I configure ListIt?          " link "3" 0} @{"     What files are required?            " link "4" 0} @{"     Where can I get updates?            " link "5" 0} @{"     Bugreports and suggestions          " link "8" 0} @{"     Credits                             " link "9" 0} @{"     License                             " link "7" 0} @{"     History                             " link "10" 0} @{"     Future Plans                        " link "15" 0} @endnode @node "1" " Introduction " What is ListIt? --------------- ListIt is a utility which creates alternative File Lists, When used with included program @{"DIZLIST" link "16" 0} , it will create lists such as the type used with "Elite" type Bullitin Board Systems. Features include: a. The ability to create lists for all file areas. b. The ability to create colorized lists (GR1-9). c. Automatically creates any files (not included in the archive) which it needs for operation. d. Keeps track of what file areas have changed since last execution, so it doesn't have to do file areas that are unchanged. e. Creates filelists which include long and short descriptions. @endnode @node "2" " Why use ListIt ? " Why use ListIt instead of other similar programs? ------------------------------------------------- --- There ARE no other similar programs ;) --- It works! --- Fully supported by @{" LARRY CLOUD & KEITH TOWNSEND" link "11" 0} , @{" MEBBSNET © CSR Sites " link "12" 0} --- Extremely @{" CONFIGURABLE " link "3" 0} @endnode @node "3" " How do I configure ListIt? " How do I configure ListIt? -------------------------- ListIt is an AREXX © script for the MEBBSNET © BBS software. You must already have AREXX © @{"installed and running" link "13" 0} prior to attempting to run this door. It is NOT a door, however, as it runs independently of MEBBSNET. You will need to create a directory where ListIt will place the data files and catalogs. You can then put the ListIt program and icon in any directory that you wish. It can then be run from workbench or CLI. Next, open a shell, cd to wherever you put the files, and type LISTIT CONFIG and follow the instructions. Once you've configured it, you can put it in any script (LOGOFF, MIDNIGHT, etc.) and run it as many times as you want. It will only update files that have changed since last execution, skipping anything unchanged. The first time you run it, it will take a while! Be forewarned. Once that initial runthough is done, though, its lightning fast. RUNNING LISTIT Open a shell and type LISTIT. Or double click on its icon. Couldn't be simpler. @endnode @node "4" " What files are required? " Required Files -------------- All the files included in the archive are required. If you are installing this version as an UPGRADE, click this button @{"UPDATE INFO" link "14" 0} now, then return here. Be sure to @{"configure" link "3" 0} the door to customize the setup for your BBS. @endnode @node "5" " Updates " Updates To ListIt ----------------- You can get updates to this program at any @{"CSR Site" link "12" 0}. @endnode @node "6" " REQUIREMENTS " This program requires © Microsoft Windows. Just kidding! ListIt Requirements ------------------- MEBBSNET © 0.154 or higher AmigaDos © 2.04 or above AREXX © mebbsarexx.library 1.7 or higher RexxPlus libraries and utilities (included) FusList vers 2.10 or higher by Robert Walstrom @endnode @node "7" " LICENSE " This material is © Copyright 1994 by Larry Cloud & Keith Townsend -- All rights reserved. It may be distributed freely as long as the following restrictions are met: The distributor may charge a fee to recover distribution costs. The fee for diskette distribution should not be more than the cost to obtain the same diskette from Fred Fish. The distributor agrees to cease distributing the programs and data involved if requested to do so by the authors. You may copy and distribute verbatim copies of the program's executable code and documentation as you receive it, in any medium, provided that you conspicuously and appropriately publish only the original, unmodified program, with all copyright notices and disclaimers of warranty intact and including all the accompanying documentation, example files and anything else that came with the original. The author will not be liable for any damage arising from the failure of this program to perform as described, or any destruction of other programs or data residing on a system attempting to run the program. While I know of no damaging errors, the user of this program uses it at his or her own risk. This license agreement copied verbatim from Robert Wahlström's FUSAC © instructions. @endnode @node "8" " Bugreports and suggestions. " Bugreports and suggestions: --------------------------- Please send them to: Larry Cloud Kitt's Korner BBS 206-698-0515 24h 28000 baud USR Sportster Fido: 1:350/31.0 MaxNet 90:181/10 or Keith Townsend Ami-Madness!! Eglin AFB FL 904-243-4996 24h 28000 baud Modem Fido: 1:366/1968.0 MaxNet: 90:130/1.0 All Contacts can be made via MEBBS, MEBBS_TESTER, MEBBSNET_DEV echos (Mebbsnet support echos). Preferable echo is MEBBS or netmail. If you log on to Kitt's Korner, and choose the LEAVE FEEDBACK option, you can choose to leave feedback either to the sysop (Keith) or to Larry. Please ensure you leave messages FOR Larry TO Larry. On Keith's board, leave feedback to PHANTOM. PLEASE ensure that you give the version number of the ListIt you are using. I try to keep a copy of one version back. If you haven't got the latest version, get it from any @{"CSR Site" link "12" 0}, because I may have already fixed that bug you were going to report! @endnode @node "9" " Credits! " Thanks to: William Bowling - MEBBSNET author - If not for Bill you wouldn't be reading this. Its kind of hard to develop software for something that wouldn't exist if not for Bill. Keith Kittlesen - My roommate and best friend. He has put up with a lot from me and I owe him everything I have. He has stuck with me through thick or thin, seen a huge increase in his phonebill, and has put up with calls from people at all hours of the day & night. Thanks, bud (even if you DO look like Chris Petersen!) Keith Townsend - Keith did a large portion of this coding. Since I'm the one writing the docs, he deserves as much, if not more, credit for this program. I didn't think it could be done. He convinced me to keep at it and together, we did it. Thanks for having the faith, bud. Larry Cloud - For these outstanding docs ;) As stated above, Keith and I put a LOT of work into this. Hopefully someone will come up with a way to use it. I wrote a door in Arexx to use the output from this program, but its slow and limited. All MEBBSNET CSR's - Distribution All persons who have tested this and reported bugs so we could fix them YOU! For downloading this program and taking the time to RTFD! @endnode @node "10" " History " This is the first release, so there IS no history yet ;) @endnode @node "11" "Who ARE These Guys?!?" Larry Cloud is one of your MEBBSNET CSR's who is fluent in Arexx. Keith Townsend is his sidekick on the East Coast. Smart guys. @endnode @node "12" " CSR's " MEBBS Engineering and Software Support Information =*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*= Please contact the following persons for in-depth, reliable, responsive and courteous assistance. =*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*==*= Authorized MEBBSNet Customer Service Representatives Worldwide Last Update 05 September 1994 ------------------------------------------------------------------------- MEBBS E & S Customer Service, West Coast USA ( FidoNet 1:102/1011, MaxNet 90:180/11 ) MEBBS E & S Company Headquarters ATTN: W.C. Bowling 1742 Hanley Ave Simi Valley, CA. 93065-3744 Support BBS 805-522-4435 300 > 14.4k Baud (MicroCom v32b, v42b) -------------------------------------------------------------------------- MEBBS E & S Customer Service, SouthEastern USA (FidoNet 1:366/1968, Maxnet 90:130/0 MEDIEVAL_NET180:105/1968) Keith Townsend 601 Cherokee Road Eglin AFB, FL 32542 Ami-Madness!! BBS Line #1 904-243-4996 1200 > 28.8k Baud (Supra 28.8) ---------------------------------------------------------------------- MEBBS E & S Customer Service, NorthWestern USA ( FidoNet 1:350/31, MaxNet 90:181/10 ) Larry Cloud 399 Holly Leaf Lane Bremerton, WA 98310 Kitt's Korner BBS Line #1 206-698-0515 300 > 28.8k Baud (USR V.FC) Line #2 206-698-7760 300 > 14.4k Baud (USR DSHST) NO MAIL ---------------------------------------------------------------------- MEBBS E & S Customer Service, East Coast USA (FidoNet 1:275/119) Don Bruce 7930 East Glen Road Norfolk, VA 23505 Amiga Micro BBS Line #1 804-587-8661 1200 > 19.2k Baud (USR HST) Line #2 804-587-2594 1200 > 38.4k Baud (Supra v32bis) -------------------------------------------------------------------------- MEBBS E & S Customer Service, Germany (FidoNet 2:2465/20) Dieter Zimmermann Pestalozzistr. 37 D - 55450 Langenlonsheim M-A-M +49-6704-2765 -------------------------------------------------------------------------- MEBBS E & S Customer Service, Sweden (FidoNet 2:204/455) Stefan Von.straten Hantverkaregatan 50 602 30 Norrkoping Sweden Yggrazil BBS Line #1 009 46(0)11 164276 300 > 14.4k Baud (USR DS) Line #2 +46-11 107033 HST 14k4 V42Bis Line #3 +46-11 107033 Supra 14k4 V32Bis Line #4 +46-11 107069 2400 None -------------------------------------------------------------------------- MEBBS E & S Customer Service, Denmark (FidoNet 2:238/67) Tom Sandfeld Raadmands Boulevard 28 8900 Randers, Denmark Micro Amiga BBS Line #1 +4586437939 2400 > 14.4k Baud (USR DS) Line #2 +4586401535 2400 > 9600 (USR HST) Line #3 +4587100050 64000 Isdn -------------------------------------------------------------------------- MEBBS E & S Customer Service, Australia/New Zealand (Fidonet 3:633/351) Howard Alexander 4 Ranleigh Crt Moorabbin Vic. 3189 RatZ! BBS - Amiga User's Group +61-3-553-0305 300-9600 (V32) -------------------------------------------------------------------------- MEBBS E & S Customer Service, United Kingdom (FidoNet 2:2502/129) Jon Witty 9A Hardwick Street, Wharncliffe Street Kingston Upon Hull, East Yorkshire, HU5 3LU Metnet Triangle System BBS +44-0482-491752 (Voice and Board Helpline/Support Helpline) Line #1 +44-0482-442251 - 7 nodes on this number all at 2400 Line #2 +44-0482-449028 - Reserved for another fast rate line Line #3 +44-0482-473871 - V32bis. Line #4 +44-0482-491744 - 2400 Only -------------------------------------------------------------------------- Please use the CSR nearest to your location for information and file access. If you have any questions regarding the software, please have your CSR forward questions to William Bowling. @endnode @node "13" "Installing / Running Arexx" Installing Arexx ---------------- This door REQUIRES the use of AmigaDos 2.04 or higher. Since thats the case, AREXX should already be installed and running in our system, unless you specifically took it out of your startup scripts. If thats the case, see your AMIGADOS manual for instructions on re-installing AREXX on your system. This door will NOT work without the AREXX server being active. @endnode @node "14" "Update Info" What Has Changed In This Version? --------------------------------- This is the place to look to see what has changed in this door. Changes ------- 1.0 --- First release. Lets see how folks like it ;) If you have a problem with the ListIt, be sure to send in a @{"bug report" link "8" 0}. See @{"HISTORY" link "10" 0} for info on previous versions. @endnode @node "15" "Future info" What does the future hold for ListIT? ------------------------------------- We we were hoping that some enterprising programmer would write a door that would display TXT or GRX files instead of the standard file list output but still maintaining all the download features.. If we can achieve this we plan on make SEVERAL types of displays available and the ability to omit unwanted areas. Of course all this will be incorporated into ListIt if theres an interest. @endnode @node "16" "DIZLIST" DIZLIST is an include AREXX script which allows the BBS software to extract the FILE_ID.DIZ description files that seems to have become standard. The complete Docs to DIZLIST are in the file DIZ.CFG which should be placed in your MEBBSNET:CONGFILES directory. @endnode