[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