[docs] xmldocs - docelic modified 2 files

docs at icdevgroup.org docs at icdevgroup.org
Sun Nov 21 13:47:32 EST 2004


User:      docelic
Date:      2004-11-21 18:47:32 GMT
Modified:  bin      refs-autogen
Modified:  .        Makefile
Log:
It is now possible to output docs for up to a specified version.
That is, you can generate docs for 5.0.0 release, for 5.2.0 release, or
  for development branch.

To do this, run: TARGET_RELEASE="--last 5.2.0" make refxmls

For cvs-head included, either don't provide TARGET_RELEASE or
use --last cvs-head.

You don't have to remember this, I'll properly document it, this
is just to make you aware of the possibility :-)

Revision  Changes    Path
1.67      +7 -0      xmldocs/bin/refs-autogen


rev 1.67, prev_rev 1.66
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.66
retrieving revision 1.67
diff -u -r1.66 -r1.67
--- refs-autogen	15 Nov 2004 15:15:10 -0000	1.66
+++ refs-autogen	21 Nov 2004 18:47:32 -0000	1.67
@@ -42,6 +42,7 @@
 my $no_autodefs; # Generate autodefs.ent collection of entities by default
 my $autopath = "docbook/autorefs.ent";
 my %dups; # List of symbols names that are not unique
+my $last_path; # Last path we want docs generated for (say, 5.2.0).
 
 my @page_order = (qw/purpose default structure synopsis description structure example notes bugs/, "symbol type", "source", "author", "copyright", "see also");
 
@@ -52,6 +53,7 @@
 	"output|o=s" => \$output_spec,
 	"both|b!"    => \$output_both,
 	"noentities|noents!" => \$no_autodefs,
+	"last-path|last|lp=s" => \$last_path,
 )) { die "Error parsing options\n" }
 
 # Determine which stuff to output
@@ -323,6 +325,11 @@
 			$$ag{"ctxs shown"} = $ctxshown < $max_ctxs ? $ctxshown : $max_ctxs;
 		}
 	}
+
+	# If this is the last one we want (so, manual break), then stop here.
+	# This is for cases where you want to generate docs for say, 5.2.0 and not
+	# always cvs-head
+	last if $last_path and $last_path eq $path;
 }
 
 ### THIS IS LAST RUN (Split in multiple loops to avoid chicken-and-egg problem)###



1.45      +3 -3      xmldocs/Makefile


rev 1.45, prev_rev 1.44
Index: Makefile
===================================================================
RCS file: /var/cvs/xmldocs/Makefile,v
retrieving revision 1.44
retrieving revision 1.45
diff -u -r1.44 -r1.45
--- Makefile	20 Nov 2004 14:40:39 -0000	1.44
+++ Makefile	21 Nov 2004 18:47:32 -0000	1.45
@@ -26,7 +26,7 @@
 PSR_FLAGS   = --xinclude
 
 VPATH       = guides refs howtos glossary
-#.SILENT:
+.SILENT:
 .PHONY: all complete
 .PHONY: skel
 .PHONY: guides howtos symbols glossary
@@ -42,7 +42,7 @@
 # Complete build
 all: $(foreach icver,$(IC_VERSIONS),cache/$(icver)/.cache.bin) \
   skel refxmls olinks-nc olinks-c                              \
-  guides howtos symbols glossary
+  glossary howtos guides symbols
 
 guides:   $(foreach doc,$(GUIDES),$O/$(doc).html  )            \
           $(foreach doc,$(GUIDES),$O/$(doc))
@@ -196,7 +196,7 @@
 $T/%.list refs/%.xml: $(foreach icver,$(IC_VERSIONS),cache/$(icver)/.cache.bin) $(shell find refs/ -regex '.+[^(\.xml)]$$') bin/refs-autogen
 	# PEH, -g is useless since tags migrate between tag groups
 	#bin/refs-autogen -g $(FNAME) -o $@ $(BOTH) $(IC_VERSIONS)
-	bin/refs-autogen -o $@ $(BOTH) $(IC_VERSIONS)
+	bin/refs-autogen -o $@ $(BOTH) $(TARGET_RELEASE) $(IC_VERSIONS)
 
 
 #############################################################








More information about the docs mailing list