AGSDIR v1.0 coded by Gandalf/AEgis

AGSDIR allow you to add a header to all your description files. It is scanning
the desc files put in the dlpath.lst of each conf and create a header
according to a file you draw. A lot of macros are allowed (see below). It
isn't including the header into desc files, but only add a %path_to_the_header
line on the top, allowing to diplay the header when a user is viewing the
description file online.
It is an intelligent process, as by default it will only process desc files
newer than the header (if the header already exist). But if the header exist
and is newer than the desc file, it not scan if there is already a '%' line or
not. Force process to add it.
As it is a PPE, it is not as fast as an .EXE but it is quite acceptable, and
you are advised to use it a night event.
I didn't include the ablity to process the upload dir as it is a very changing
file and it would be a waste of speed to process it after every upload. And I
think it could be a nice crash reason in multitasking. Anyway if you need it,
just mail me, I would think about the problem.


Command line:

This allow you a very easy and interactive way to process your dir files.

/F:         force scan
/B:         create backup of desc files when adding the '%' line
            if agsdir fail to make a backup it will skip the desc file.
/A=[param]: areas to process
/C=[param]: confs to process
/D=[path]:  path of the description to use

	param can be:
		* a number
			ex: /C=4 : process conference number 3
		* an intervalle
			ex: /A=4-10 : process area number 4 to number 10
		* ALL parameter (default)
			ex: /A=ALL: process all areas

** THE COMMAND LINE OVERRIDE THE CONFIG PARAMETERS **

examples:

   agsdir /F /C=1 /A=4-10 /D=C:\PCB\PPE\AGSDIR\DESC1

	force process of areas 4 to 10 in conference 1 using DESC1 file

   agsdir /C=3-18 /B

	process of all areas in confs 3 to 18 and create backups.


Macro list

@NEWEST@    : newest file in area. 8 caracters
@OLDEST@    : latest file in area. 8 caracters
@VERSION@   : AGSDIR version. 3 caracters
@CONFNAME@  : conference name. 20 caracters. centered
@AREANAME@  : area name. 36 caracters. centered
@CONFNUM@   : conference number. 3 caracters. right justifed
@AREANUM@   : area number. 3 caracters. right justifed
@NUMFILES@  : number of files in area. 4 caracters. right justified
@SCANDATE@  : date of the scan
@SCANTIME@  : time of the scan
@BOARDNAME@ : name of the board as configured in cfg file
@TOTALSIZE@ : total size of area in bytes. 10 caracters. right justified


Note: this first version do not use the extended conf names coz I was lazzy. :)
New versions may include it. Mail me if you badly need it, I would add it.

improvments planned if enough time:
* extended conferences names.
* justification parameters (left, right, center).
* ability to add a footer.
* improving process speed.
* making a real exe :-)

Any suggestion is welcomed. Email me at christophe.yvon@ace.epita.fr or
contact me on fido 2:320/305 or SOAPNET 555:330/0