[docs] xmldocs - docelic modified 2 files

[docs at icdevgroup.org]

User:      docelic
Date:      2004-11-06 18:24:36 GMT
Modified:  .        Makefile TODO
Log:
- Makefile:
 - remove --nonet XSLT processor flag; we want to play by the rules
 - improve perl oneliner from last commit which replaced 'tail +2'

- TODO: items

Profiling now works, although it's not supported by Makefile.
We'll use profiling for:
  1) online examples
  2) documentation tailored to specific interchange package (tarball,
     .deb, .rpm etc..)

We will use two profiling fields which are already defined in docbook:
  1) <example  condition='online'> for online examples
  2) <anything vendor='rh|deb|tarball|...'> for distro-specific includes

Revision  Changes    Path
1.38      +3 -3      xmldocs/Makefile


rev 1.38, prev_rev 1.37
Index: Makefile
===================================================================
RCS file: /var/cvs/xmldocs/Makefile,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- Makefile	6 Nov 2004 17:37:01 -0000	1.37
+++ Makefile	6 Nov 2004 18:24:36 -0000	1.38
@@ -23,7 +23,7 @@
 
 # XSLT processor-specific
 PSR         = xsltproc
-PSR_FLAGS   = --xinclude --nonet
+PSR_FLAGS   = --xinclude
 
 VPATH       = guides refs howtos glossary
 .SILENT:
@@ -100,14 +100,14 @@
 	  --stringparam collect.xref.targets only                         \
 	  --stringparam targets.filename $@                               \
 	  docbook/html-nochunks.xsl $<
-	  perl -ni -e'print if $$. > 1 or $$.==1 and !/^<!DOCTYPE/' $@
+	  perl -ni -e'print unless $$.==1 and /^<!DOCTYPE/' $@
 olinkdbs-c olinks-c: $(foreach f,$(ALL_DOCS),$T/$f-c.db)
 $T/%-c.db: %.xml $T
 	$(PSR) $(PSR_FLAGS)                                               \
 	  --stringparam collect.xref.targets only                         \
 	  --stringparam targets.filename $@                               \
 	  docbook/html-chunks.xsl $<
-	  perl -ni -e'print if $$. > 1 or $$.==1 and !/^<!DOCTYPE/' $@
+	  perl -ni -e'print unless $$.==1 and /^<!DOCTYPE/' $@
 
 
 #############################################################



1.44      +0 -6      xmldocs/TODO


rev 1.44, prev_rev 1.43
Index: TODO
===================================================================
RCS file: /var/cvs/xmldocs/TODO,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- TODO	6 Nov 2004 01:06:46 -0000	1.43
+++ TODO	6 Nov 2004 18:24:36 -0000	1.44
@@ -20,10 +20,6 @@
 - Double-linked SeeAlso doesn't work. ConfigAllBefore points to ConfigAllAfter,
   but the latter doesn't return love.
 
-- Switch to double-pass document generation. This will make PROPER
-  <glossterm> links work again and will allow for profiles which we must
-  have (for online examples etc..).
-
 - In iccattut:
   - make a "translation map" of /etc/interchange/* to RPM-equivs.
   - item for package names, like interchange-cat-foundation, wenglish, etc..
@@ -79,8 +75,6 @@
 
 
  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, or wiki?)..