[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