#### # # ##### #### # # ### #### ##### ### #### # # # # # # ## # # # # # # # # # ##### ##### # ## ##### #### ##### ##### ### # # # # # # ## # # # # # # # # #### # # ##### #### # # # # # # ##### # # #### Documents for CheckAreas v1.02 1. What is CheckAreas and how do I use it? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ CheckAreas is a program that checks your file areas for several errors: · Files that aren't the size that File.DAT says they are. This is checked for all files. · Files that don't have the correct comment (filenote). This is checked for all files. · Files that shouldn't be in a file directory. (Skip the following unless you're really interested...) If there is no special search path defined for an area, the FILE: directory is scanned and any file that isn't uploaded in the area (shown in online file listings) are reported, unless the file is either a .FD file description corresponding to a file in the area or one of the special files (File.DAT, Pointers.File, User.File or EnterArea.TXT). When a special search path is defined, the FILE: directory is scanned and any file that isn't either a .FD file description corresponding to a file in the area or one of the special files (File.DAT, Pointers.File, User.File or EnterArea.TXT). Then, the special search path is scanned, and any file that isn't uploaded in the area (shown in online file listings) is reported. If you set a global file search path (a path that can be used by ANY area) to a FILE: directory or a special search path, you may get lots of "false" reports. This is because CheckAreas assumes that only ONE area's files are present in those directories. You can use global file search paths that aren't equivalent to normal search paths without problems. · Files that are missing from a file directory. CheckAreas knows what directories to search, including global file search paths. · Missing .FD files. · Errors in Pointers.FILE (low pointer higher than lowest file number, high pointer lower than highest file number, error reading it). · .VAL files with no corresponding uploaded file (in validation areas). CheckAreas takes two parameters: AREAS : The areas that you want to list. VALAREAS : Your validation areas. In these areas, .VAL files won't be reported as extra files (unless there is no corresponding uploaded file). You can specify ranges of areas (xxx-yyy), and several areas/ranges (with spaces between them - then you need to quote the area list). The areas you specify don't have to exist - but they will be included IF they exist, and all other areas will be skipped. Examples: CheckAreas AREAS 1 CheckAreas AREAS "1 2 3 4 5" CheckAreas AREAS "1-5 120 318 20-48" VALAREAS 999 Everything is written to the standard output (the Shell window). If you want to create a log file, you can redirect the output: CheckAreas >Logs:CheckAreas.LOG [...] CheckAreas will NOT report differences between file information in File.DAT and in the .FD files. Those errors can easily be corrected by running "Freshen" regularly. I hope this little tool will be helpful. I certainly needed it - I found quite a few files that shouldn't have been in my file directories, and could delete a couple of megabytes of old versions of programs. 2. Program history ~~~~~~~~~~~~~~~~~~~ 2.1. CheckAreas 1.00, released 10-Mar-1993 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is the first version of CheckAreas to be released. 2.2. CheckAreas 1.01, released 20-Mar-1993 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ CheckAreas would choke on areas that had a zero byte File.DAT. Thanks to Per Salmi and Markus Hansson for reporting this. 2.3. CheckAreas 1.02, released 3-Apr-1993 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ CheckAreas no longer reports EnterArea.TXT files as "extra files". Thanks to whoever reported this (sorry, I forgot your name). New keyword, VALAREAS : Your validation areas. In these areas, .VAL files won't be reported as extra files (unless there is no corresponding uploaded file). I forgot to add the documents to the previous release. Sorry :) 3. Contacting the author ~~~~~~~~~~~~~~~~~~~~~~~~~ You can reach me in several ways: · By leaving a message on my BBS, Remote Control, +46-13-138113. · By writing netmail to Jonas Kvarnstrom, 2:204/418.0@FidoNet. · By writing e-mail to jk@augs.se. · By writing a message in DLG_CHAT. · By snailmail to Jonas Kvarnström, Gustav Adolfsgatan 2, 582 20 Linköping, Sweden. ALL suggestions (and donations :-)) are welcome! __ __/// \XX/ Freeware - © 1993 Jonas Kvarnström.