[docs] xmldocs - docelic modified 3 files

[docs at icdevgroup.org]

User:      docelic
Date:      2004-07-21 20:51:58 GMT
Modified:  .        Makefile README
Modified:  bin      refs-autogen
Log:
- Makefile: make distclean is now quiet as it should be
- README: added a note on tmp/missing file
- bin/refs-autogen: ignore CVS directories

Revision  Changes    Path
1.6       +1 -1      xmldocs/Makefile


rev 1.6, prev_rev 1.5
Index: Makefile
===================================================================
RCS file: /var/cvs/xmldocs/Makefile,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- Makefile	21 Jul 2004 20:13:30 -0000	1.5
+++ Makefile	21 Jul 2004 20:51:57 -0000	1.6
@@ -113,7 +113,7 @@
 distclean: clean
 	-rm -rf $(LTMPDIR)
 	-rm -rf refs/*.xml
-	-for p in $(IC_VERSIONS); do rm cache/$$p/*; done
+	-for p in $(IC_VERSIONS); do rm cache/$$p/* 2>/dev/null; done
 
 
 # OLD



1.4       +6 -0      xmldocs/README


rev 1.4, prev_rev 1.3
Index: README
===================================================================
RCS file: /var/cvs/xmldocs/README,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- README	21 Jul 2004 20:13:30 -0000	1.3
+++ README	21 Jul 2004 20:51:57 -0000	1.4
@@ -176,6 +176,12 @@
 ** technical information), and then write the item documentation that
 ** includes all that information.
 
+** After you build the documentation, there will be a file named
+** tmp/missing autogenerated, and it will contain a list of symbols with all
+** the parts of the documentation they still miss for the item to be
+** considered complete. Clearing out this list is a priority;
+** given that the new system is so convenient and cool, you have no excuse ;-)
+
 
 Davor Ocelic, docelic at icdevgroup.org
 



1.2       +3 -3      xmldocs/bin/refs-autogen


rev 1.2, prev_rev 1.1
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- refs-autogen	21 Jul 2004 20:13:30 -0000	1.1
+++ refs-autogen	21 Jul 2004 20:51:57 -0000	1.2
@@ -129,7 +129,7 @@
 				if ( ! $ag{$field} ) {
 					if ( grep {/$field/} @mandatory) {
 						push @{ $invalid{$k} },
-							"Missing field '$field', using default";
+							"Missing field '$field', using unsuitable default";
 					}
 					$ag{$field} = $defaults{$field};
 				}
@@ -264,11 +264,11 @@
 	# From other file sets
 	} elsif (! length $file) { # all files
 		opendir INDIR, "refs/$name/" or do {
-			push @{ $invalid{$name} }, "Missing directory";
+			push @{ $invalid{$name} }, "Missing directory (all other errors follow from this)";
 			return;
 		};
 		while (my $fn = readdir INDIR) {
-			next if $fn =~ /^\./;
+			next if $fn =~ /^\.|^CVS$/;
 			next if $fn eq 'control';
 			open INF, "< refs/$name/$fn" or
 				die "Can't open refs/$name/$fn ($!)\n";