[docs] xmldocs - docelic modified 4 files
docs at icdevgroup.org
docs at icdevgroup.org
Fri Aug 6 06:17:44 EDT 2004
User: docelic
Date: 2004-08-06 10:17:44 GMT
Modified: . Makefile TODO
Modified: bin refs-autogen
Modified: docbook html-common.xsl
Log:
- Makefile: exclude CVS directory from generated tarballs
- TODO: remove solved items
- bin/refs-autogen: support "clickable" See Also items
- docbook/html-common.xsl: Remove "Example <nr.>. " from titles of examples
Revision Changes Path
1.9 +3 -3 xmldocs/Makefile
rev 1.9, prev_rev 1.8
Index: Makefile
===================================================================
RCS file: /var/cvs/xmldocs/Makefile,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- Makefile 30 Jul 2004 16:21:42 -0000 1.8
+++ Makefile 6 Aug 2004 10:17:44 -0000 1.9
@@ -91,9 +91,9 @@
if test "$$p" != "CVS"; then \
if test -d "$$p"; then \
cp -a $$p ../$(OUTPUT)/files/; \
- tar cf ../$(OUTPUT)/files/$$p.tar $$p; \
- tar zcf ../$(OUTPUT)/files/$$p.tgz $$p; \
- tar jcf ../$(OUTPUT)/files/$$p.tbz2 $$p \
+ tar --exclude=CVS -cf ../$(OUTPUT)/files/$$p.tar $$p; \
+ tar --exclude=CVS -zcf ../$(OUTPUT)/files/$$p.tgz $$p; \
+ tar --exclude=CVS -jcf ../$(OUTPUT)/files/$$p.tbz2 $$p \
; fi \
; fi \
; done
1.3 +0 -14 xmldocs/TODO
rev 1.3, prev_rev 1.2
Index: TODO
===================================================================
RCS file: /var/cvs/xmldocs/TODO,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- TODO 4 Aug 2004 16:34:10 -0000 1.2
+++ TODO 6 Aug 2004 10:17:44 -0000 1.3
@@ -1,23 +1,9 @@
DOCUMENTATION SYSTEM:
-- Make items in the See Also section to appear as links to the
- appropriate items.
-- For reference pages, make Examples appear without the "Example XY"
- prefix.
-- See why each Example has weird characters around the example index number
- (it renders badly in manpages).
-- In bin/stattree, when extracting symbol context, also try to determine
- function name in question and print its name in Context header (along with
- filename/line number).
-- Make more use of docbook/catalog.xml
Long-term:
- Support using refs/<filename> with all the documentation for a symbol
instead of refs/<directory>/<files>.
-
-SUPPORT FILES:
-- Exclude CVS from tarballs (tutorial-phase?.* files)
-
DOCUMENTATION ITSELF:
- Resolve items from tmp/missing file. (You need to run 'make' in your tree
1.12 +14 -1 xmldocs/bin/refs-autogen
rev 1.12, prev_rev 1.11
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- refs-autogen 4 Aug 2004 17:40:44 -0000 1.11
+++ refs-autogen 6 Aug 2004 10:17:44 -0000 1.12
@@ -194,7 +194,20 @@
# Turn 'See Also' items to refentries
my @see_items = @{ $ag{'_see also'} };
- map {s/^(.+)$/<citerefentry><refentrytitle>$1<\/refentrytitle><manvolnum>7ic<\/manvolnum><\/citerefentry>/} @see_items;
+ map {
+ # XXX only if it's the symbol from same category, otherwise use
+ # olink to link between documents
+ if ( $autogenerated{$_} ) {
+ my $linktype = "link"; # the default, linking inside the same document
+ if ( $autogenerated{$_}{'_symbol type'} eq $ag{'_symbol type'} ) {
+ # Nothink
+ } else {
+ die "$_ and $ag{name} are not of the same type. Interlinking
+ between documents not supported yet.\n";
+ }
+ s/^(.+)$/<$linktype linkend='$1' role='html'><citerefentry><refentrytitle>$1<\/refentrytitle><manvolnum>7ic<\/manvolnum><\/citerefentry><\/$linktype>/
+ }
+ } @see_items;
$ag{'see also'} = join ", ", @see_items;
# Finally, set default values if they weren't overriden by real information
1.3 +9 -0 xmldocs/docbook/html-common.xsl
rev 1.3, prev_rev 1.2
Index: html-common.xsl
===================================================================
RCS file: /var/cvs/xmldocs/docbook/html-common.xsl,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- html-common.xsl 11 Jul 2004 23:58:18 -0000 1.2
+++ html-common.xsl 6 Aug 2004 10:17:44 -0000 1.3
@@ -8,5 +8,14 @@
<!-- <xsl:param name="glossary.auto.link">1</xsl:param> -->
+ <xsl:param name="local.l10n.xml" select="document('')"/>
+ <l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0">
+ <l:l10n language="en">
+ <l:context name="title">
+ <l:template name="example" text="%t"/>
+ </l:context>
+ </l:l10n>
+ </l:i18n>
+
</xsl:stylesheet>
More information about the docs
mailing list