[docs] xmldocs - docelic modified 3 files

docs at icdevgroup.org docs at icdevgroup.org
Wed Dec 8 09:46:33 EST 2004


User:      docelic
Date:      2004-12-08 14:46:33 GMT
Modified:  .        TODO
Modified:  bin      stattree
Modified:  refs     history-scan
Log:
- bin/stattree:
 - Finally, it now trims long lines, so we are rid of the horizontal
   scrollbar ;-) We'll see how it'll play out in man format, but
   why worry now when we can just worry later :)

- refs/history-scan: break line in example to fit 80cols

- TODO: items

Revision  Changes    Path
1.54      +19 -36    xmldocs/TODO


rev 1.54, prev_rev 1.53
Index: TODO
===================================================================
RCS file: /var/cvs/xmldocs/TODO,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -r1.53 -r1.54
--- TODO	29 Nov 2004 19:51:09 -0000	1.53
+++ TODO	8 Dec 2004 14:46:33 -0000	1.54
@@ -5,43 +5,7 @@
 
 Later:
 - Ask ndw about including [NEW!] and [TODO!] in titles in TOC.
-- ./files/ directory is not properly referenced from chunked documents.
-  This will be done by prefixing links from chunked documents with ../
-  "Code" for this is done, I just need to get it from ndw.
-- [Infrastructure prepared]
-  Online examples only have to be standard examples, with actual work in
-  practice if condition=online
-  Code to do that is:
-  <programlisting>
-    <textobject>
-      <textdata fileref="pathto.xml"/>
-    </textobject>
-  </programlisting>
 - Image tag, sort out mgkpath thing
-- Stinky manpage stylesheets are a disaster. This time it's that
-  <cmdsynopsis> is verbatim and <screen> still renders comments without
-  newlines! I mean, what the... (And &copy; is translated to crap instead
-  of plain "C"). Will need to write XSLT to fix that, and support tables.
-  NEWS: New guy took over xslt maintenance and is interested in improved
-    manpage support - he's interested in my problems, and is willing to
-    do xslt work himself.
-
-- In iccattut:
-  - Check if redhat/tarball paths are correct
-  - explain syntax accepted in profile files
-  - Fix ImageDir and include one picture for example
-  - <Racke>I name three things that IC users often didn't acknowledge:
-    namespaces (CGI, Values, Scratch)
-    parsing order ([L], variables, lists) - interpolation
-    inventing syntax doesn't buy you anything
-    IC is _not_ a programming language
-  - how to delete item from cart in all possible ways
-  - give examples for the tasks in 'do yourself' section (in progress)
-  - give good practices about filtering, security
-  - see problems from old docs/TODO notes on iccattut
-  - ICCATTUT MUST NOT STOP WHERE it stops now. it needs to show all stuff
-    from current "excercise for readers" section, and also many more things.
-  - files/tutorial*: s/tutorial-*.log/tutorial.*.log/
 
 - in source contexts, wrap runaway lines
 - match style (no starting verb or all starting verbs) in all Example titles
@@ -138,3 +102,22 @@
   and locally
 - Mention ML page, cvsweb
 - How to deal with Safe
+
+
+- In iccattut (CHECK why revert to old version didn't get to cvs ?!):
+  - Check if redhat/tarball paths are correct
+  - explain syntax accepted in profile files
+  - Fix ImageDir and include one picture for example
+  - <Racke>I name three things that IC users often didn't acknowledge:
+    namespaces (CGI, Values, Scratch)
+    parsing order ([L], variables, lists) - interpolation
+    inventing syntax doesn't buy you anything
+    IC is _not_ a programming language
+  - how to delete item from cart in all possible ways
+  - give examples for the tasks in 'do yourself' section (in progress)
+  - give good practices about filtering, security
+  - see problems from old docs/TODO notes on iccattut
+  - ICCATTUT MUST NOT STOP WHERE it stops now. it needs to show all stuff
+    from current "excercise for readers" section, and also many more things.
+  - files/tutorial*: s/tutorial-*.log/tutorial.*.log/
+



1.35      +15 -9     xmldocs/bin/stattree


rev 1.35, prev_rev 1.34
Index: stattree
===================================================================
RCS file: /var/cvs/xmldocs/bin/stattree,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- stattree	4 Dec 2004 22:47:23 -0000	1.34
+++ stattree	8 Dec 2004 14:46:33 -0000	1.35
@@ -455,20 +455,26 @@
 # Format the context lines before saving to the db
 sub format_ctx {
 	for $_ ( @_ ) { s/\t/  /g; chomp };
-	# Find the number of starting whitespace common to all lines
-	# and trim it.
+
 	my $common;
-	for $_ ( @_ ) {
-		if (/\S/ and /^( +)/) {
+	for my $str ( @_ ) {
+		# Behave long lines
+		my $len = length $str; my $pos = 70;
+		while ( $len > 100 ) {
+			$str =~ s/^(.{$pos}.*?)([\s<\&\?\|\(])/$1 \\\n$2/s;
+			$pos += 70; $len -= 70;
+		}
+
+
+		# Find the number of starting whitespace common to all lines
+		if ($str =~ /\S/ and $str =~ /^( +)/) {
 			$common = length($1) if !defined $common || length($1) < $common
 		}
-		# TODO Catch runaway lines (produces crapload of things, so refine
-		# search before starting to use it)
-		#if ( $_ =~ /\S\s{10,}/ ) {
-		#	warn "Runaway '$_' ?\n";
-		#}
 	}
+
+	# Do as above loop decided
 	if ( $common ) { s/^ {$common}// for @_ }
+
 	return @_;
 }
 



1.6       +2 -1      xmldocs/refs/history-scan


rev 1.6, prev_rev 1.5
Index: history-scan
===================================================================
RCS file: /var/cvs/xmldocs/refs/history-scan,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- history-scan	28 Oct 2004 10:29:14 -0000	1.5
+++ history-scan	8 Dec 2004 14:46:33 -0000	1.6
@@ -158,7 +158,8 @@
 <input type="hidden"   name="mv_todo"        value="return>
 <input type="hidden"   name="mv_click"       value="Login">
 <input type="hidden"   name="mv_failpage"    value="login">
-<input type="hidden"   name="mv_successpage" value="[history-scan exclude="^/ord|^/multi/|^/process|^/login|^/logout" pageonly=1]">
+<input type="hidden"   name="mv_successpage" value="[history-scan
+      exclude="^/ord|^/multi/|^/process|^/login|^/logout" pageonly=1]">
 <input type="hidden"   name="mv_nextpage"    value="index">
 <input type="hidden"   name="mv_session_id"  value="[data session id]">
 <input type="text"     name="mv_username"    value="[read-cookie MV_USERNAME]">








More information about the docs mailing list