[docs] xmldocs - docelic modified bin/refs-autogen

[docs at icdevgroup.org]

User:      docelic
Date:      2005-08-30 21:43:30 GMT
Modified:  bin      refs-autogen
Log:
Update comments to clear out little inaccuracies in text.

Revision  Changes    Path
1.92      +9 -7      xmldocs/bin/refs-autogen


rev 1.92, prev_rev 1.91
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.91
retrieving revision 1.92
diff -u -r1.91 -r1.92
--- refs-autogen	30 Aug 2005 21:37:06 -0000	1.91
+++ refs-autogen	30 Aug 2005 21:43:30 -0000	1.92
@@ -191,20 +191,22 @@
 	# file $fileentitiespath, and dump entities to it. That file will contain
 	# entities from ALL IC versions.
 	# For non-last version, only one entity will be generated. Example:
-	# IC4.8/README -> &cvs4.8-README; -> cvs.icdevgroup.org ->
-	# icdevgroup.org/cgi-bin/cvsweb/interchange/?only_with_tag=STABLE_4_8-root.
+	# FILE: IC4.8/README
+	# ENTITY: &cvsfile4.8-README;
+	# LOCATION: SITE/cgi-bin/cvsweb/interchange/?only_with_tag=STABLE_4_8-root
 	# However, entities for last version will, in addition to above,
-	# get a default entity &cvs-README;, and it will point to some particular
-	# version of cvs-head.
-	# $i{ver} that we will use here is X.Y.Z or 'cvs-head'.
+	# get a default entity (like &cvsfile-README;), and it will point to
+	# some particular version or cvs-head.
 
-	# First derive IC series (in format X_Y) and cvs tag for it.
-	# If we're in cvs-head, we don't do this
+	# First derive IC series_ (in format X_Y) and series (in format X.Y), 
+	# and cvs tag for non-cvs-head. (If we're in cvs-head, we don't do this
+	# since cvs-head has no special tag).
 	unless ( $i{ver} eq 'cvs-head' ) {
 		( $i{series_} = $i{ver} ) =~ s/\./_/; $i{series_} =~ s/\..*//;
 		( $i{series} = $i{series_} ) =~ s/_/./;
 		$i{cvstag} = "?only_with_tag=STABLE_$i{series_}-root";
 	} else {
+		$i{series_} = '';
 		$i{series} = '';
 		$i{cvstag} = '';
 	}