[docs] xmldocs - docelic modified 4 files
docs at icdevgroup.org
docs at icdevgroup.org
Wed Jul 28 11:27:05 EDT 2004
User: docelic
Date: 2004-07-28 15:27:05 GMT
Modified: bin refs-autogen
Modified: docbook html-chunks.xsl
Modified: docbook/item-skel control
Modified: docbook/symbol-type-skel pragma
Log:
- bin/refs-autogen:
- support "missing: <text>" in refs/<X>/control files. Use it to manually
"push" items to the tmp/missing (a filename) list for a particular symbol.
Multiple missing: lines can also be used.
- docbook/html-chunks.xsl:
- remove height= width= options for xhtml-compatible icon
- docbok/item-skel/control:
- document the addition of missing: field
- docbook/symbol-type-skel/pragma:
- Make the description of a symbol more compact
- Remove two "\" characters that were leftovers from escaping in a string
Revision Changes Path
1.8 +7 -3 xmldocs/bin/refs-autogen
rev 1.8, prev_rev 1.7
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- refs-autogen 25 Jul 2004 08:54:05 -0000 1.7
+++ refs-autogen 28 Jul 2004 15:27:04 -0000 1.8
@@ -268,10 +268,14 @@
$line =~ s/^\s+//;
my ($sect,$text) = split /\s*:\s*/, $line, 2;
goto SDONE if (!( defined $text and length $text ));
- if ( $mode eq 'override' ) {
- $$ref{lc $sect} = $text;
+ if ( $sect ne 'missing' ) {
+ if ( $mode eq 'override' ) {
+ $$ref{lc $sect} = $text;
+ } else {
+ $$ref{lc $sect} .= '</para><para>' . $text;
+ }
} else {
- $$ref{lc $sect} .= '</para><para>' . $text;
+ push @{ $invalid{$name} }, $text;
}
SDONE:
}
1.5 +1 -1 xmldocs/docbook/html-chunks.xsl
rev 1.5, prev_rev 1.4
Index: html-chunks.xsl
===================================================================
RCS file: /var/cvs/xmldocs/docbook/html-chunks.xsl,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- html-chunks.xsl 27 Jul 2004 21:24:23 -0000 1.4
+++ html-chunks.xsl 28 Jul 2004 15:27:04 -0000 1.5
@@ -23,7 +23,7 @@
<a href="http://validator.w3.org/check?uri=referer">
<img
src="../images/colophon_xhtml.png"
- alt="Valid XHTML 1.0!" height="31" width="88"
+ alt="Valid XHTML 1.0!"
class='w3cimg'/>
</a>
</p>
1.3 +5 -0 xmldocs/docbook/item-skel/control
rev 1.3, prev_rev 1.2
Index: control
===================================================================
RCS file: /var/cvs/xmldocs/docbook/item-skel/control,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- control 23 Jul 2004 13:32:02 -0000 1.2
+++ control 28 Jul 2004 15:27:05 -0000 1.3
@@ -12,6 +12,11 @@
# back here (under "indirect links" section))
see also:
+# If the autogenerated list of missing elements for an item is not
+# enough (that is, you need more "personal touch" to describe the missing
+# elements), use this field. You can also use "missing:" multiple times:
+missing:
+
# Usually not needed to modify below
# id: name of the output file (defaults to <name>)
1.2 +5 -9 xmldocs/docbook/symbol-type-skel/pragma
rev 1.2, prev_rev 1.1
Index: pragma
===================================================================
RCS file: /var/cvs/xmldocs/docbook/symbol-type-skel/pragma,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- pragma 23 Jul 2004 13:32:02 -0000 1.1
+++ pragma 28 Jul 2004 15:27:05 -0000 1.2
@@ -1,11 +1,7 @@
-Pragmas are used to control various aspects of page and data parsing and display.
+Pragmas are used to control various aspects of page and data parsing and display. Values can be defined catalog-wide, page-wide and ITL-block wide.
</para><para>
-Pragma values can be defined catalog-wide, page-wide and ITL-block wide.
+To define a pragma catalog-wide, use the Pragma <filename>catalog.cfg</filename> directive: Pragma NAME [0].
+To define a pragma value for a particular page, use the [pragma] tag anywhere on the page: [pragma NAME] to enable, or [pragma NAME 0] to disable.
+To define a pragma for a small ITL block, enclose the page block in [tag pragma]: [tag pragma NAME]1[/tag]...[tag pragma NAME]0[/tag].
</para><para>
-To define a pragma catalog-wide, use a <filename>catalog.cfg</filename> directive: <synopsis>Pragma NAME</synopsis>
-</para><para>
-To define a pragma value for a particular page, use the [pragma] tag on a page: <synopsis>[pragma NAME]</synopsis> to enable, or <synopsis>[pragma NAME 0]</synopsis> to disable.
-</para><para>
-To define a pragma for a small ITL block, enclose the page block in [tag pragma]: <synopsis>[tag pragma NAME]1[/tag]...[tag pragma NAME]0[/tag]</synopsis>
-</para><para>
-Starting with Interchange 5.0, the \$Vend::Cfg->{Pragma}{name} syntax in the Interchange source is abandoned in favor of \$::Pragma->{name}.
+Starting with Interchange 5.0, the $Vend::Cfg->{Pragma}{name} syntax in the Interchange source is abandoned in favor of $::Pragma->{name}.
More information about the docs
mailing list