[docs] xmldocs - docelic modified 6 files
docs at icdevgroup.org
docs at icdevgroup.org
Fri Aug 6 10:00:56 EDT 2004
User: docelic
Date: 2004-08-06 14:00:55 GMT
Modified: . Makefile TODO
Modified: bin refs-autogen
Modified: refs/MV_MAILFROM notes
Added: docbook olinkdb-c.xml olinkdb-nc.xml
Log:
- Makefile:
- Added olinkdb targets
- restructured a bit
- TODO: added an item
- docbook/olinkdb-{c,nc}.db: OlinkDB sitemaps for chunked and unchunked outputs
- bin/refs-autogen: with olinkdb help, now properly links between both
in-document and external See Also items!
- refs/MV_MAILFROM/notes: made the note more understandable
Revision Changes Path
1.11 +43 -22 xmldocs/Makefile
rev 1.11, prev_rev 1.10
Index: Makefile
===================================================================
RCS file: /var/cvs/xmldocs/Makefile,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- Makefile 6 Aug 2004 11:26:47 -0000 1.10
+++ Makefile 6 Aug 2004 14:00:54 -0000 1.11
@@ -23,14 +23,14 @@
.PHONY: all guides refs %.man
-all: guides refs
+all: tmp/refs-autogen tmp/olinkdbs guides refs
echo 'all' done
guides: $(OUTPUT)/images $(OUTPUT)/files \
$(patsubst guides/%.xml,OUTPUT/%.html,$(wildcard guides/*.xml)) \
$(patsubst guides/%.xml,OUTPUT/%,$(wildcard guides/*.xml))
-refs: tmp/refs-autogen $(OUTPUT)/images $(OUTPUT)/files
+refs: $(OUTPUT)/images $(OUTPUT)/files
make $(OUTPUT)/pragmas.html $(OUTPUT)/pragmas $(OUTPUT)/pragmas.man
make $(OUTPUT)/globvars.html $(OUTPUT)/globvars $(OUTPUT)/globvars.man
@@ -43,7 +43,7 @@
$(OUTPUT)/%.html: %.xml $(OUTPUT)/xmldocs.css
$(XSLT) $(XSLT_FLAGS) \
--stringparam current.docid $* \
- --stringparam target.database.document ../docbook/olinkdb.xml \
+ --stringparam target.database.document ../docbook/olinkdb-nc.xml \
-o $@ docbook/html-nochunks.xsl $<
# Man pages
@@ -58,21 +58,57 @@
$(OUTPUT)/%: %.xml $(OUTPUT)/xmldocs.css
$(XSLT) $(XSLT_FLAGS) \
--stringparam current.docid $* \
- --stringparam target.database.document ../docbook/olinkdb.xml \
+ --stringparam target.database.document ../docbook/olinkdb-c.xml \
-o $@/ docbook/html-chunks.xsl $<
touch $@
+
+#
+# OlinkDBs
+#
+# OlinkDB information for unchunked parts
+#tmp/olinkdbs: $(LTMPDIR) \
+# $(patsubst guides/%.xml,$(LTMPDIR)/%-c.db,$(wildcard guides/*.xml)) \
+# $(patsubst guides/%.xml,$(LTMPDIR)/%-nc.db,$(wildcard guides/*.xml)) \
+# $(patsubst refs/%.xml,$(LTMPDIR)/%-c.db,$(wildcard refs/*.xml)) \
+# $(patsubst refs/%.xml,$(LTMPDIR)/%-nc.db,$(wildcard refs/*.xml))
+# touch tmp/olinkdbs
+tmp/olinkdbs: $(LTMPDIR)
+ make $(patsubst guides/%.xml,$(LTMPDIR)/%-c.db,$(wildcard guides/*.xml))
+ make $(patsubst guides/%.xml,$(LTMPDIR)/%-nc.db,$(wildcard guides/*.xml))
+ make $(patsubst refs/%.xml,$(LTMPDIR)/%-c.db,$(wildcard refs/*.xml))
+ make $(patsubst refs/%.xml,$(LTMPDIR)/%-nc.db,$(wildcard refs/*.xml))
+ touch tmp/olinkdbs
+
+$(LTMPDIR)/%-nc.db: %.xml $(LTMPDIR)
+ $(XSLT) $(XSLT_FLAGS) \
+ --stringparam collect.xref.targets only \
+ --stringparam targets.filename $@ \
+ docbook/html-nochunks.xsl $<
+ tail +2 $@ > $(LTMPDIR)/tail
+ mv $(LTMPDIR)/tail $@
+
+# OlinkDB information for chunked parts
+$(LTMPDIR)/%-c.db: %.xml $(TMPDIR)
+ $(XSLT) $(XSLT_FLAGS) \
+ --stringparam collect.xref.targets only \
+ --stringparam targets.filename $@ \
+ docbook/html-chunks.xsl $<
+ tail +2 $@ > $(LTMPDIR)/tail
+ mv $(LTMPDIR)/tail $@
+
+
#
# Support targets
#
-tmp/mkreport: $(LTMPDIR)
+mkreport: tmp/mkreport $(LTMPDIR)
./bin/mkreport $(IC_VERSIONS)
- touch $@
+ touch tmp/mkreport
tmp/refs-autogen: $(LTMPDIR) bin/refs-autogen
./bin/refs-autogen $(IC_VERSIONS)
- touch $@
+ touch tmp/refs-autogen
$(OUTPUT): $(LTMPDIR)
mkdir -p $(OUTPUT)
@@ -131,21 +167,6 @@
# OLD
#
-# OlinkDBs
-#
-# OlinkDB information for unchunked parts
-#$(LTMPDIR)/%-nc.db: %.xml $(LTMPDIR)
-# $(XSLT) $(XSLT_FLAGS) \
-# --stringparam collect.xref.targets only \
-# --stringparam targets.filename $@ \
-# docbook/html-nochunks.xsl $<
-#
-## OlinkDB information for chunked parts
-#$(TMPDIR)/%-c.db: %.xml $(TMPDIR)
-# $(XSLT) $(XSLT_FLAGS) \
-# --stringparam collect.xref.targets only \
-# --stringparam targets.filename $@ \
-# docbook/html-chunks.xsl $<
#
#
## TODO Make target that conveniently checks out all IC releases from CVS
1.4 +14 -1 xmldocs/TODO
rev 1.4, prev_rev 1.3
Index: TODO
===================================================================
RCS file: /var/cvs/xmldocs/TODO,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- TODO 6 Aug 2004 10:17:44 -0000 1.3
+++ TODO 6 Aug 2004 14:00:54 -0000 1.4
@@ -1,10 +1,23 @@
DOCUMENTATION SYSTEM:
+ Mid-term:
+- Think about adding "online example" (role=html in combination with
+ a flag that says if html is to be static or for hosting on IC-enabled site)
+- for "online" docs, also provide a form where users can add comments or
+ ask for clarification. (this could be done with either pure IC (forum?), or
+ XML forms capability)..
+- filenames in Source contexts should also be clickable
+
Long-term:
- Support using refs/<filename> with all the documentation for a symbol
instead of refs/<directory>/<files>.
DOCUMENTATION ITSELF:
- Resolve items from tmp/missing file. (You need to run 'make' in your tree
- first, to get that file generated).
+ first, to get that file generated). I did what I could, now the list only
+ contains items which don't even exist in the old docs, so I can't copy/paste;
+ someone who is able to write the description/examples from scratch should
+ do that.
+
+
1.14 +19 -11 xmldocs/bin/refs-autogen
rev 1.14, prev_rev 1.13
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- refs-autogen 6 Aug 2004 11:26:47 -0000 1.13
+++ refs-autogen 6 Aug 2004 14:00:54 -0000 1.14
@@ -196,20 +196,28 @@
# Turn 'See Also' items to refentries
my @see_items = @{ $ag{'_see also'} };
- map {
- # XXX only if it's the symbol from same category, otherwise use
- # olink to link between documents
- if ( $autogenerated{$_} ) {
+ # XXX only if it's the symbol from same category, otherwise use
+ # olink to link between documents
+ for my $itm ( @see_items ) {
+ if ( $autogenerated{$itm} ) {
my $linktype = "link"; # the default, linking inside the same document
- if ( $autogenerated{$_}{'_symbol type'} eq $ag{'_symbol type'} ) {
- # Nothink
+ my $linkarg = "linkend";
+ if ( $autogenerated{$itm}{'_symbol type'} eq $ag{'_symbol type'} ) {
+ # Nothing, just use link linkend= if the targets are inside the same
+ # document.
} else {
- die "$_ and $ag{name} are not of the same type. Interlinking
- between documents not supported yet.\n";
+ # If they're not, find appropriate external document to link to
+ for my $sect ( keys %symbol_lists ) {
+ if ( grep {/^$itm$/} @{ $symbol_lists{$sect} } ) {
+ $linktype = "olink";
+ $linkarg = "targetdoc='${sect}s' targetptr";
+ }
+ }
}
- s/^(.+)$/<$linktype linkend='$1' role='html'><citerefentry><refentrytitle>$1<\/refentrytitle><manvolnum>7ic<\/manvolnum><\/citerefentry><\/$linktype>/
+ # Now that $linktype and $linkarg are set, make the link/citerefentry
+ $itm =~ s/^(.+)$/<$linktype $linkarg='$1'><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
@@ -246,7 +254,7 @@
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DocBook-Interchange XML V4.2//EN"
"../docbook/docbookxi.dtd">
-<reference id="$k">
+<reference id="${k}s">
<title>Interchange Reference Pages: $longname{$k}s</title>
ENDD
1.2 +1 -1 xmldocs/refs/MV_MAILFROM/notes
rev 1.2, prev_rev 1.1
Index: notes
===================================================================
RCS file: /var/cvs/xmldocs/refs/MV_MAILFROM/notes,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- notes 28 Jul 2004 20:53:39 -0000 1.1
+++ notes 6 Aug 2004 14:00:55 -0000 1.2
@@ -1 +1 @@
-If present, this variable overrides the MailOrdersTo config directive.
+If this variable is not defined, the MailOrdersTo config value is used in place.
1.1 xmldocs/docbook/olinkdb-c.xml
rev 1.1, prev_rev 1.0
Index: olinkdb-c.xml
===================================================================
<?xml version="1.0"?>
<!DOCTYPE targetset
SYSTEM "/usr/share/xml/docbook/stylesheet/nwalsh/common/targetdatabase.dtd" [
<!ENTITY iccattut SYSTEM "../tmp/iccattut-c.db">
<!ENTITY pragmas SYSTEM "../tmp/pragmas-c.db">
<!ENTITY globvars SYSTEM "../tmp/globvars-c.db">
]>
<targetset>
<targetsetinfo>
Interchange XML Documentation System Sitemap
</targetsetinfo>
<sitemap>
<dir name="OUTPUT">
<dir name='iccattut'>
<document targetdoc="iccattut">
&iccattut;
</document>
</dir>
<dir name='pragmas'>
<document targetdoc="pragmas">
&pragmas;
</document>
</dir>
<dir name='globvars'>
<document targetdoc="globvars">
&globvars;
</document>
</dir>
</dir>
</sitemap>
</targetset>
1.1 xmldocs/docbook/olinkdb-nc.xml
rev 1.1, prev_rev 1.0
Index: olinkdb-nc.xml
===================================================================
<?xml version="1.0"?>
<!DOCTYPE targetset
SYSTEM "/usr/share/xml/docbook/stylesheet/nwalsh/common/targetdatabase.dtd" [
<!ENTITY iccattut SYSTEM "../tmp/iccattut-nc.db">
<!ENTITY pragmas SYSTEM "../tmp/pragmas-nc.db">
<!ENTITY globvars SYSTEM "../tmp/globvars-nc.db">
]>
<targetset>
<targetsetinfo>
Interchange XML Documentation System Sitemap
</targetsetinfo>
<sitemap>
<dir name="OUTPUT">
<document targetdoc="iccattut" baseuri="iccattut.html"> &iccattut; </document>
<document targetdoc="pragmas" baseuri="pragmas.html"> &pragmas; </document>
<document targetdoc="globvars" baseuri="globvars.html"> &globvars; </document>
</dir>
</sitemap>
</targetset>
More information about the docs
mailing list