[interchange-docs] xmldocs - docelic modified 17 files

docs at icdevgroup.org docs at icdevgroup.org
Sat Aug 18 17:33:40 EDT 2007


User:      docelic
Date:      2007-08-18 21:33:40 GMT
Modified:  .        Makefile TODO
Modified:  bin      refs-autogen
Modified:  docbook  html-chunks.xsl html-nochunks.xsl olinkdb-c.xml
Modified:           xmldocs.css
Modified:  glossary DSN
Modified:  guides   index.xml
Modified:  refs     SQLDSN commify.filter crypt.filter date2time.filter
Modified:           date_change.filter lc.filter md5.filter
Modified:           yesno.filter
Log:
* Larger commit moving us towards "online docs"
  (Changes to Makefile, bin/refs-autogen, docbook/*)

* docbook/*:
  (Part of changes related to online docs, part should fix the
  broken links issue we had).

* Small update to stylesheet: put legalnotice and copyright blocks
  font size to 70%

* guides/index.html
  Some changes to the index page related to online viewing

* refs/*:
  Little fixes I've spotted along the way

Revision  Changes    Path
1.90      +32 -31    xmldocs/Makefile


rev 1.90, prev_rev 1.89
Index: Makefile
===================================================================
RCS file: /var/cvs/xmldocs/Makefile,v
retrieving revision 1.89
retrieving revision 1.90
diff -u -r1.89 -r1.90
--- Makefile	5 Jul 2007 20:06:53 -0000	1.89
+++ Makefile	18 Aug 2007 21:33:39 -0000	1.90
@@ -19,6 +19,7 @@
 ALL_DOCS    = $(GLOSSARY) $(HOWTOS) $(GUIDES) $(SYMBOL_TYPES)
 SHELL       = /bin/sh
 OUTPUT     ?= -std
+PROFILE    ?= "--stringparam profile.condition standard"
 export O    = OUTPUT$(OUTPUT)
 export T    = tmp
 export XCF  = docbook/catalog.xml
@@ -26,7 +27,7 @@
 
 # XSLT processor-specific
 PSR         = xsltproc
-PSR_FLAGS   = --xinclude
+PSR_FLAGS   = --xinclude --nonet
 
 # Scripts and options
 REFS_AUTOGEN = bin/refs-autogen
@@ -155,19 +156,19 @@
 	  --stringparam current.docid $*                                   \
 	  --stringparam target.database.document ../docbook/olinkdb-c.xml \
 	  -o $@/ docbook/html-chunks.xsl $T/$*-c.profiled
-OUTPUT/%.man: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
-	echo "C     $@/"
-	mkdir -p "$@"
-	$(PSR) $(PSR_FLAGS)                                                \
-	  $(PROFILE)                                                       \
-	  --stringparam current.docid $*                                   \
-	  --stringparam target.database.document ../docbook/olinkdb-nc.xml \
-	  -o $T/$*-c.profiled docbook/profile.xsl $<
-	$(PSR) $(PSR_FLAGS)                                                \
-	  $(PROFILE)                                                       \
-	  --stringparam current.docid $*                                   \
-	  --stringparam target.database.document ../docbook/olinkdb-nc.xml \
-	  -o $@/ docbook/reference.xsl $T/$*-c.profiled
+#OUTPUT/%.man: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
+#	echo "C     $@/"
+#	mkdir -p "$@"
+#	$(PSR) $(PSR_FLAGS)                                                \
+#	  $(PROFILE)                                                       \
+#	  --stringparam current.docid $*                                   \
+#	  --stringparam target.database.document ../docbook/olinkdb-nc.xml \
+#	  -o $T/$*-c.profiled docbook/profile.xsl $<
+#	$(PSR) $(PSR_FLAGS)                                                \
+#	  $(PROFILE)                                                       \
+#	  --stringparam current.docid $*                                   \
+#	  --stringparam target.database.document ../docbook/olinkdb-nc.xml \
+#	  -o $@/ docbook/reference.xsl $T/$*-c.profiled
 #OUTPUT/%.pdf: tmp/%.latex
 #	echo "C     $@"
 #	pdflatex $<
@@ -177,23 +178,23 @@
 
 #############################################################
 # Supporting target - LATEX output
-tmp/%.latex: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
-	$(PSR) $(PSR_FLAGS)                                                \
-	  $(PROFILE)                                                       \
-	  --stringparam current.docid $*                                   \
-	  --stringparam target.database.document ../docbook/olinkdb-nc.xml \
-	  -o $T/$*-nc.profiled docbook/profile.xsl $<
-	$(PSR) $(PSR_FLAGS)                                                \
-	  $(PROFILE)                                                       \
-	  --stringparam current.docid $*                                   \
-	  --stringparam target.database.document ../docbook/olinkdb-nc.xml \
-	  --stringparam paper.type A4                                      \
-	  --stringparam page.orientation portrait                          \
-	  --stringparam double.sided 1                                     \
-	  --stringparam chapter.autolabel 0                                \
-	  --stringparam appendix.autolabel 0                               \
-	  --stringparam section.autolabel 0                                \
-	  -o $T/$*.latex docbook/latex.xsl $T/$*-nc.profiled
+#tmp/%.latex: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
+#	$(PSR) $(PSR_FLAGS)                                                \
+#	  $(PROFILE)                                                       \
+#	  --stringparam current.docid $*                                   \
+#	  --stringparam target.database.document ../docbook/olinkdb-nc.xml \
+#	  -o $T/$*-nc.profiled docbook/profile.xsl $<
+#	$(PSR) $(PSR_FLAGS)                                                \
+#	  $(PROFILE)                                                       \
+#	  --stringparam current.docid $*                                   \
+#	  --stringparam target.database.document ../docbook/olinkdb-nc.xml \
+#	  --stringparam paper.type A4                                      \
+#	  --stringparam page.orientation portrait                          \
+#	  --stringparam double.sided 1                                     \
+#	  --stringparam chapter.autolabel 0                                \
+#	  --stringparam appendix.autolabel 0                               \
+#	  --stringparam section.autolabel 0                                \
+#	  -o $T/$*.latex docbook/latex.xsl $T/$*-nc.profiled
 
 
 #############################################################



1.103     +4 -1      xmldocs/TODO


rev 1.103, prev_rev 1.102
Index: TODO
===================================================================
RCS file: /var/cvs/xmldocs/TODO,v
retrieving revision 1.102
retrieving revision 1.103
diff -u -r1.102 -r1.103
--- TODO	9 Jul 2007 11:11:45 -0000	1.102
+++ TODO	18 Aug 2007 21:33:39 -0000	1.103
@@ -1,5 +1,8 @@
 Bugs:
-u CVS listi, da je fajl nejm link na CVS 
+- on online docs, mention that obsolete examples are obsolete, 
+  provide search box, provide static files for download, 
+	describe keys like alt+n
+- u CVS listi, da je fajl nejm link na CVS 
 - documentation for bounce and restrict is ignored
 - some small error in glossary/pragma at the bottom, [tag pragma]0[/tag]
 



1.118     +15 -17    xmldocs/bin/refs-autogen


rev 1.118, prev_rev 1.117
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.117
retrieving revision 1.118
diff -u -r1.117 -r1.118
--- refs-autogen	9 Jul 2007 11:11:45 -0000	1.117
+++ refs-autogen	18 Aug 2007 21:33:39 -0000	1.118
@@ -831,7 +831,6 @@
 
   <partintro id="partintro">
   <para>
-	<phrase condition='online'>[restrict log='none']</phrase>
   $preamble{$group}
   </para>
   </partintro>
@@ -857,13 +856,21 @@
 				}
 			}
 		}
-		
+
+		# XXX Ok, here are two ugly hacks to insert IC
+		# [restrict] thing for online docs.
+		$symbols{$group}{$key} =~
+		s#<title>#<title><phrase condition='online'>[restrict log='none']</phrase>#s or
+		warn "Didn't manage to insert restrict for $group/$key!\n";
+
+		$symbols{$group}{$key} =~
+		s#(.*)</para>#$1<phrase condition='online'>\[/restrict\]</phrase></para>#s or
+		warn "Didn't manage to insert /restrict for $group/$key!\n";
+
 		$refpage .= $symbols{$group}{$key};
 	}
 
-	## Close up
-	$refpage .= "\n" . "<phrase condition='online'>[/restrict]</phrase>" . '</reference>';
-;
+	$refpage .= "\n</reference>";
 
 	# Dump page
 	my $prefix = ""; #$compounds ? "ic" : "";
@@ -1191,19 +1198,10 @@
 				die "Empty online example for $name (no <programlisting> found)\n";
 
 		#	# Let's see if we'll get away this easy
+			$code =~ s/^\s*//s;
+			$code =~ s/\s*$//s;
 			$content .= qq{
-<phrase condition='online'>
-<emphasis role='bold'>Example in action:</emphasis>
-</phrase>
-<programlisting>
-<textobject>
-<phrase condition='online'>
-[/restrict]
-$code
-[restrict log='none']
-</phrase>
-</textobject>
-</programlisting>
+<phrase condition='online'><emphasis role='bold'>Example in action:</emphasis></phrase><programlisting><textobject><phrase condition='online'>[/restrict]$code\[restrict log='none']</phrase></textobject></programlisting>
 };
 
 		# And rewrite section to example:



1.20      +2 -118    xmldocs/docbook/html-chunks.xsl


rev 1.20, prev_rev 1.19
Index: html-chunks.xsl
===================================================================
RCS file: /var/cvs/xmldocs/docbook/html-chunks.xsl,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- html-chunks.xsl	30 Mar 2006 01:42:50 -0000	1.19
+++ html-chunks.xsl	18 Aug 2007 21:33:39 -0000	1.20
@@ -38,18 +38,6 @@
         alt="DocBook!"
         class='w3cimg'/>
     </a>
-    <a href="http://jigsaw.w3.org/css-validator/">
-      <img
-        src="../images/colophon_css.png"
-        alt="Valid CSS!"
-        class='w3cimg'/>
-    </a>
-    <a href="http://validator.w3.org/check?uri=referer">
-      <img
-        src="../images/colophon_xhtml.png"
-        alt="Valid XHTML 1.0!"
-        class='w3cimg'/>
-    </a>
     <a href="http://www.icdevgroup.org/">
       <img
         src="../images/bb_interchange.png"
@@ -104,116 +92,12 @@
 	</xsl:template>
 
 
-	<!-- Make links to glossary properly prefixed with ../ for chunked
-	     docs -->
-<xsl:template match="olink" name="olink">
-
-	<xsl:call-template name="anchor"/>
-
-	<xsl:variable name="localinfo" select="@localinfo"/>
-
-	<xsl:variable name="targetdoc.att" select="@targetdoc"/>
-	<xsl:variable name="targetptr.att" select="@targetptr"/>
-
-	<xsl:variable name="olink.lang">
-		<xsl:call-template name="l10n.language">
-			<xsl:with-param name="xref-context" select="true()"/>
-		</xsl:call-template>
-	</xsl:variable>
-
-	<xsl:variable name="target.database.filename">
-		<xsl:call-template name="select.target.database">
-			<xsl:with-param name="targetdoc.att" select="$targetdoc.att"/>
-			<xsl:with-param name="targetptr.att" select="$targetptr.att"/>
-			<xsl:with-param name="olink.lang" select="$olink.lang"/>
-		</xsl:call-template>
-	</xsl:variable>
-
-	<xsl:variable name="target.database" select="document($target.database.filename,/)"/>
-
-	<xsl:if test="$olink.debug != 0">
-		<xsl:message>
-			<xsl:text>Olink debug: root element of target.database '</xsl:text>
-			<xsl:value-of select="$target.database.filename"/>
-			<xsl:text>' is '</xsl:text>
-			<xsl:value-of select="local-name($target.database/*[1])"/>
-			<xsl:text>'.</xsl:text>
-		</xsl:message>
-	</xsl:if>
-
-	<xsl:variable name="olink.key">
-		<xsl:call-template name="select.olink.key">
-			<xsl:with-param name="targetdoc.att" select="$targetdoc.att"/>
-			<xsl:with-param name="targetptr.att" select="$targetptr.att"/>
-			<xsl:with-param name="olink.lang" select="$olink.lang"/>
-			<xsl:with-param name="target.database" select="$target.database"/>
-		</xsl:call-template>
-	</xsl:variable>
-
-	<xsl:if test="string-length($olink.key) = 0">
-		<xsl:message>
-			<xsl:text>Error: unresolved olink: </xsl:text>
-			<xsl:text>targetdoc/targetptr = '</xsl:text>
-			<xsl:value-of select="$targetdoc.att"/>
-			<xsl:text>/</xsl:text>
-			<xsl:value-of select="$targetptr.att"/>
-			<xsl:text>'.</xsl:text>
-		</xsl:message>
-	</xsl:if>
-
-	<xsl:variable name="href">
-		<xsl:if test="starts-with(@targetdoc, 'glossary')">../</xsl:if>
-		<xsl:call-template name="make.olink.href">
-			<xsl:with-param name="olink.key" select="$olink.key"/>
-			<xsl:with-param name="target.database" select="$target.database"/>
-		</xsl:call-template>
-	</xsl:variable>
-
-	<xsl:variable name="hottext">
-		<xsl:call-template name="olink.hottext">
-			<xsl:with-param name="target.database" select="$target.database"/>
-			<xsl:with-param name="olink.key" select="$olink.key"/>
-			<xsl:with-param name="olink.lang" select="$olink.lang"/>
-		</xsl:call-template>
-	</xsl:variable>
-
-	<xsl:variable name="olink.docname.citation">
-		<xsl:call-template name="olink.document.citation">
-			<xsl:with-param name="olink.key" select="$olink.key"/>
-			<xsl:with-param name="target.database" select="$target.database"/>
-			<xsl:with-param name="olink.lang" select="$olink.lang"/>
-		</xsl:call-template>
-	</xsl:variable>
-
-	<xsl:variable name="olink.page.citation">
-		<xsl:call-template name="olink.page.citation">
-			<xsl:with-param name="olink.key" select="$olink.key"/>
-			<xsl:with-param name="target.database" select="$target.database"/>
-			<xsl:with-param name="olink.lang" select="$olink.lang"/>
-		</xsl:call-template>
-	</xsl:variable>
-
-	<xsl:choose>
-		<xsl:when test="$href != ''">
-			<a href="{$href}" class="olink">
-			<xsl:copy-of select="$hottext"/>
-			</a>
-			<xsl:copy-of select="$olink.page.citation"/>
-			<xsl:copy-of select="$olink.docname.citation"/>
-		</xsl:when>
-		<xsl:otherwise>
-			<span class="olink"><xsl:copy-of select="$hottext"/></span>
-			<xsl:copy-of select="$olink.page.citation"/>
-			<xsl:copy-of select="$olink.docname.citation"/>
-		</xsl:otherwise>
-	</xsl:choose>
 
-</xsl:template>
 
 
-	
+
 	<!-- This chunk inserts <meta name="area" content="REFENTRY_GROUP" />,
-	     to help Swish index documentation properly. Thanks Scott Hudson. -->
+	     to help Swish index documentation properly. Thanks Scott Hudson.  -->
 	<xsl:template match="refclass[1]">
 		<xsl:variable name="area">
 		<xsl:value-of select="." />



1.9       +0 -12     xmldocs/docbook/html-nochunks.xsl


rev 1.9, prev_rev 1.8
Index: html-nochunks.xsl
===================================================================
RCS file: /var/cvs/xmldocs/docbook/html-nochunks.xsl,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- html-nochunks.xsl	3 Sep 2006 10:03:23 -0000	1.8
+++ html-nochunks.xsl	18 Aug 2007 21:33:39 -0000	1.9
@@ -17,18 +17,6 @@
         alt="DocBook!"
         class='w3cimg'/>
     </a>
-    <a href="http://jigsaw.w3.org/css-validator/">
-      <img
-        src="images/colophon_css.png"
-        alt="Valid CSS!"
-        class='w3cimg'/>
-    </a>
-    <a href="http://validator.w3.org/check?uri=referer">
-      <img
-        src="images/colophon_xhtml.png"
-        alt="Valid XHTML 1.0!"
-        class='w3cimg'/>
-    </a>
     <a href="http://www.icdevgroup.org">
       <img
         src="images/bb_interchange.png"



1.23      +7 -2      xmldocs/docbook/olinkdb-c.xml


rev 1.23, prev_rev 1.22
Index: olinkdb-c.xml
===================================================================
RCS file: /var/cvs/xmldocs/docbook/olinkdb-c.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- olinkdb-c.xml	14 Feb 2007 14:16:50 -0000	1.22
+++ olinkdb-c.xml	18 Aug 2007 21:33:39 -0000	1.23
@@ -21,6 +21,7 @@
 	<!ENTITY whatsnew SYSTEM "../tmp/WHATSNEW-c.db"> 
 	<!ENTITY databases SYSTEM "../tmp/databases-c.db"> 
 	<!ENTITY optimization SYSTEM "../tmp/optimization-c.db"> 
+	<!ENTITY xmldocs SYSTEM "../tmp/xmldocs-c.db"> 
 ]>
 
 <targetset>
@@ -29,8 +30,7 @@
   </targetsetinfo>
 
 	<sitemap>
-		<dir name="OUTPUT"> 
-			
+		<dir name="OUTPUT">
 			<dir name='iccattut'>
 				<document targetdoc="iccattut">
 				&iccattut;
@@ -139,6 +139,11 @@
 				</document>
 			</dir>
 
+			<dir name='xmldocs'>
+				<document targetdoc="xmldocs">
+				&xmldocs;
+				</document>
+			</dir>
 		</dir>
 	</sitemap>
 



1.27      +4 -0      xmldocs/docbook/xmldocs.css


rev 1.27, prev_rev 1.26
Index: xmldocs.css
===================================================================
RCS file: /var/cvs/xmldocs/docbook/xmldocs.css,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- xmldocs.css	4 Jul 2006 22:24:42 -0000	1.26
+++ xmldocs.css	18 Aug 2007 21:33:39 -0000	1.27
@@ -424,3 +424,7 @@
 
 }
 
+.copyright, .legalnotice {
+	font-size: 70%;
+}
+



1.2       +35 -0     xmldocs/glossary/DSN


rev 1.2, prev_rev 1.1
Index: DSN
===================================================================
RCS file: /var/cvs/xmldocs/glossary/DSN,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- DSN	3 Apr 2006 23:28:56 -0000	1.1
+++ DSN	18 Aug 2007 21:33:39 -0000	1.2
@@ -0,0 +1,35 @@
+
+<literal>Data Source Name</literal> or a DSN is an application's data source identifier. It provides all parameters for the connection to a database.
+</para><para>
+In its simplest form, it has the format of 
+<literal>
+	<replaceable>protocol</replaceable>:
+</literal>
+<literal>
+	<replaceable>subprotocol</replaceable>:
+</literal>
+<literal>
+	<replaceable>host</replaceable>:
+</literal>
+<literal>
+	<replaceable>port</replaceable>:
+</literal>
+<literal>
+	<replaceable>database</replaceable>
+</literal>
+
+</para><para>
+
+It's also possible to explicitly name the parameters, like this:
+
+
+<literal>
+	<replaceable>protocol</replaceable>:
+</literal>
+<literal>
+	<replaceable>subprotocol</replaceable>:
+</literal>
+<literal>
+	<replaceable>database=DBNAME;port=PORT</replaceable>
+</literal>
+



1.17      +86 -117   xmldocs/guides/index.xml


rev 1.17, prev_rev 1.16
Index: index.xml
===================================================================
RCS file: /var/cvs/xmldocs/guides/index.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- index.xml	5 Jul 2007 17:21:34 -0000	1.16
+++ index.xml	18 Aug 2007 21:33:39 -0000	1.17
@@ -6,60 +6,12 @@
 <book id='index'>
 
 <bookinfo>
-<title>XMLDOCS - Interchange Documentation Set</title>
+<title>Interchange Documentation</title>
 <titleabbrev>index</titleabbrev>
-
-<copyright>
-	<year>2005</year>
-	<year>2006</year>
-	<year>2007</year>
-	<holder>
-	<ulink url='http://www.icdevgroup.org/'>Interchange Development Group</ulink>
-	<ulink url='http://www.icdevgroup.org/'>(http://www.icdevgroup.org/)</ulink>
-	</holder>
-</copyright>
-<copyright>
-	<year>2005</year>
-	<year>2006</year>
-	<year>2007</year>
-	<holder>
-	Davor Ocelic
-	<ulink url='mailto:docelic+icdevgroup.org'>(docelic+icdevgroup.org)</ulink>
-	</holder>
-</copyright>
-
-<!--
-<authorgroup>
-	<author>
-		<firstname>Davor</firstname>
-		<surname>Ocelic</surname>
-		<email>docelic at icdevgroup.org</email>
-	</author>
-</authorgroup>
-<authorgroup condition='online'>
--->
-<authorgroup>
-	<!-- <emphasis role='bold'>Search documentation:</emphasis>
-	<xi:include parse='text' href='../search/html-search-box' /> -->
-</authorgroup>
-
-<legalnotice>
-	<para>
-	This documentation is free; you can redistribute it and/or modify
-	it under the terms of the &GNU; General Public License as published by
-	the Free Software Foundation; either version 2 of the License, or
-	(at your option) any later version.
-	</para>
-	<para>
-	It is distributed in the hope that it will be useful,
-	but WITHOUT ANY WARRANTY; without even the implied warranty of
-	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-	GNU General Public License for more details.
-	</para>
-</legalnotice>
 </bookinfo>
 
 
+
 <!--
 <informaltable
 	align='center' pgwide='1' orient='port' title='' label='' frame='vsides'
@@ -106,24 +58,29 @@
 						(<olink targetdoc='glossary' targetptr='configuration'>?</olink>)
 						Configuration Directives
 					</emphasis><sbr/>
-					<ulink url="confs/index.html">Multi-HTML</ulink> |
+					<ulink url="confs/index.html">Multi-HTML</ulink><phrase condition="standard">
 					<ulink url="confs.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
 					<emphasis role='bold'>
 						Installation/Configuration FAQ
 					</emphasis><sbr/>
-					<ulink url="install/index.html">Multi-HTML</ulink> |
-					<ulink url="install.html">HTML</ulink>
+					<ulink url="install/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="install.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
 					<emphasis role='bold'>
 						Catalog Tutorial
 					</emphasis><sbr/>
-					<ulink url="iccattut/index.html">Multi-HTML</ulink> |
-					<ulink url="iccattut.html">HTML</ulink>
+					<ulink url="iccattut/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="iccattut.html">HTML</ulink>
+					</phrase>
 				</entry>
 			</row>
 
@@ -134,24 +91,30 @@
 						(<olink targetdoc='glossary' targetptr='ITL'>?</olink>)
 						ITL Tags
 					</emphasis><sbr/>
-					<ulink url="tags/index.html">Multi-HTML</ulink> |
-					<ulink url="tags.html">HTML</ulink>
+					<ulink url="tags/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="tags.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
 					<emphasis role='bold'>
 						HOWTOs Collection
 					</emphasis><sbr/>
-					<ulink url="howtos/index.html">Multi-HTML</ulink> |
-					<ulink url="howtos.html">HTML</ulink>
+					<ulink url="howtos/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="howtos.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
 					<emphasis role='bold'>
 						Search Tutorial
 					</emphasis><sbr/>
-					<ulink url="search/index.html">Multi-HTML</ulink> |
-					<ulink url="search.html">HTML</ulink>
+					<ulink url="search/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="search.html">HTML</ulink>
+					</phrase>
 				</entry>
 			</row>
 
@@ -162,24 +125,30 @@
 						(<olink targetdoc='glossary' targetptr='variable'>?</olink>)
 						Variables
 					</emphasis><sbr/>
-					<ulink url="vars/index.html">Multi-HTML</ulink> |
-					<ulink url="vars.html">HTML</ulink>
+					<ulink url="vars/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="vars.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
 					<emphasis role='bold'>
 						Optimization/Efficiency FAQ
 					</emphasis><sbr/>
-					<ulink url="optimization/index.html">Multi-HTML</ulink> |
-					<ulink url="optimization.html">HTML</ulink>
+					<ulink url="optimization/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="optimization.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
 					<emphasis role='bold'>
 						Programming Style
 					</emphasis><sbr/>
-					<ulink url="programming-style/index.html">Multi-HTML</ulink> |
-					<ulink url="programming-style.html">HTML</ulink>
+					<ulink url="programming-style/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="programming-style.html">HTML</ulink>
+					</phrase>
 				</entry>
 			</row>
 
@@ -190,24 +159,30 @@
 						(<olink targetdoc='glossary' targetptr='filter'>?</olink>)
 						Filters
 					</emphasis><sbr/>
-					<ulink url="filters/index.html">Multi-HTML</ulink> |
-					<ulink url="filters.html">HTML</ulink>
+					<ulink url="filters/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="filters.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
 					<emphasis role='bold'>
 						Glossary
 					</emphasis><sbr/>
-					<ulink url="glossary/index.html">Multi-HTML</ulink> |
-					<ulink url="glossary.html">HTML</ulink>
+					<ulink url="glossary/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="glossary.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
 					<emphasis role='bold'>
 						Upgrade Guide
 					</emphasis><sbr/>
-					<ulink url="upgrade/index.html">Multi-HTML</ulink> |
-					<ulink url="upgrade.html">HTML</ulink>
+					<ulink url="upgrade/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="upgrade.html">HTML</ulink>
+					</phrase>
 				</entry>
 			</row>
 
@@ -217,25 +192,13 @@
 						(<olink targetdoc='glossary' targetptr='profile'>?</olink>)
 						Checks
 					</emphasis><sbr/>
-					<ulink url="orderchecks/index.html">Multi-HTML</ulink> |
-					<ulink url="orderchecks.html">HTML</ulink>
+					<ulink url="orderchecks/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="orderchecks.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
-					<emphasis role='bold'>
-						WHATSNEW entries
-					</emphasis><sbr/>
-					<ulink url="WHATSNEW/index.html">Multi-HTML</ulink> |
-					<ulink url="WHATSNEW.html">HTML</ulink>
-				</entry>
-
-				<entry>
-				<!--
-					<emphasis role='bold'>
-					</emphasis><sbr/>
-					<ulink url=".html">HTML</ulink> |
-					<ulink url="/">Multi-HTML</ulink>
-				-->
 				</entry>
 			</row>
 
@@ -245,26 +208,16 @@
 						(<olink targetdoc='glossary' targetptr='pragma'>?</olink>)
 						Pragmas
 					</emphasis><sbr/>
-					<ulink url="pragmas/index.html">Multi-HTML</ulink> |
-					<ulink url="pragmas.html">HTML</ulink>
+					<ulink url="pragmas/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="pragmas.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
-				<!--
-					<emphasis role='bold'>
-					</emphasis><sbr/>
-					<ulink url=".html">HTML</ulink> |
-					<ulink url="/">Multi-HTML</ulink>
-				-->
 				</entry>
 
 				<entry>
-				<!--
-					<emphasis role='bold'>
-					</emphasis><sbr/>
-					<ulink url=".html">HTML</ulink> |
-					<ulink url="/">Multi-HTML</ulink>
-				-->
 				</entry>
 			</row>
 
@@ -274,26 +227,16 @@
 						(<olink targetdoc='glossary' targetptr='widget'>?</olink>)
 						Widgets
 					</emphasis><sbr/>
-					<ulink url="widgets/index.html">Multi-HTML</ulink> |
-					<ulink url="widgets.html">HTML</ulink>
+					<ulink url="widgets/index.html">Multi-HTML</ulink>
+					<phrase condition="standard">
+					| <ulink url="widgets.html">HTML</ulink>
+					</phrase>
 				</entry>
 
 				<entry>
-				<!--
-					<emphasis role='bold'>
-					</emphasis><sbr/>
-					<ulink url=".html">HTML</ulink> |
-					<ulink url="/">Multi-HTML</ulink>
-				-->
 				</entry>
 
 				<entry>
-				<!--
-					<emphasis role='bold'>
-					</emphasis><sbr/>
-					<ulink url=".html">HTML</ulink> |
-					<ulink url="/">Multi-HTML</ulink>
-				-->
 				</entry>
 			</row>
 
@@ -303,5 +246,31 @@
 	</tgroup>
 
 </informaltable>
+
+<!--
+<authorgroup>
+	<author>
+		<firstname>Davor</firstname>
+		<surname>Ocelic</surname>
+		<email>docelic at icdevgroup.org</email>
+	</author>
+</authorgroup>
+<authorgroup condition='online'>
+<authorgroup>
+	<emphasis role='bold'>Search documentation:</emphasis>
+	<xi:include parse='text' href='../search/html-search-box' />
+</authorgroup>
+-->
+
+<para role="legalnotice">
+This documentation is free; you can redistribute it and/or modify
+it under the terms of the &GNU; General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+</para>
+
+<para role="copyright">
+	Copyright 2005-2007 <ulink url='http://www.icdevgroup.org/'>Interchange Development Group (http://www.icdevgroup.org/)</ulink>, Davor Ocelic, <ulink url='mailto:docelic+icdevgroup.org'>(docelic+icdevgroup.org)</ulink>
+</para>
 
 </book>



1.2       +13 -5     xmldocs/refs/SQLDSN


rev 1.2, prev_rev 1.1
Index: SQLDSN
===================================================================
RCS file: /var/cvs/xmldocs/refs/SQLDSN,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- SQLDSN	3 Apr 2006 23:28:56 -0000	1.1
+++ SQLDSN	18 Aug 2007 21:33:39 -0000	1.2
@@ -5,9 +5,7 @@
 
 
 __NAME__ synopsis
-<group choice='req'>
-	<arg choice='plain'><replaceable>DSN</replaceable></arg>
-</group>
+<arg choice='plain'><replaceable>DSN</replaceable></arg>
 __END__
 
 __NAME__ description
@@ -19,13 +17,23 @@
 No magic is happening here, mind you. Your "template", the demo catalog,
 or some piece of code must &mdash; at some point &mdash; refer to the
 &var-SQLDSN; variable explicitly. &IC; does not somehow do this by itself.
+</para><para>
+See the &glos-DSN; glossary entry for complete discussion.
 __END__
 
 __NAME__ see also
 __END__
 
-__NAME__ example: Setting SQLDSN
+__NAME__ example: Setting SQLDSN for Postgres
 <programlisting>
-Variable SQLDSN dbi:Pg:dbname=MYDBNAME
+Variable SQLDSN dbi:Pg:database=MYDBNAME
 </programlisting>
 __END__
+
+__NAME__ example: Setting SQLDSN for MySQL
+<programlisting>
+Variable SQLDSN dbi:mysql:database=MYDBNAME
+</programlisting>
+__END__
+
+



1.5       +1 -8      xmldocs/refs/commify.filter


rev 1.5, prev_rev 1.4
Index: commify.filter
===================================================================
RCS file: /var/cvs/xmldocs/refs/commify.filter,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- commify.filter	19 Nov 2005 22:37:41 -0000	1.4
+++ commify.filter	18 Aug 2007 21:33:39 -0000	1.5
@@ -12,14 +12,7 @@
 __NAME__ online: Filter example
 <programlisting>
 [set online_commify_test]1234567890.123456[/set]
-
-My commified value, trimmed to 2 decimal places is:
-[filter commify.2][scratchd online_commify_test][/filter]
+[filter op=commify.2 interpolate=1][scratchd online_commify_test][/filter]
 </programlisting>
-__END__
-
-
-__NAME__ missing
-Why 12345.6789 with [filter commify.2] becomes 0.67 ?
 __END__
 



1.2       +1 -2      xmldocs/refs/crypt.filter


rev 1.2, prev_rev 1.1
Index: crypt.filter
===================================================================
RCS file: /var/cvs/xmldocs/refs/crypt.filter,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- crypt.filter	22 Dec 2004 14:06:37 -0000	1.1
+++ crypt.filter	18 Aug 2007 21:33:39 -0000	1.2
@@ -25,8 +25,7 @@
 The encrypted string should be the same each time you run the code
 because the salt does not change.
 <programlisting>
-Encrypted string <literal>TEST</literal> with salt of 
-<literal>AB</literal> is: 
+Encrypted string <literal>TEST</literal> with salt of <literal>AB</literal> is: 
 [filter crypt.AB]TEST[/filter].
 </programlisting>
 __END__



1.4       +8 -8      xmldocs/refs/date2time.filter


rev 1.4, prev_rev 1.3
Index: date2time.filter
===================================================================
RCS file: /var/cvs/xmldocs/refs/date2time.filter,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- date2time.filter	19 Nov 2005 22:37:41 -0000	1.3
+++ date2time.filter	18 Aug 2007 21:33:39 -0000	1.4
@@ -37,14 +37,14 @@
 
 __NAME__ online: Converting dates and times to seconds since Epoch
 <programlisting><![CDATA[
-[filter date2time]01/01/2005[/filter]    <br/>
-[filter date2time]01/01/05[/filter]      <br/>
-<br/>
-[filter date2time]01-01-2005[/filter]    <br/>
-[filter date2time]01-01-05[/filter]      <br/>
-<br/>
-[filter date2time]01-01-2005:10[/filter] <br/>
-[filter date2time]01-01-05:1045[/filter] <br/>
+[filter date2time]01/01/2005[/filter]
+[filter date2time]01/01/05[/filter]
+
+[filter date2time]01-01-2005[/filter]
+[filter date2time]01-01-05[/filter]
+
+[filter date2time]01-01-2005:10[/filter]
+[filter date2time]01-01-05:1045[/filter]
 ]]></programlisting>
 __END__
 



1.4       +11 -11    xmldocs/refs/date_change.filter


rev 1.4, prev_rev 1.3
Index: date_change.filter
===================================================================
RCS file: /var/cvs/xmldocs/refs/date_change.filter,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- date_change.filter	11 Apr 2006 15:05:34 -0000	1.3
+++ date_change.filter	18 Aug 2007 21:33:40 -0000	1.4
@@ -68,17 +68,17 @@
 
 __NAME__ online: Using date_change
 <programlisting><![CDATA[
-[filter date_change]2005-01-01[/filter]    <br/>
-[filter date_change]2005/01/01[/filter]    <br/>
-<br/>
-[filter date_change]2005-01-01:10[/filter]    <br/>
-[filter date_change]2005/05/29:1536[/filter]    <br/>
-<br/>
-[filter date_change]05-29-2005:1536[/filter]    <br/>
-[filter date_change]05-29-05:1536[/filter]    <br/>
-<br/>
-[filter date_change]0000-00-00[/filter]    <br/>
-[filter date_change][/filter]    <br/>
+[filter date_change]2005-01-01[/filter]
+[filter date_change]2005/01/01[/filter]
+
+[filter date_change]2005-01-01:10[/filter]
+[filter date_change]2005/05/29:1536[/filter]
+
+[filter date_change]05-29-2005:1536[/filter]
+[filter date_change]05-29-05:1536[/filter]
+
+[filter date_change]0000-00-00[/filter]
+[filter date_change][/filter]
 ]]></programlisting>
 __END__
 



1.2       +3 -3      xmldocs/refs/lc.filter


rev 1.2, prev_rev 1.1
Index: lc.filter
===================================================================
RCS file: /var/cvs/xmldocs/refs/lc.filter,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- lc.filter	29 May 2005 11:19:33 -0000	1.1
+++ lc.filter	18 Aug 2007 21:33:40 -0000	1.2
@@ -17,9 +17,9 @@
 
 __NAME__ online: Filter example
 <programlisting><![CDATA[
-[filter lc]You are kindly invited to [filter] 
-<a href="http://www.j-walk.com/other/conf/">The 3rd Annual Nigerian
-EMail Conference</a>.
+[filter lc]YOU ARE KINDLY INVITED TO
+<a href="http://www.j-walk.com/other/conf/">The 3rd Annual Nigerian EMail Conference</a>.
+[/filter]
 ]]></programlisting>
 __END__
 



1.2       +5 -5      xmldocs/refs/md5.filter


rev 1.2, prev_rev 1.1
Index: md5.filter
===================================================================
RCS file: /var/cvs/xmldocs/refs/md5.filter,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- md5.filter	29 May 2005 11:19:33 -0000	1.1
+++ md5.filter	18 Aug 2007 21:33:40 -0000	1.2
@@ -13,11 +13,11 @@
 
 __NAME__ online: Filter example
 <programlisting>
-[filter md5][/filter]                  [br]
-[filter md5]One[/filter]               [br]
-[filter md5]Two[/filter]               [br]
-[filter md5]MyPassword[/filter]        [br]
-[filter md5]Very long string[/filter]  [br]
+[filter md5][/filter]
+[filter md5]One[/filter]
+[filter md5]Two[/filter]
+[filter md5]MyPassword[/filter]
+[filter md5]Very long string[/filter]
 </programlisting>
 __END__
 



1.3       +5 -5      xmldocs/refs/yesno.filter


rev 1.3, prev_rev 1.2
Index: yesno.filter
===================================================================
RCS file: /var/cvs/xmldocs/refs/yesno.filter,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- yesno.filter	29 May 2005 15:01:39 -0000	1.2
+++ yesno.filter	18 Aug 2007 21:33:40 -0000	1.3
@@ -16,16 +16,16 @@
 
 __NAME__ online: Filter example
 <programlisting>
-OK (yes)? [filter yesno]Good input[/filter] [br]
-OK (no)? [filter yesno][/filter]            [br]
+OK (yes)? [filter yesno]Good input[/filter]
+OK (no)? [filter yesno][/filter]
 </programlisting>
 __END__
 
 __NAME__ online: Reaching "yesno" decision after any whitespace is removed first
 <programlisting>
-OK (yes)? [filter yesno]Good input[/filter]  [br]
-OK (yes)? [filter yesno]   [/filter]         [br]
-OK (no)? [filter strip yesno]   [/filter] [br]
+OK (yes)? [filter yesno]Good input[/filter]
+OK (yes)? [filter yesno][/filter]
+OK (no)? [filter strip yesno][/filter]
 </programlisting>
 __END__
 








More information about the docs mailing list