[docs] xmldocs - docelic modified 4 files

[docs at icdevgroup.org]

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>