[ibis-macro] macro library documentation

  • From: "Mike LaBonte (milabont)" <milabont@xxxxxxxxx>
  • To: <ibis-macro@xxxxxxxxxxxxx>
  • Date: Mon, 21 Nov 2005 11:31:04 -0500

The attached zip file has Arpad's latest VA and VHD macro library files
with documentation comments added. There is an XML file containing the
documentation info, and a PERL script for moving comments from one file
type to another. The script can:
 
o Copy comment blocks from a VA file to an XML file
o Annotate comment blocks from a XML file into a VA file
o Annotate comment blocks from a XML file into a VHD file
o Remove comment blocks from a VA or VHD file
 
The script produces the module listing at the top of the file and
inserts comment blocks before each module. It's a little asymmetric in
that it does not have the ability to make XML from VHD, but I don't
think that will hurt us. There is some error checking along the way. For
example there are warnings if the order of terminals does not match when
comparing a module definition with it's comments. It makes backups of
files before changing them, just in case.
 
The script prints usage info when run with no arguments.
 
Mike

Other related posts:

  • » [ibis-macro] macro library documentation