[docs] xmldocs - docelic modified 3 files

docs at icdevgroup.org docs at icdevgroup.org
Thu Oct 28 18:46:02 EDT 2004


User:      docelic
Date:      2004-10-28 22:46:02 GMT
Modified:  .        TODO
Modified:  bin      refs-autogen
Modified:  docbook  literals.ent
Log:
- bin/refs-autogen:
 - Don't display "(context shows lines x-y)" if only one line is displayed
 - {glob|cat}confs belong to partial-source-context category, not full
 - Fix Synopsis field for {glob|cat}confs. (Modelled after pragmas and globvars)

- docbook/literals.ent:
 - Added entitites, gcf, ccf, gcfs and cgfs. (To expand to interchange.cfg,
   catalog.cfg, "interchange.cfg or catalog.cfg" and
   "catalog.cfg or interchange.cfg".
   This is used all the time when you mention config files.

- TODO: items

Revision  Changes    Path
1.42      +2 -6      xmldocs/TODO


rev 1.42, prev_rev 1.41
Index: TODO
===================================================================
RCS file: /var/cvs/xmldocs/TODO,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -r1.41 -r1.42
--- TODO	23 Oct 2004 16:50:44 -0000	1.41
+++ TODO	28 Oct 2004 22:46:01 -0000	1.42
@@ -10,12 +10,8 @@
   'duplicates'. fix that.
 - ./files/ directory is not properly referenced from chunked documents.
   Solve by using entities?
-
-- Now that filters added duplicates among symbol names, fix bin/refs-autogen.
-
-- It's now obvious that multiple symbols will have the same names. This
-  calls for renaming every refs/* file to refs/*.<symbolType> (and all
-  other changes following from that).
+- Double-linked SeeAlso doesn't work. ConfigAllBefore points to ConfigAllAfter,
+  but the latter doesn't return love.
 
 - In iccattut:
   - make a "translation map" of /etc/interchange/* to RPM-equivs.



1.56      +13 -26    xmldocs/bin/refs-autogen


rev 1.56, prev_rev 1.55
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.55
retrieving revision 1.56
diff -u -r1.55 -r1.56
--- refs-autogen	28 Oct 2004 19:29:25 -0000	1.55
+++ refs-autogen	28 Oct 2004 22:46:01 -0000	1.56
@@ -271,7 +271,8 @@
 					my $all = 0; # Showing all for an item?
 					#if (0) { use Data::Dumper; print Dumper $ctx; sleep 10; }
 					# WE SHOW ONLY PART OF CONTEXT FOR THOSE
-					if ( $gkey !~ /(tag|conf|filter)$/ ) {
+					if ( $gkey !~ /(tag|filter)$/ ) {
+						$$ctx{ctxpre} ||= 0; $$ctx{ctxpost} ||= 0; # *confs don't have it
 						$cstart = $$ctx{lnum}-$$ctx{ctxpre};
 						$cend = $cstart+$$ctx{lnum}+$$ctx{ctxpost};
 
@@ -288,9 +289,15 @@
 					$cend >= $cstart+@{ $$ctx{ctx} } and
 						$cend = $cstart+@{ $$ctx{ctx} }-1;
 
+					my $eb = 1; # Include ending bracket?
 					if ( ! $all ) {
 						$ctxmeta = "<sbr/>Line $ln";
-						$ctxmeta .= " (context shows lines " . ( $cstart . "-" .  $cend );
+						if ( $cstart == $cend ) {
+							$eb = 0;
+						} else {
+							$ctxmeta .= " (context shows lines " .
+								( $cstart . "-" .  $cend );
+						}
 					} else {
 						$ctxmeta = "<sbr/>Lines: $cend";
 					}
@@ -298,7 +305,7 @@
 					if ( $$ctx{funclnum} ) {
 						$ctxmeta .= " in $$ctx{func}():$$ctx{funclnum}" ;
 					}
-					$ctxmeta .= ")" unless $all;
+					$ctxmeta .= ")" if (!$all and $eb);
 					my $r = $hash{revision}{$plf}->[0];
 					my $d = $hash{revision}{$plf}->[1];
 					my $revinfo = "";
@@ -1032,30 +1039,10 @@
 </refnamediv>
 
 <refsect1 id='$ag{"name"}_synopsis'>
-<title>PARAMETERS</title>
-
-<informaltable pgwide='1' frame='none'>
-<tgroup cols='5' align='left'>
-<colspec colname='arg'/>
-<colspec colname='pos'/>
-<colspec colname='req'/>
-<colspec colname='def'/>
-<colspec colname='dsc'/>
-
-<thead>
-<row>
-<entry>Argument</entry>
-<entry>Pos.</entry>
-<entry>Req.</entry>
-<entry>Default</entry>
-<entry>Description</entry>
-</row>
-</thead>
-<tbody>
+<title>SYNOPSIS</title>
+<cmdsynopsis>
 $ag{"synopsis"}
-</tbody>
-</tgroup>
-</informaltable>
+</cmdsynopsis>
 </refsect1>
 
 <refsect1 id='$ag{"name"}_description'>



1.10      +5 -0      xmldocs/docbook/literals.ent


rev 1.10, prev_rev 1.9
Index: literals.ent
===================================================================
RCS file: /var/cvs/xmldocs/docbook/literals.ent,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- literals.ent	19 Oct 2004 22:38:11 -0000	1.9
+++ literals.ent	28 Oct 2004 22:46:01 -0000	1.10
@@ -80,6 +80,11 @@
 <!ENTITY dereferencing "<olink targetdoc='glossary' targetptr='deref'>Dereferencing</olink>">
 <!ENTITY prefork "<olink targetdoc='glossary' targetptr='ic-run-mode'>PreFork</olink>">
 
+<!ENTITY gcf "<filename>interchange.cfg</filename>">
+<!ENTITY ccf "<filename>catalog.cfg</filename>">
+<!ENTITY gcfs "<filename>interchange.cfg</filename> or <filename>catalog.cfg</filename>">
+<!ENTITY cgfs "<filename>catalog.cfg</filename> or <filename>interchange.cfg</filename>">
+
 
 <!-- ENTITIES TO EASIER CONSTRUCT TAG PARAMETERS LIST -->
 <!-- put standard ones here, such as Hide or Interpolate/reparse -->








More information about the docs mailing list