[docs] xmldocs - docelic modified 5 files

[docs at icdevgroup.org]

User:      docelic
Date:      2004-08-25 10:14:54 GMT
Modified:  bin      refs-autogen
Modified:  docbook  docbookxi.dtd
Removed:   cache/cvs-head .objectlist.c.txt .objectlist.perl.txt .tags
Log:
- bin/refs-autogen:
 - use &SYMBOL_<name>; entity instead of files in docbook/item-type-skel/

- docbook/docbookxi.dtd:
 - added entity definitions

Revision  Changes    Path
1.24      +2 -15     xmldocs/bin/refs-autogen


rev 1.24, prev_rev 1.23
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- refs-autogen	25 Aug 2004 09:53:03 -0000	1.23
+++ refs-autogen	25 Aug 2004 10:14:54 -0000	1.24
@@ -48,19 +48,6 @@
 	systemtag => "System Tag",
 );
 
-# General description of symbol types
-# Move to docbook/docbookxi.dtd entities
-my %general_desc;
-opendir DIR, "docbook/symbol-type-skel";
-while ( my $file = readdir DIR ) {
-	next if $file =~ /^\.|^CVS$/;
-	open INF, "< docbook/symbol-type-skel/$file" or
-		die "Can't open docbook/symbol-type-skel/$file ($!)\n";
-	$general_desc{$file} = join "", <INF>;
-	close INF;
-}
-closedir DIR;
-
 # Default fields
 my %defaults = (
 	synopsis => "&DEF_SYNOPSIS;",
@@ -307,7 +294,7 @@
 		name => $name,
 		id => $name,
 		"_symbol type" => $group,
-		"symbol type" => $general_desc{$group},
+		"symbol type" => "&SYMBOL_" . uc($group) . ";",
 		"_first section" => ( $group =~ /tag$/ ? "TAG STRUCTURE" : "DEFAULT" ),
 	};
 
@@ -452,7 +439,7 @@
 
 <refsect1>
 <title>SYMBOL TYPE</title>
-<para>$ag{"symbol type"}</para>
+$ag{"symbol type"}
 </refsect1>
 
 <refsect1>



1.8       +23 -2     xmldocs/docbook/docbookxi.dtd


rev 1.8, prev_rev 1.7
Index: docbookxi.dtd
===================================================================
RCS file: /var/cvs/xmldocs/docbook/docbookxi.dtd,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- docbookxi.dtd	24 Aug 2004 19:52:08 -0000	1.7
+++ docbookxi.dtd	25 Aug 2004 10:14:54 -0000	1.8
@@ -1,5 +1,5 @@
 
-<!-- ENTITIES -->
+<!-- GENERAL ENTITIES -->
 <!ENTITY GNU "<ulink url='http://www.gnu.org'>GNU</ulink>">
 <!ENTITY IC "<ulink url='http://www.icdevgroup.org'>Interchange</ulink>">
 <!ENTITY RH "<ulink url='http://www.redhat.com'>Red Hat</ulink>">
@@ -31,8 +31,29 @@
 <!ENTITY DEF_SEEALSO "No information.">
 <!ENTITY DEF_PURPOSE "description line missing">
 
-<!-- Elements that supplement user's text -->
+<!-- ENTITIES THAT SUPPLEMENT USER'S TEXT -->
 <!ENTITY ICDEVGROUP "<ulink url='http://www.icdevgroup.org'>Interchange Development Group</ulink>">
+
+<!-- ENTITIES THAT DESCRIBE SYMBOLS -->
+<!ENTITY SYMBOL_GLOBVAR "
+<para>
+Global variables ....
+</para>
+">
+<!ENTITY SYMBOL_PRAGMA "
+<para>
+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>
+To define a pragma catalog-wide, use the <option>Pragma</option> directive: <code>Pragma NAME [0]</code>.
+</para><para>
+To define a pragma value for a particular page, use the <tag>pragma</tag> tag anywhere on a page: <code>[pragma NAME]</code> to enable, or
+<code>[pragma NAME 0]</code> to disable.
+</para><para>
+To define a pragma for a small ITL block inside the page, enclose the block in <code>[tag pragma NAME]1[/tag]...[tag pragma NAME]0[/tag]</code>.
+</para><para>
+Starting with Interchange 5.0, the <code>$::Pragma->{name}</code> syntax is used in the Interchange source instead of the old <code>$Vend::Cfg->{Pragma}{name}</code>.
+</para>
+">
 
 <!-- Remove MsgSet -->
 <!ENTITY % compound.class "procedure|sidebar">