[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