[docs] xmldocs - docelic modified 8 files
docs at icdevgroup.org
docs at icdevgroup.org
Fri Jul 23 18:42:24 EDT 2004
User: docelic
Date: 2004-07-23 22:42:24 GMT
Modified: bin refs-autogen stattree
Modified: docbook xmldocs.css
Modified: guides iccattut.xml
Added: refs/no_image_rewrite control description example synopsis
Log:
- bin/refs-autogen: delete ^\s* at beginning of lines in 'control' file
- bin/stattree;
- warn if stat() fails
- improved comments
- remove else {...} block which was never reached anyway
- docbook/xmldocs.css: deleted contents; will try making better css
- symbol no_image_rewrite: added files
Revision Changes Path
1.6 +1 -0 xmldocs/bin/refs-autogen
rev 1.6, prev_rev 1.5
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- refs-autogen 23 Jul 2004 14:12:24 -0000 1.5
+++ refs-autogen 23 Jul 2004 22:42:23 -0000 1.6
@@ -265,6 +265,7 @@
while (my $line = <IN>) {
next if $line =~ /^\s*#/;
chomp $line;
+ $line =~ s/^\s+//;
my ($sect,$text) = split /\s*:\s*/, $line, 2;
goto SDONE if (!( defined $text and length $text ));
if ( $mode eq 'override' ) {
1.7 +7 -9 xmldocs/bin/stattree
rev 1.7, prev_rev 1.6
Index: stattree
===================================================================
RCS file: /var/cvs/xmldocs/bin/stattree,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- stattree 23 Jul 2004 13:32:01 -0000 1.6
+++ stattree 23 Jul 2004 22:42:23 -0000 1.7
@@ -112,13 +112,14 @@
# Things we ignore
return if /(^|\/)(CVS|\.cvs|\.svn|\.autoload)(\/.+[^\/])?$/;
- stat($file);
+ stat($file) or
+ warn "Can't stat '$file' ? ($!)\n";
# totals
if ( -d $file ) {
$hash{total}{directories}++;
$hash{tree}{$file}{type} = "directory";
- return;
+ return; # This is enough for directories
} else {
$hash{total}{files}++;
$hash{total}{size} += (stat _)[7];
@@ -177,7 +178,7 @@
# Open text file, parse contents
open IN, "< $file" or die "Can't open $file ($!)\n";
my @file = <IN>;
- unshift @file, ""; # Match indices with line numbers
+ unshift @file, ""; # Match index numbers with line numbers
close IN;
for (my $lnum = 1; $lnum < scalar @file; $lnum++) {
@@ -192,16 +193,13 @@
if ( /^ICVERSION=(['"])(\d+\.\d+\.\d+)\1/ ) {
if ( !$hash{version} or "$hash{version}" eq "$2" ) {
$hash{version} = $2
- } else {
- die "I got inconsistent ^ICVERSION= information: " .
- "existing is $hash{version}, new is $2. " .
- "Not continuing, fix manually\n";
}
# break; # We *could* stop processing here,
# but we won't.
}
}
- # ICVERSION must be known here, or someone's playing
+ # ICVERSION must be known here, or someone's playing, or
+ # it's a pre-5.0 version which doesnt have that.
unless ( $hash{version} ) {
warn "Wasn't able to determine " .
'^ICVERSION=([\'"])(\d+\.\d+\.\d+)\1 from the main ' .
@@ -245,7 +243,7 @@
push @{ $hash{symbols}{pragma}{$1} },
# TODO Here, and 2 places below: make sure if ctx is say, 5:5,
# it always shows that much (that is, workaround file beginning/
- # file end problems).
+ # file end problems - pad with empty lines or something).
[ "$i{ver}/$file", $lnum, "$ctx_p\:$ctx_n", [@file[$lnum-$ctx_p..$lnum+$ctx_n]] ];
}
1.4 +0 -129 xmldocs/docbook/xmldocs.css
<<xmldocs.css: empty>>
1.4 +1 -1 xmldocs/guides/iccattut.xml
rev 1.4, prev_rev 1.3
Index: iccattut.xml
===================================================================
RCS file: /var/cvs/xmldocs/guides/iccattut.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- iccattut.xml 12 Jul 2004 14:57:39 -0000 1.3
+++ iccattut.xml 23 Jul 2004 22:42:23 -0000 1.4
@@ -101,7 +101,7 @@
</para> <para>
It is recommended that you create the files used in this tutorial yourself. You will learn more by creating the directory structure and using your favorite text editor to create files in the proper places on your own system as they are discussed.
</para> <para>
- It's hard to write a complete tutorial without the feedback from the audience. Please jot down your notes and remarks as you digest this tutorial and e-mail docelic at icdevgroup.org with your thoughts; which sections need clarification or examples, which parts were useful to you, or what was the weather like over there yesterday afternoon :).
+ It's hard to write a complete tutorial without the feedback from the audience. Please jot down your notes and remarks as you digest this tutorial and e-mail docs at icdevgroup.org with your thoughts; which sections need clarification or examples, which parts were useful to you, or what was the weather like over there yesterday afternoon :).
</para>
</sect2>
1.1 xmldocs/refs/no_image_rewrite/control
rev 1.1, prev_rev 1.0
Index: control
===================================================================
# The usual comments can be used here.
# To override a field, supply a value
# To let it through unmodified, simply leave the fields empty
# purpose: oneline description (MUST FILL IN)
purpose: prevent image locations from being altered
# default value if applicable (make it short, just like: 0, none, ...)
default: 0
# Please take time to fill in the See Also line.
# Just name the related symbols. The system will work everything out.
# (Note that if you link some item from here, that item will auto-point
# back here (under "indirect links" section))
see also:
# Usually not needed to modify below
# id: name of the output file (defaults to <name>)
id:
# name: visible name in the pages
name:
# specify person(s). Defaults to icdevgroup
author:
# leave empty; GPL is the default
copyright:
1.1 xmldocs/refs/no_image_rewrite/description
rev 1.1, prev_rev 1.0
Index: description
===================================================================
Prevents image locations in pages from being altered.
</para><para>
Interchange normally rewrites image locations to point to ImageDir (or ImageDirSecure). This applies to image locations mentioned in <![CDATA[<img src="">, <input src="">, <body background="">, <table background=""> and table subelements (th, tr, td).]]>
1.1 xmldocs/refs/no_image_rewrite/example
rev 1.1, prev_rev 1.0
Index: example
===================================================================
<example>
<title>
Image path rewriting example
</title>
<para>
If the no_image_rewrite directive is <emphasis>disabled</emphasis> and
ImageDir is set to "/standard/images", a tag like
</para>
<programlisting><![CDATA[
<img src="fancy.gif">
]]></programlisting>
<para>
would be changed to
</para>
<programlisting><![CDATA[
<img src="/standard/images/fancy.gif">
]]></programlisting>
<para>
With the directive enabled, the image URLs would be left intact.
</para>
</example>
1.1 xmldocs/refs/no_image_rewrite/synopsis
rev 1.1, prev_rev 1.0
Index: synopsis
===================================================================
<synopsis><![CDATA[
Pragma no_image_rewrite
]]></synopsis>
More information about the docs
mailing list