[interchange-docs] xmldocs - docelic modified 3 files

docs at icdevgroup.org docs at icdevgroup.org
Wed Mar 29 16:17:15 EST 2006


User:      docelic
Date:      2006-03-29 21:17:15 GMT
Modified:  .        TODO
Modified:  bin      refs-autogen
Modified:  docbook  literals.ent
Log:
* bin/refs-autogen: another place for improvement. Namely, if the item
  is present in cvs-head, then add " (cvs-head)" to "Available in: " line.
  (Otherwise it would just say like 5.5.0, but you don't know if 5.5.0 is
  current latest or not).

  Or maybe you do know because if it has odd 2nd number, then it must be
  development version and the last one, because we only index last devel.
  But nevertheless, it does add information and is a nice eye candy too.

* docbook/literals.ent: 3 more entities: CPAN, GCC, SOAP

* TODO: Add some todo items from old docs (unimportant for now, until I get to
  review them and clean up)

Revision  Changes    Path
1.84      +36 -0     xmldocs/TODO


rev 1.84, prev_rev 1.83
Index: TODO
===================================================================
RCS file: /var/cvs/xmldocs/TODO,v
retrieving revision 1.83
retrieving revision 1.84
diff -u -r1.83 -r1.84
--- TODO	24 Mar 2006 22:29:59 -0000	1.83
+++ TODO	29 Mar 2006 21:17:14 -0000	1.84
@@ -168,3 +168,39 @@
 
 
 Check CartTrigger[Quantity]
+
+
+
+Community-contributed usertags (was usertag.pod before 4.7.0; too messy)
+icstart - Getting Started Guide
+* FAQ for each demo catalog (foundation, construct, barry, artstore)
+* FAQ for each database (DBM, MySQL, PostgreSQL, Oracle)
+* FAQ for each payment processor (CCVS, Cybercash, Signio, Authorize.net, etc.)
+
+
+
+$Session->{source} bzw. [data session source] comes from:
+
+http://host/cgi-bin/cat?;;thesource      (old MV 3 way, still works)
+http://host/cgi-bin/cat?mv_pc=thesource  (current way)
+http://host/cgi-bin/cat?mv_pc=RESET      (clears it, for debugging)
+
+Otherwise mv_pc does double duty as a cache foiler, and is a meaningless,
+incrementing integer.
+
+-----------------------------------------------------------------------------
+
+iccattut:
+Switch to new payment settings instead of mv_cyber_mode etc.
+To add
+Discuss profile.order verification options like 'zip=zip' and then explain why we don't actually use that one much unless it's for a U.S.-only store
+Problems?
+[on-match] gets used if search returned no results on an empty search string. Why?
+Doubled-up CC verification errors:
+No error message is given in [error] if required form variables weren't passed at all (vs. being simply empty)
+No error message if profiles.order can't be found
+
+Discuss using images (from old mvdocs):
+A public Web directory for inline image graphic files is needed. Interchange does not serve the images, only the HTML tags calling them. A useful convention is to place all buttonbars, backgrounds, and icons in the /images directory, with the catalog items located in the /images/catalog directory. Regardless of the directory structure, an I<absolute path> must be used. Relative paths are unacceptable. Use the I<ImageDir> directive, which places that as the absolute path in front of all relative IMG and INPUT SRC, and BODY, TABLE, TR, TH, and TD BACKGROUND specifications.
+
+



1.106     +11 -1     xmldocs/bin/refs-autogen


rev 1.106, prev_rev 1.105
Index: refs-autogen
===================================================================
RCS file: /var/cvs/xmldocs/bin/refs-autogen,v
retrieving revision 1.105
retrieving revision 1.106
diff -u -r1.105 -r1.106
--- refs-autogen	28 Mar 2006 13:19:41 -0000	1.105
+++ refs-autogen	29 Mar 2006 21:17:15 -0000	1.106
@@ -722,7 +722,8 @@
 #	DocBook strips non-text stuff when creating TOC entries. So under symbol
 #	names you see a nice NEW icon, but in TOC that plain text looks very poor.
 	if ( @{ $ag{'_available in'} } == 1 and
-			${$ag{'_available in'}}[0] eq $ENV{XMLDOCS_CUR_DEVEL}) {
+			( ${$ag{'_available in'}}[0] eq $ENV{XMLDOCS_CUR_DEVEL} or
+			${$ag{'_available in'}}[0] eq 'cvs-head' )) {
 		$ag{purpose} = <<ENDD;
 <inlinemediaobject>
 <imageobject>
@@ -1245,6 +1246,15 @@
 			last
 		}
 	}
+
+	# If last version that symbol is available in is also the current
+	# cvs-head (so meaning the item is fully current), then visually 
+	# add "(cvs-head)" to the version number. Makes it easier to see
+	# the item is current.
+	$end and $end eq $ENV{XMLDOCS_CUR_DEVEL} and $end .= " (cvs-head)";
+	@orig == 1 and $orig[0] eq $ENV{XMLDOCS_CUR_DEVEL} and
+		$orig[0] .= " (cvs-head)";
+	
 	local $" = ", ";
 	if ( $cl > 1 ) {
 		unshift @avails, "$start-$end";



1.33      +3 -0      xmldocs/docbook/literals.ent


rev 1.33, prev_rev 1.32
Index: literals.ent
===================================================================
RCS file: /var/cvs/xmldocs/docbook/literals.ent,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- literals.ent	27 Mar 2006 09:33:29 -0000	1.32
+++ literals.ent	29 Mar 2006 21:17:15 -0000	1.33
@@ -17,6 +17,8 @@
 <!ENTITY W3 "<ulink url='http://www.w3c.org/'>W3C</ulink>">
 <!ENTITY W3C "<ulink url='http://www.w3c.org/'>W3C</ulink>">
 <!ENTITY PERL "<ulink url='http://www.perl.org/'>Perl</ulink>">
+<!ENTITY CPAN "<ulink url='http://www.cpan.org/'>CPAN</ulink>">
+<!ENTITY GCC "<ulink url='http://gcc.gnu.org/'>GCC</ulink>">
 <!ENTITY MYSQL "<ulink url='http://www.mysql.com/'>MySQL</ulink>">
 <!ENTITY PGSQL "<ulink url='http://www.postgresql.org/'>PostgreSQL</ulink>">
 <!ENTITY ORACLE "<ulink url='http://www.oracle.com/'>Oracle</ulink>">
@@ -30,6 +32,7 @@
 <!ENTITY EBAY "<ulink url='http://www.ebay.de/'>ebay.de</ulink>">
 <!ENTITY SVG "<ulink url='http://www.w3.org/TR/SVG/'>SVG</ulink>">
 <!ENTITY QBOOKS "<ulink url='http://quickbooks.intuit.com/'>Intuit QuickBooks</ulink>">
+<!ENTITY SOAP "<ulink url='http://www.w3.org/TR/soap/'>SOAP</ulink>">
 
 
 








More information about the docs mailing list