[docs] docs - kwalsh modified ictags.sdf

[docs@interchange.redhat.com]

User:      kwalsh
Date:      2002-07-27 00:48:10 GMT
Modified:  .        ictags.sdf
Log:
	* The [PREFIX-pos] section seemed to talk more about the
	  [PREFIX-param] tag than its own subject.  I thought about
	  deleting a block of text, but it was all stragely relevent.
	  The other option was to add more text to try to correct the
	  balance, so I did that instead.

Revision  Changes    Path
1.94      +16 -6     docs/ictags.sdf


rev 1.94, prev_rev 1.93
Index: ictags.sdf
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /var/cvs/docs/ictags.sdf,v
retrieving revision 1.93
retrieving revision 1.94
diff -u -r1.93 -r1.94
--- ictags.sdf	26 Jul 2002 23:23:03 -0000	1.93
+++ ictags.sdf	27 Jul 2002 00:48:10 -0000	1.94
@@ -1,10 +1,10 @@
 !init OPT_LOOK=3D"akopia"; OPT_STYLE=3D"manual"=20
-# $Id: ictags.sdf,v 1.93 2002/07/26 23:23:03 kwalsh Exp $
+# $Id: ictags.sdf,v 1.94 2002/07/27 00:48:10 kwalsh Exp $
=20
 !define DOC_NAME "Interchange Tags Reference"
 !define DOC_TYPE ""
 !define DOC_CODE "ictags"
-!define DOC_VERSION substr('$Revision: 1.93 $', 11, -2)
+!define DOC_VERSION substr('$Revision: 1.94 $', 11, -2)
 !define DOC_STATUS "Draft"
 !define DOC_PROJECT "Interchange"
 !define DOC_URL "http://interchange.redhat.com/doc/ictags.html"
@@ -771,8 +771,8 @@
 whichever columns you wish.
=20
 E<lbracket>PREFIX-pos N] outputs the data from the I<N>th column as return=
ed
-(starting with 0).
-E<lbracket>{{C[jump=3D"#PREFIX-param"]prefix-param}}] lets you access the =
data
+(starting with zero).
+E<lbracket>{{C[jump=3D"#PREFIX-param"]PREFIX-param}}] lets you access the =
data
 by column name instead of by number.
=20
 In a E<lbracket>query ...] ITL tag you can select multiple return fields w=
ith
@@ -785,8 +785,18 @@
 In this case, E<lbracket>{{C[jump=3D"#PREFIX-code"]prefix-code}}]
 and E<lbracket>{{C[jump=3D"#PREFIX-param"]prefix-param}} foo] are synonyms,
 as C<foo> is the first returned parameter and becomes the code for this ro=
w.
-Another synonym is [prefix-pos 0]; and [prefix-pos 1] is the same as
-E<lbracket>{{C[jump=3D"#PREFIX-param"]prefix-param}} bar].
+Another synonym is [prefix-pos 0].  [prefix-pos 1] is the same as
+E<lbracket>{{C[jump=3D"#PREFIX-param"]prefix-param}} bar].  The following =
code
+will produce exactly the same output as the above:
+
+>    [query prefix=3Dprefix sql=3D"select foo, bar from baz where foo=3D'b=
uz'"]
+>        [prefix-pos 0]  [prefix-pos 0]  [prefix-pos 1]
+>    [/query]
+
+Note that if you use the [PREFIX-pos] tag, you may have to review your col=
umn
+numbers whenever you modify the columns you select.  For this reason, quer=
ies
+that make use of the E<lbracket>{{C[jump=3D"#PREFIX-param"]PREFIX-param}}]=
 tag
+may be easier to maintain and will be less prone to future surprises.
=20
 H2: PREFIX-price
=20