[docs] xmldocs - docelic modified 9 files

docs at icdevgroup.org docs at icdevgroup.org
Sat Sep 3 10:01:24 EDT 2005


User:      docelic
Date:      2005-09-03 14:01:23 GMT
Modified:  .        .cvsignore Makefile
Modified:  bin      refs-autogen
Modified:  docbook  docbookxi.dtd
Modified:  guides   faq.xml
Modified:  refs     DatabaseAuto VariableDatabase
Modified:           dynamic_variables_file_only
Modified:  refs/init_page example2
Log:
- Makefile:
 I already said Makefile supports output to different OUTPUT directories
 (using OUTPUT=-yourprefix make skel).
 This is to be used when we generate different sets of docs, for example
 one for offline browsing, one for online, etc..

 Now, I have added that default prefix is -std, so "OUTPUT" will always
 be a symlink to some real output directory.
 (INCOMPATIBLE CHANGE: rm -rf OUTPUT  before generating docs after update).

- rename icfiles.ent -> autofiles.ent

- refs/*: small fixes

- guides/faq.xml: removed part of content which I will put in new document
   optimization.xml

Revision  Changes    Path
1.2       +1 -1      xmldocs/.cvsignore


rev 1.2, prev_rev 1.1
Index: .cvsignore
===================================================================
RCS file: /var/cvs/xmldocs/.cvsignore,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- .cvsignore	15 Nov 2004 15:15:09 -0000	1.1
+++ .cvsignore	3 Sep 2005 14:01:23 -0000	1.2
@@ -1,4 +1,4 @@
-OUTPUT
+OUTPUT*
 sources
 tmp
 cache



1.70      +14 -10    xmldocs/Makefile


rev 1.70, prev_rev 1.69
Index: Makefile
===================================================================
RCS file: /var/cvs/xmldocs/Makefile,v
retrieving revision 1.69
retrieving revision 1.70
diff -u -r1.69 -r1.70
--- Makefile	1 Sep 2005 23:12:38 -0000	1.69
+++ Makefile	3 Sep 2005 14:01:23 -0000	1.70
@@ -18,6 +18,7 @@
 GLOSSARY    = glossary
 ALL_DOCS    = $(GLOSSARY) $(HOWTOS) $(GUIDES) $(SYMBOL_TYPES)
 SHELL       = /bin/sh
+OUTPUT     ?= -std
 export O    = OUTPUT$(OUTPUT)
 export T    = tmp
 export XCF  = docbook/catalog.xml
@@ -38,6 +39,7 @@
 .PHONY: up-% cvs-% %-up %-cvs
 .PHONY: cache caches
 .PHONY: refxmls
+.PHONY: $O
 
 
 #############################################################
@@ -59,10 +61,11 @@
 
 #############################################################
 # Skel
-skel: $T $O
-	make OUTPUT/files
-	make OUTPUT/images
-	make OUTPUT/xmldocs.css
+skel:
+	make $T
+	make $O
+	make OUTPUT/files OUTPUT/images OUTPUT/xmldocs.css
+
 $T:
 	if test -e $T.temporary; then                                \
 		echo "U     $T/"; mv $T.temporary $T;                      \
@@ -72,7 +75,8 @@
 	echo "U     $O/"
 	mkdir -p $O
 	echo "S     OUTPUT -> $O/"
-	ln -sf $O OUTPUT
+	rm -f OUTPUT
+	ln -s $O OUTPUT
 OUTPUT/files: $(shell find files) bin/dbgen
 	echo "C     $@/"
 	rm -rf $@/
@@ -122,7 +126,7 @@
 #############################################################
 # STANDARD TARGETS || two-pass processing method
 #OUTPUT/howtos.html: DEPTH = "--stringparam toc.max.depth 1"
-OUTPUT/%.html: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/icfiles.ent
+OUTPUT/%.html: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
 	echo "C     $@"
 	$(PSR) $(PSR_FLAGS)                                                \
 	  $(PROFILE)                                                       \
@@ -134,7 +138,7 @@
 	  --stringparam current.docid $*                                   \
 	  --stringparam target.database.document ../docbook/olinkdb-nc.xml \
 	  -o $@ docbook/html-nochunks.xsl $T/$*-nc.profiled
-OUTPUT/%: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/icfiles.ent
+OUTPUT/%: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
 	echo "C     $@/"
 	$(PSR) $(PSR_FLAGS)                                                \
 	  $(PROFILE)                                                       \
@@ -146,7 +150,7 @@
 	  --stringparam current.docid $*                                   \
 	  --stringparam target.database.document ../docbook/olinkdb-nc.xml \
 	  -o $@/ docbook/html-chunks.xsl $T/$*-c.profiled
-OUTPUT/%.man: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/icfiles.ent
+OUTPUT/%.man: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
 	echo "C     $@/"
 	mkdir -p "$@"
 	$(PSR) $(PSR_FLAGS)                                                \
@@ -168,7 +172,7 @@
 
 #############################################################
 # Supporting target - LATEX output
-tmp/%.latex: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/icfiles.ent
+tmp/%.latex: %.xml docbook/autorefs.ent docbook/autoglossary.ent docbook/autohowtos.ent docbook/autofiles.ent
 	$(PSR) $(PSR_FLAGS)                                                \
 	  $(PROFILE)                                                       \
 	  --stringparam current.docid $*                                   \
@@ -256,7 +260,7 @@
 howtos/howtos.xml docbook/autohowtos.ent: $(shell find howtos/ -regex '.+[^(\.xml)]$$') bin/generic-autogen
 	bin/generic-autogen howtos
 docbook/autorefs.ent: refxmls
-docbook/icfiles.ent: refxmls
+docbook/autofiles.ent: refxmls
 
 
 ## Helper target, only used by docelic



1.94      +3 -3      xmldocs/bin/refs-autogen


rev 1.94, prev_rev 1.93
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.93
retrieving revision 1.94
diff -u -r1.93 -r1.94
--- refs-autogen	1 Sep 2005 23:12:38 -0000	1.93
+++ refs-autogen	3 Sep 2005 14:01:23 -0000	1.94
@@ -48,7 +48,7 @@
 my $last_path; # Last version we want docs generated for (say, 5.2.0).
 my $compounds = 1; # Summarize similar symbol groups to single page?
 my @fileentities; # List of generated file entities (they point to CVS)
-my $fileentitiespath = "docbook/icfiles.ent";
+my $fileentitiespath = "docbook/autofiles.ent";
 
 my @page_order = (qw/purpose default structure synopsis description online example notes bugs/, "symbol type", "source", "author", "copyright", "see also", "directive type", "variable type");
 
@@ -812,9 +812,9 @@
 print INVOUT Dumper \%invalid;
 close INVOUT;
 
-# Just print out that we created docbook/icfiles.ent
+# Just print out that we created docbook/autofiles.ent
 close FILE_ENTITIES;
-print "GEN: docbook/icfiles.ent\n";
+print "GEN: docbook/autofiles.ent\n";
 
 # Output autorefs.ent
 unless ( $no_autorefs ) {



1.21      +1 -1      xmldocs/docbook/docbookxi.dtd


rev 1.21, prev_rev 1.20
Index: docbookxi.dtd
===================================================================
RCS file: /var/cvs/xmldocs/docbook/docbookxi.dtd,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- docbookxi.dtd	30 Aug 2005 21:37:06 -0000	1.20
+++ docbookxi.dtd	3 Sep 2005 14:01:23 -0000	1.21
@@ -1,7 +1,7 @@
 
 <!ENTITY % literals	SYSTEM "literals.ent">  %literals;
 <!ENTITY % autorefs	SYSTEM "autorefs.ent">  %autorefs;
-<!ENTITY % icfiles	SYSTEM "icfiles.ent">  %icfiles;
+<!ENTITY % autofiles	SYSTEM "autofiles.ent">  %autofiles;
 <!ENTITY % glossary	SYSTEM "autoglossary.ent">  %glossary;
 <!ENTITY % howtos	  SYSTEM "autohowtos.ent">  %howtos;
 



1.7       +0 -440    xmldocs/guides/faq.xml


rev 1.7, prev_rev 1.6
Index: faq.xml
===================================================================
RCS file: /var/cvs/xmldocs/guides/faq.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- faq.xml	1 Sep 2005 23:12:38 -0000	1.6
+++ faq.xml	3 Sep 2005 14:01:23 -0000	1.7
@@ -1974,447 +1974,7 @@
 </para>
 </answer></qandaentry>
 
-<qandaentry>
-	<question><para>Optimizing lists</para></question>
-<answer><para>
-&IC; has powerful search capabilities that allow you to produce
-lists of items for use in category lists, product lists, indexes, and other
-navigation tools.
-</para><para>
-
-These are a two-edged sword, though. Lists of hundreds or thousands of entries
-can be returned, and techniques that work well displaying only a few items may
-slow to a crawl when a large list is returned.
-</para><para>
-
-In general, when you are returning one item (i.e. a flypage) or a small list
-(i.e. a shopping cart) you can be pretty carefree in your use of &tag-if;,
-&tag-calc; and &tag-perl; tags. When there are hundreds of items, though,
-you cannot;
-each complex test or embedded &PERL; snippet causes the
-<classname>Safe</classname> module to have to
-evaluate code, and each &glos-ITL; tag requires parsing and argument building.
-</para><para>
-
-The <classname>Safe</classname> module is pretty fast considering what it does, but it can only generate
-a few thousand instances per second even on a fast system. And the
-&glos-ITL; tag
-parser can likewise only parse thousands of tags per CPU second.
-</para><para>
-
-What to do? You want to provide complex conditional tests but you don't want
-your system to slow to a crawl. Luckily, there are techniques which can speed
-up complex lists by orders of magnitude.
-</para><para>
-
-Benchmarking
-</para><para>
-
-A non-precise benchmark of different iteration options can be done
-with the following &glos-ITL; tag. Place this in a file in the
-<filename class='directory'>usertag/</filename>
-directory in the &IC; root:
-
-
-<programlisting><![CDATA[
-UserTag benchmark Order start display
-UserTag benchmark AddAttr
-UserTag benchmark Routine <<EOR
-my $bench_start;
-my @bench_times;
-sub {
-    my ($start, $display, $opt) = @_;
-    my @times = times();
-    if($start or ! defined $bench_start) {
-        $bench_start = 0;
-        @bench_times = @times;
-        for(@bench_times) {
-            $bench_start += $_;
-        }
-    }
-    my $current_total;
-    if($display or ! $start) {
-        for(@times) {
-            $current_total += $_;
-        }
-        unless ($start) {
-            $current_total = sprintf '%.3f', $current_total - $bench_start;
-            for(my $i = 0; $i < 4; $i++) {
-                $times[$i] = sprintf '%.3f', $times[$i] - $bench_times[$i];
-            }
-        }
-        return $current_total if ! $opt->{verbose};
-        return  "total=$current_total user=$times[0] sys=$times[1] " .
-                "cuser=$times[2] csys=$times[3]";
-    }
-    return;
-}
-EOR
-]]></programlisting>
-
-Then at the beginning of the code to check, call
-
-<programlisting><![CDATA[
-[benchmark start=1]
-]]></programlisting>
-
-to start the measurement. At the end
-
-<programlisting><![CDATA[
-[benchmark]
-]]></programlisting>
-
-will display the time used. Bear in mind that it is not precise, and
-that there may be variation due to system conditions. Also, the longer
-the times and the bigger the list, the better the comparison.
-
-To see the system/user breakdown, do:
-
-<programlisting><![CDATA[
-[benchmark verbose=1]
-]]></programlisting>
-
-In general, "user" time measures &IC; processing time and and
-the rest are indicative of the database access overhead, which can vary
-widely from database to database.
-</para><para>
-
-Optimizations
-
-* [PREFIX-tag] is faster than [parsed-tag]
-
-
-<programlisting><![CDATA[
-[loop prefix=foo search="ra=yes"]
-
-  [foo-data products image] is slightly faster than
-  [foo-field image] which is MUCH faster than
-  [data products image [foo-code]] which is faster than
-  [data table=products column=image key="[foo-code]"]
-
-[/loop]
-]]></programlisting>
-
-The loop tags are interpreted by means of fast regular expression
-scans of the loop container text, and fetch an entire row of
-data in one query. The &tag-data; ITL tag interpretation is
-delayed until after the loop is finished, whereby the &glos-ITL; tag
-parser must find the tag, build a parameter list, then fetch the
-data with a separate query. If there are repeated references to
-the same field in the loop, the speedup can be 10x or more.
-
-* Pre-fetch data with rf=field1,field2,field3 and access with [PREFIX-param field1].
-
-mv_return_fields (otherwise known as "rf" in one-click
-terminology) sets the fields that are returned from a search.
-Once they are returned, they can be accessed with [PREFIX-param field].
-They can also be referenced with [PREFIX-pos N], where N is a digit 
-representing the ordinal position (i.e. starting with 0) in the
-list of fields.
-
-The following are equivalent:
-
-
-<programlisting><![CDATA[
-Benchmark loop-field list: [benchmark start=1]
-  <!-- [loop search="ra=yes/st=db"]
-       [loop-code] price: [loop-field price] [/loop] -->
-       TIME: [benchmark]
-
-Benchmark loop-param list: [benchmark start=1]
-  <!-- [loop search="ra=yes/st=db/rf=sku,price"]
-       [loop-code] price: [loop-param price] [/loop] -->
-       TIME: [benchmark]
-]]></programlisting>
-
-
-but the second is much, much faster.
-
-* [PREFIX-alternate N] is available for row counting and display.
-
-A common need when building tables is to conditionally close the table
-row or data containers. I see a lot of:
-
-
-<programlisting><![CDATA[
-[loop search="ra=yes"]
-  [calc] return '<tr>' if [loop-increment] == 1; return[/calc]
-  [calc] return '' if [loop-increment] % 3; return '</tr>' [/calc]
-[/loop]
-]]></programlisting>
-
-
-Much faster, by a few orders of magnitude, is:
-
-
-<programlisting><![CDATA[
-[loop search="ra=yes"]
-  [loop-change 1][condition]1[/condition]<tr>[/loop-change 1]
-  [loop-alternate 3]</TR>[/loop-alternate]
-[/loop]
-
-If you think you need to close the final row by checking the
-final count, look at this:
-
-[loop search="ra=yes"]
-  [on-match]
-    <table>
-    <tr>
-  [/on-match]
-  
-  [list]
-    <td>[loop-code]</TD>
-    [loop-alternate 3]</TR><tr>[/loop-alternate]
-  [/list]
-  
-  [on-match]
-    </tr>
-    </table>
-  [/on-match]
-  
-  [no-match]
-    No match, sorry.
-  [/no-match]
-[/loop]
-]]></programlisting>
-
-
-This is a hundred times faster than anything you can build with
-multiple &tag-calc; tags.
-
-* Use simple go/nogo comparisons in [if ...]
-
-Consider these two snippets:
-
-
-<programlisting><![CDATA[
-[if scratch|value|cgi key] THEN [/if]
-]]></programlisting>
-
-and:
-
-<programlisting><![CDATA[
-[if scratch|value|cgi key == '1'] THEN [/if]
-]]></programlisting>
-
-The first one doesn't require &PERL; evaluation. It simply checks to see
-if the value is blank or 0, and returns true if it is anything but.
-Of course this requires setting your test values to blank or 0 instead
-of "No" or " " or somesuch, but it is anywhere from 20-35% faster.
-
-Try it on the foundation demo:
-
-<programlisting><![CDATA[
-Overhead: 
-
-[benchmark start=1]
-
 <!--
-[loop search="ra=yes"]
-  [set cert][loop-field gift_cert][/set]
-[/loop]
--->
-
-[benchmark]
-<p>
-
-
-if scratch compare: 
-[benchmark start=1]
-
-<!--
-[loop search="ra=yes"]
-  [set cert][loop-field gift_cert][/set]
-  [loop-code] [if scratch cert] YES [else] NO [/else][/if]
-  [loop-code] [if scratch cert] YES [else] NO [/else][/if]
-  [loop-code] [if scratch cert] YES [else] NO [/else][/if]
-  [loop-code] [if scratch cert] YES [else] NO [/else][/if]
-  [loop-code] [if scratch cert] YES [else] NO [/else][/if]
-[/loop]
--->
-
-[benchmark]
-<p>
-
-
-if scratch compare eq 1: 
-[benchmark start=1]
-<!--
-[loop search="ra=yes"]
-  [set cert][loop-field gift_cert][/set]
-  [loop-code] [if scratch cert == 1] YES [else] NO [/else][/if]
-  [loop-code] [if scratch cert == 1] YES [else] NO [/else][/if]
-  [loop-code] [if scratch cert == 1] YES [else] NO [/else][/if]
-  [loop-code] [if scratch cert == 1] YES [else] NO [/else][/if]
-  [loop-code] [if scratch cert == 1] YES [else] NO [/else][/if]
-[/loop]
--->
-
-[benchmark]
-<p>
-
-[page @@MV_PAGE@@]Again</a>
-]]></programlisting>
-
-* Use [PREFIX-calc] instead of [calc] or [perl]
-
-You can execute the same code as [calc] with [PREFIX-calc], which has
-two benefits:
-
-+ It doesn't require ITL parsing.
-+ It is executed during the loop instead of after it.
-
-The [PREFIX-calc] object has complete access to all normal
-embedded &PERL; objects like $Values, $Carts, $Tag, and such. If
-you want to make a data table (i.e. "products" or "pricing")
-available for access inside of it, just do:
-
-
-<programlisting><![CDATA[
-[perl tables="products pricing"] [/perl]
-]]></programlisting>
-
-
-prior to list start. Now you can do something like:
-
-
-<programlisting><![CDATA[
-[loop search="ra=yes"]
-  [loop-calc]
-    $desc = $Tag->data('products', 'description', '[loop-code]');
-    $link = $Tag->page('[loop-code]');
-    return "$link $desc </A>";
-  [/loop-calc] <br>
-[/loop]
-]]></programlisting>
-
-
-* ADVANCED: Precompile and execute with [PREFIX-sub] and [PREFIX-exec]
-
-For repetitive routines, you can achieve a considerable savings
-in CPU by pre-compiling your embedded &PERL; code.
-
-In the "Construct Something" demo, the bar_link() routine in
-catalog_before.cfg is an example of compiling the subroutine once
-at catalog configuration time.
-
-You can also compile routines at the time of the list execution
-with [item-sub routine] CODE [/item-sub]. This means only one
-<classname>Safe</classname> evaluation is done - every time the [loop-exec routine]
-is called, it is done fast as a call to the routine. This can be
-10 times or more faster than separate [calc] calls, or 5 times
-faster than separate [PREFIX-calc] calls.
-
-.Example:
-
-
-<programlisting><![CDATA[
-[benchmark start=1]
-
-loop-calc:
-<!--
-[loop search="st=db/fi=country/ra=yes/ml=1000"]
-  [loop-calc]
-    my $code = q{[loop-code]};
-    return "code '$code' reversed is " . reverse($code);
-  [/loop-calc]
-[/loop]
--->
-
-[benchmark]
-
-<p>
-
-[benchmark start=1]
-loop-sub and loop-exec:
-<!--
-[loop search="st=db/fi=country/ra=yes/ml=1000"]
-  [loop-sub country_compare]
-    my $code = shift;
-    return "code '$code' reversed is " . reverse($code);
-  [/loop-sub]
-  [loop-exec country_compare][loop-code][/loop-exec]
-[/loop]
--->
-
-[benchmark]
-]]></programlisting>
-
-
-* ADVANCED: Execute and save with [query ...], then use an embedded &PERL;
-routine.
-
-You can run [query arrayref=myref sql="query"], which saves the
-results of the search/query in a &PERL; reference. It is then
-available in $Tmp->{myref}. (Of course, "myref" can be any 
-arbitrary name.)
-
-This is the fastest possible method to display a list.
-
-.Observe:
-
-
-<programlisting><![CDATA[
-[set waiting_for]os28004[/set]
-
-[benchmark start=1] Embedded &PERL;
-<!--
-[query arrayref=myref sql="select sku,price,description from products" /]
-
-[perl]
-  # Get the query results, has multiple fields
-  my $ary = $Tmp->{myref};
-  my $out = '';
-
-  foreach $line (@$ary) {
-    my ($sku, $price, $desc) = @$line;
-    if($sku eq $Scratch->{waiting_for}) {
-      $out .= "We were waiting for this one!!!!\n";
-    }
-    $out .= "sku: $sku price: $price description: $desc\n";
-  }
-  return $out;
-[/perl]
--->
-
-TIME: [benchmark]
-
-
-[benchmark start=1] All loop
-
-<!--
-[query list=1 sql="select sku,price,description from products"]
-
-  [if scratch waiting_for eq '[sql-code]']
-    We were waiting for this one!!!!
-  [/if]
-  
-  sku: [sql-code]
-  price: [sql-param price]
-  desc: [sql-param description]  
-[/query]
--->
-
-TIME: [benchmark]
-]]></programlisting>
-</para>
-</answer>
-</qandaentry>
-
-
-<!--
-* Other things that help:
-
-** Avoid interpolate=1 when possible. A separate tag parser must be spawned
-    every time you do this. Many times people use this without needing it.
-
-** Avoid saving large values to Scratch, as these have to be written to the users session. If you need them only for the current page, clear at the end by using [tmp scratch_var] contents [/tmp], which is the same as  [seti scratch_var] contents [/seti] except clears the value before the session is written. You can also use [scratchd scratch_var] to return the contents and delete them from the session at the same time.
-
-** Use the [more-list] facility to break up your large searches. You can use them in [query ....] and [loop ...] searches as well - see the docs.
-
-</para>
-</qandaentry>
-
 <qandaentry>
 	<question><para>Using Interchange with Oracle</para></question>
 <answer><para>



1.2       +1 -1      xmldocs/refs/DatabaseAuto


rev 1.2, prev_rev 1.1
Index: DatabaseAuto
===================================================================
RCS file: /var/cvs/xmldocs/refs/DatabaseAuto,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- DatabaseAuto	12 Aug 2005 17:58:58 -0000	1.1
+++ DatabaseAuto	3 Sep 2005 14:01:23 -0000	1.2
@@ -39,7 +39,7 @@
 If the &PERL; module <classname>DBIx::DBSchema</classname> was found,
 it would also dump the specification needed to re-create the table structures
 (which you can use as the <literal>CREATE_SQL</literal> parameter to
-&conf-Database;:
+&conf-Database;):
 
 <programlisting>
 Database  <replaceable>TABLENAME</replaceable> CREATE_SQL   CREATE TABLE <replaceable>TABLENAME ( ...)</replaceable>



1.4       +6 -0      xmldocs/refs/VariableDatabase


rev 1.4, prev_rev 1.3
Index: VariableDatabase
===================================================================
RCS file: /var/cvs/xmldocs/refs/VariableDatabase,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- VariableDatabase	14 Dec 2004 19:15:43 -0000	1.3
+++ VariableDatabase	3 Sep 2005 14:01:23 -0000	1.4
@@ -37,6 +37,10 @@
 Database variables variables.txt TAB
 VariableDatabase variables
 </programlisting>
+So as you see, if you want to use a non-default &glos-database;, you must
+explicitely
+define it using the &conf-Database; directive and do so before the 
+&conf-VariableDatabase; line.
 __END__
 
 
@@ -60,3 +64,5 @@
 ]]></programlisting>
 __END__
 
+TODO: It's easy. Just make sure you do before "VariableDatabase variable":
+ Database variable variable.txt dbi:mysql:database=foo;host=hostname;etc=etc



1.4       +1 -1      xmldocs/refs/dynamic_variables_file_only


rev 1.4, prev_rev 1.3
Index: dynamic_variables_file_only
===================================================================
RCS file: /var/cvs/xmldocs/refs/dynamic_variables_file_only,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- dynamic_variables_file_only	13 Dec 2004 00:04:41 -0000	1.3
+++ dynamic_variables_file_only	3 Sep 2005 14:01:23 -0000	1.4
@@ -1,5 +1,5 @@
 __NAME__ purpose
-do not dynamically update directives from databases
+dynamically update the directives from files only
 __END__
 
 



1.2       +1 -1      xmldocs/refs/init_page/example2


rev 1.2, prev_rev 1.1
Index: example2
===================================================================
RCS file: /var/cvs/xmldocs/refs/init_page/example2,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- example2	22 Apr 2005 11:37:04 -0000	1.1
+++ example2	3 Sep 2005 14:01:23 -0000	1.2
@@ -49,7 +49,7 @@
 <para>
 You might wonder in what cases would the code fail to match the template?
 Well, obviously, users could simply try to access non-existent pages. 
-The other common issue are &glos-form-action;s such as 
+The other common issue are &glos-ActionMap;s such as 
 <literal>/scan</literal> or <literal>/process</literal>.
 </para>
 </example>








More information about the docs mailing list