[docs] xmldocs - docelic modified 2 files

[docs at icdevgroup.org]

User:      docelic
Date:      2004-09-26 19:47:26 GMT
Modified:  bin      coup generic-autogen
Log:
Series of commits follows. All changes mostly in preparation for the new
and this-time-great Makefile with many enhancements.

- bin/generic-autogen:
  - REPLACES bin/glossary-autogen and is now more or less generic
    (will build glossary and howtos)

- bin/coup:
  - manage sources/ subdirectory. (cvs checkout or update of IC versions)

- bin/refs-autogen:
  - support for advanced options needed by new Makefile
  - provide -g to only build specific group (like, usertags, or uitags, ...)
  - provide -o xml|list to either build the .xml file, or only create
    tmp/<group>.list file with the list of all tags in this group.
    (Will be useful since you can't determine symbol's category by just
    looking at refs/*).
  - use --both to output both xml and list file (this is also the default,
    so this is mostly for internal use from Makefile).
  - if $verbose is not enabled, don't display warnings about tags
    going over max_contexts limit

Usage syntax in script headers; will worry about license notes in them
after the heat ;)

Revision  Changes    Path
1.2       +5 -0      xmldocs/bin/coup


rev 1.2, prev_rev 1.1
Index: coup
===================================================================
RCS file: /var/cvs/xmldocs/bin/coup,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- coup	26 Sep 2004 19:32:56 -0000	1.1
+++ coup	26 Sep 2004 19:47:26 -0000	1.2
@@ -1,5 +1,10 @@
 #!/usr/bin/perl
 
+# Manages your sources/ subdirectory inside xmldocs.
+# Automatically check-outs or updates source trees.
+# Run as: bin/coup REV, like bin/coup 5.2.0 or bin/coup cvs-head
+# bin/coup -u REV will run cvs update
+
 use warnings;
 use strict;
 use Fatal qw/chdir/;



1.2       +5 -0      xmldocs/bin/generic-autogen


rev 1.2, prev_rev 1.1
Index: generic-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/generic-autogen,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- generic-autogen	26 Sep 2004 19:32:56 -0000	1.1
+++ generic-autogen	26 Sep 2004 19:47:26 -0000	1.2
@@ -1,5 +1,10 @@
 #!/usr/bin/perl
 
+# Generic .xml generator
+# Currently builds glossary or howtos.
+# Invoke as: bin/generic-autogen NAME
+# (It creates NAME/NAME.xml with files from NAME/*)
+
 use warnings;
 use strict;