AminetParse v1.0 © 1997 by Daniel J. Andrea II NOTE: This software is offered as GIFTWARE. If you like it, then you can send me something in payment of your choice (other programs, disks, computers, cars, etc.) at the address at the end of this document. No warranty of any kind is offered with this software or implied, or for suitability of purpose. It's use is entirely at your own risk. No fees can be charged for this software, other than the nominal fees for the cost of magnetic media and copying of the software onto that media, not to exceed the amount of US $5 for a disk containing this software. Copies of this software must include this documentation file for redistribution through Fred Fish or other similar software collections. What is it? =========== AminetParse is a small utility to parse Aminet RECENT or INDEX lists into Thor's file database. This is quite a bit faster than the arexx script supplied with Thor. I experimented quite a bit with the arexx script, but the best I could get with it was approximately 22 files added per second. AminetParse is quite fast. On my system, it reaches speeds in excess of 150 files added per second. In some cases I've seen it hit peaks of over 200 files per second! AminetParse requires Thor 2.3+ (at least ver 4 of bbsread.library) and AmigaOS 2.04+. Installation ============ Well, it's real simple. AminetParse is a cli-only program, and can be run from anywhere. Probably the best place would be in the bin sub-directory of Thor's main directory. Just copy it to wherever you want to run it from. Usage ===== Just type AminetParse in a shell and you'll get output like this: AminetParse 1.00 (06-Apr-97) © 1997 Daniel J. Andrea II Usage: AminetParse where is name of system to add files to is full path and name of INDEX/RECENT file All you need is the name of your System in Thor, as in EMail&News (that's mine), and the full path and name of the INDEX/RECENT file. For example: AminetParse EMail&News SYS:temp/INDEX will add the file INDEX from the drawer SYS:temp/ to the file database in the Thor system EMail&News. That's it! While AminetParse is running, you will get occasional status messages. First it will tell you whether this is a RECENT listing, such as daily or weekly, or a full INDEX. Then it will print out numbers periodically to show how many files have been processed. Whenever a file area is parsed that is not in the file database, it will automatically add it and print out a message that it did so. When it's finished, AminteParse will print out some statistics about the file parsing. Bugs ==== There are no known bugs at this time. If you find any, please contact me at the E-Mail address or Snail-Mail address below with bug reports. Be sure to include information on what other software was running and what kind of system you have. Bug fixes will be incorporated into AminetParse as soon as possible. History ======= v1.00 -- Initial release. Author ====== I can be contacted through Internet E-Mail at: dandrea@unix.tfs.net or through Snail-Mail at: Daniel J. Andrea II 1331 Metropolitan St. Leavenworth, KS 66048 U.S.A. To check up on AmineteParse development and other projects when they arise, point your web browser at http://www.tfs.net/~dandrea/ AminetParse was developed on a 25 MHz A3000 using SAS/C v6.57. Future ====== Well, at this point I'm not sure. Most likely I will be adding support for filtering of file areas similar to the Sortmail script's parsing. Other ideas depends on you, the user. Got an idea or improvement? Let me know and I'll see what I can do. Thanks ====== Special thanks to Petter Nilsen of the Thor team for help with my early version of AminetParse. I couldn't see the trees in the forest so to speak, and he helped me sort it out. Thanks, Petter!