Permalink
Browse files

- files/*: xhtml compliance

- glossary/* and refs/*: updates to existing material
  • Loading branch information...
1 parent b33d64d commit 9ac97f525e642d3376555b12ff1c136fa73af3a4 @docelic docelic committed Aug 12, 2006
View
1 TODO
@@ -7,6 +7,7 @@
- aliases like DataDir/DefaultTables are not documented
- that howto entries get automatic title if start with < in first line
- unit testing
+- remove NEW from <meta>
Outstanding:
=======
View
@@ -719,9 +719,7 @@ while ( my($k,$v) = each %{ $autogenerated{$group} } ) {
# DONE
$ag{latest} = $hash{version};
-# # Visually mark NEW (cvs-head) items . HEH, too bad this doesn't work.
-# DocBook strips non-text stuff when creating TOC entries. So under symbol
-# names you see a nice NEW icon, but in TOC that plain text looks very poor.
+# # Visually mark NEW (cvs-head) items .
if ( @{ $ag{'_available in'} } == 1 and
( ${$ag{'_available in'}}[0] eq $ENV{XMLDOCS_CUR_DEVEL} or
${$ag{'_available in'}}[0] eq 'cvs-head' )) {
@@ -4,6 +4,6 @@
<h3>Test #[item-code]</h3>
<p>[item-field description] . . . [item-field price]</p>
-<br>
+<br/>
Return to the [page index]Index page</a>.
[include bottom]
@@ -4,6 +4,6 @@
<h3>Test #[item-code]</h3>
<p>[item-field description] . . . [item-field price]</p>
-<br>
+<br/>
Return to the [page index]Index page</a>.
[include bottom]
@@ -19,6 +19,6 @@
</tr>
[/loop]
</table>
-<hr>
+<hr/>
<p align=center>[page order]View shopping cart</a></p>
[include bottom]
@@ -3,49 +3,49 @@
<h1>Checkout Page</h1>
<form method="post" action="[process]">
-<input type="hidden" name="mv_todo" value="submit">
-<input type="hidden" name="mv_order_profile" value="order_profile">
-<input type="hidden" name="mv_cyber_mode" value="minivend_test">
+<input type="hidden" name="mv_todo" value="submit" />
+<input type="hidden" name="mv_order_profile" value="order_profile" />
+<input type="hidden" name="mv_cyber_mode" value="minivend_test" />
<table cellpadding="3">
<tr>
<td align="right"><b>First name:</b></td>
-<td><input type="text" name="fname" value="[value fname]"></td>
+<td><input type="text" name="fname" value="[value fname]" /></td>
</tr>
<tr>
<td align="right"><b>Last name:</b></td>
-<td><input type="text" name="lname" value="[value lname]"></td>
+<td><input type="text" name="lname" value="[value lname]" /></td>
</tr>
<tr>
<td align="right" rowspan="2"><b>Address:</b></td>
-<td><input type="text" name="address1" value="[value address1]"></td>
+<td><input type="text" name="address1" value="[value address1]" /></td>
</tr>
<tr>
-<td><input type="text" name="address2" value="[value address2]"></td>
+<td><input type="text" name="address2" value="[value address2]" /></td>
</tr>
<tr>
<td align="right"><b>City:</b></td>
-<td><input type=text name=city value="[value city]"></td>
+<td><input type=text name="city" value="[value city]" /></td>
</tr>
<tr>
<td align="right"><b>State:</b></td>
-<td><input type="text" name="state" value="[value state]"></td>
+<td><input type="text" name="state" value="[value state]" /></td>
</tr>
<tr>
<td align="right"><b>Postal code:</b></td>
-<td><input type="text" name="zip" value="[value zip]"></td>
+<td><input type="text" name="zip" value="[value zip]" /></td>
</tr>
<tr>
<td align="right"><b>Country:</b></td>
-<td><input type="text" name="country" value="[value country]"></td>
+<td><input type="text" name="country" value="[value country]" /></td>
</tr>
</table>
@@ -58,25 +58,25 @@ <h1>Checkout Page</h1>
<tr>
<td align="right"><b>Credit card number:</b></td>
-<td><input type="text" name="mv_credit_card_number" value="" size="20"></td>
+<td><input type="text" name="mv_credit_card_number" value="" size="20" /></td>
</tr>
<tr>
<td align="right"><b>Credit card expiration date:</b></td>
<td>
Month (number from 1-12):
-<input type="text" name="mv_credit_card_exp_month" value="" size="2" maxlength="2">
+<input type="text" name="mv_credit_card_exp_month" value="" size="2" maxlength="2" />
<br>
Year (last two digits only):
-<input type="text" name="mv_credit_card_exp_year" value="" size="2" maxlength="2">
+<input type="text" name="mv_credit_card_exp_year" value="" size="2" maxlength="2" />
</td>
</tr>
</table>
<p>
-<input type="submit" name="submit" value="Finalize!">
-<input type="reset" name="reset" value="Reset">
+<input type="submit" name="submit" value="Finalize!" />
+<input type="reset" name="reset" value="Reset" />
</p>
</form>
@@ -4,6 +4,6 @@
<h3>Test #[item-code]</h3>
<p>[item-field description] . . . [item-field price]</p>
-<br>
+<br/>
Return to the [page index]Index page</a>.
[include bottom]
@@ -19,6 +19,6 @@
</tr>
[/loop]
</table>
-<hr>
+<hr/>
<p align=center>[page order]View shopping cart</a></p>
[include bottom]
@@ -2,50 +2,50 @@
__LEFT__
<h1>Checkout Page</h1>
-<form method="post" action="[process]">
-<input type="hidden" name="mv_todo" value="submit">
-<input type="hidden" name="mv_order_profile" value="order_profile">
-<input type="hidden" name="mv_cyber_mode" value="minivend_test">
+<form method="post" action="[process]" />
+<input type="hidden" name="mv_todo" value="submit" />
+<input type="hidden" name="mv_order_profile" value="order_profile" />
+<input type="hidden" name="mv_cyber_mode" value="minivend_test" />
<table cellpadding="3">
<tr>
<td align="right"><b>First name:</b></td>
-<td><input type="text" name="fname" value="[value fname]"></td>
+<td><input type="text" name="fname" value="[value fname]" /></td>
</tr>
<tr>
<td align="right"><b>Last name:</b></td>
-<td><input type="text" name="lname" value="[value lname]"></td>
+<td><input type="text" name="lname" value="[value lname]" /></td>
</tr>
<tr>
<td align="right" rowspan="2"><b>Address:</b></td>
-<td><input type="text" name="address1" value="[value address1]"></td>
+<td><input type="text" name="address1" value="[value address1]" /></td>
</tr>
<tr>
-<td><input type="text" name="address2" value="[value address2]"></td>
+<td><input type="text" name="address2" value="[value address2]" /></td>
</tr>
<tr>
<td align="right"><b>City:</b></td>
-<td><input type=text name=city value="[value city]"></td>
+<td><input type=text name="city" value="[value city]" /></td>
</tr>
<tr>
<td align="right"><b>State:</b></td>
-<td><input type="text" name="state" value="[value state]"></td>
+<td><input type="text" name="state" value="[value state]" /></td>
</tr>
<tr>
<td align="right"><b>Postal code:</b></td>
-<td><input type="text" name="zip" value="[value zip]"></td>
+<td><input type="text" name="zip" value="[value zip]" /></td>
</tr>
<tr>
<td align="right"><b>Country:</b></td>
-<td><input type="text" name="country" value="[value country]"></td>
+<td><input type="text" name="country" value="[value country]" /></td>
</tr>
</table>
@@ -58,15 +58,15 @@ <h1>Checkout Page</h1>
<tr>
<td align="right"><b>Credit card number:</b></td>
-<td><input type="text" name="mv_credit_card_number" value="" size="20"></td>
+<td><input type="text" name="mv_credit_card_number" value="" size="20" /></td>
</tr>
<tr>
<td align="right"><b>Credit card expiration date:</b></td>
<td>
Month:
-<select name=mv_credit_card_exp_month>
+<select name="mv_credit_card_exp_month">
[loop
lr=1
option=mv_credit_card_exp_month
@@ -88,7 +88,7 @@ <h1>Checkout Page</h1>
</select>
Year:
-<select name=mv_credit_card_exp_year>
+<select name="mv_credit_card_exp_year">
[comment]
This should always return the current year as the first, then
seven more years.
@@ -113,8 +113,8 @@ <h1>Checkout Page</h1>
</table>
<p>
-<input type="submit" name="submit" value="Finalize!">
-<input type="reset" name="reset" value="Reset">
+<input type="submit" name="submit" value="Finalize!" />
+<input type="reset" name="reset" value="Reset" />
</p>
</form>
@@ -4,6 +4,6 @@
<h3>Test #[item-code]</h3>
<p>[item-field description] . . . [currency][item-field price][/currency]</p>
-<br>
+<br/>
Return to the [page index]Index page</a>.
__BOTTOM__
@@ -19,6 +19,6 @@
</tr>
[/loop]
</table>
-<hr>
+<hr/>
<p align=center>[page order]View shopping cart</a></p>
__BOTTOM__
@@ -31,7 +31,7 @@ <h3>Search Results</h3>
[/no-match]
[/search-region]
-<hr>
+<hr/>
<p align="center">[page index]Return to welcome page</a></p>
<p align="center">[page order]View shopping cart</a></p>
View
@@ -282,6 +282,16 @@ directive.
</section>
+<section>
+ <title>Interchange Database Design</title>
+<para>
+We are trying not to impose any database structure that would require
+our own tools to maintain the data. We always want to keep
+it such that &IC; data can be maintained via a spreadsheet processor or
+foreign database tools.
+</para>
+</section>
+
<section>
<title>Interchange Database Conventions</title>
<para>
View
@@ -3,7 +3,7 @@ User &glos-session;s in Interchange are usually kept as files in the
a DBM database) for each &glos-catalog;. Since session
data is not deleted after sessions end (or timeout), periodic expiring
needs to be set up to keep the session database or session files from growing
-too large and wasting disk space.
+too large, wasting disk space and slowing down directory lookups.
</para><para>
There's no worry that expiring will do any harm, because all our scripts
only clean up unused sessions. Active users will not notice any change.
@@ -29,7 +29,7 @@ from <literal>crontab</literal>. As the &IC; user, run
<note>
<para>
If a session saved search paging files in &conf-ScratchDir;, they would
-be deleted too.
+not be deleted (see below for a solution).
</para>
</note>
@@ -80,3 +80,25 @@ account:
44 4 * * * su -c "/PATH/TO/INTERCHANGE/bin/expireall -r" IC_USERNAME
</programlisting>
+The above does not, however, clean temporary files from the &conf-ScratchDir;
+directory. We don't often use the expire scripts any more. We just use
+a small standalone script <filename>clean_session_tmp</filename>:
+<programlisting><![CDATA[
+#!/bin/sh
+
+for DIR in $*; do
+ for i in session tmp; do
+ if test -d "$DIR/$i"; then
+ find $DIR/$i -type f -mmin +480 | xargs --no-run-if-empty rm
+ find $DIR/$i -type d -empty -mtime +2 -depth | xargs --no-run-if-empty rmdir
+ else
+ echo "$0: $DIR/$i doesn't exist.";
+ fi
+ done
+done
+]]></programlisting>
+using a cron entry similar to:
+<programlisting>
+44 0,4,8,12,16,20 * * * <replaceable>DIR/bin/</replaceable>clean_session_tmp <replaceable>/path/to/catdir1</replaceable> <replaceable>/path/to/catdir2</replaceable>
+</programlisting>
+
View
@@ -3,6 +3,19 @@ routine.
</para><para>
Pragma values can be defined at any level; catalog-wide, page-wide or
&glos-ITL;-block wide.
+</para>
+
+<note><para>
+Catalog-wide pragmas are equivalent to inserting <code>[pragma ...]</code>
+on every page. However, setting the &conf-Pragma; catalog directive (instead of
+using &tag-pragma; tag all the time) has the benefit of initializing at
+catalog startup time (so, only once), which avoids extra hash key lookups.
+Namely, there is some crossover point at about 4 &PERL; references where it
+saves processor power to assign a scalar instead of looking it up every time.
+</para>
+</note>
+
+<para>
To define a pragma catalog-wide, use the <option>Pragma</option> directive:
<programlisting>
Pragma <replaceable>NAME</replaceable> <group choice='req'><arg choice='plain'>0</arg><arg choice='plain'>1</arg><arg choice='plain'>=<replaceable>pragma-specific value</replaceable></arg></group>
@@ -30,4 +43,5 @@ block in <code>[tag pragma ...]</code>:
Starting with Interchange 5.0, the <code>$::Pragma->{name}</code> syntax
is used in the &IC; source, instead of the old
<code>$Vend::Cfg->{Pragma}{name}</code>.
-
+</para><para>
+See the list of available pragmas in <olink targetdoc='pragmas'/>.
View
@@ -36,4 +36,6 @@ Pragma dynamic_variables 0
</programlisting>
__END__
-
+__NAME__ see also
+pragma
+__END__
View
@@ -48,6 +48,9 @@ Supported events are
The return value should either be a type name, or a &glos-false; value
(in which case &IC; proceeds with built-in detection algorithm).
</para></listitem>
+<listitem><para>
+ <literal>flypage</literal> &mdash;
+</para></listitem>
</itemizedlist>
</para><para>
__END__
Oops, something went wrong.

0 comments on commit 9ac97f5

Please sign in to comment.