[docs] docs - heins modified 3 files
docs@interchange.redhat.com
docs@interchange.redhat.com
Mon Jul 15 09:53:00 2002
User: heins
Date: 2002-07-15 13:52:17 GMT
Modified: . icdatabase.sdf ictags.sdf ictemplates.sdf
Log:
* Undocument range searching, obsoleted by coordinated search.
Revision Changes Path
1.47 +2 -56 docs/icdatabase.sdf
rev 1.47, prev_rev 1.46
Index: icdatabase.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: /anon_cvs/repository/docs/icdatabase.sdf,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -r1.46 -r1.47
--- icdatabase.sdf 25 Jun 2002 20:15:00 -0000 1.46
+++ icdatabase.sdf 15 Jul 2002 13:52:15 -0000 1.47
@@ -1,10 +1,10 @@
!init OPT_LOOK=3D"akopia"; OPT_STYLE=3D"manual"
-# $Id: icdatabase.sdf,v 1.46 2002/06/25 20:15:00 mheins Exp $
+# $Id: icdatabase.sdf,v 1.47 2002/07/15 13:52:15 mheins Exp $
=20
!define DOC_NAME "Interchange Databases"
!define DOC_TYPE ""
!define DOC_CODE "icdatabase"
-!define DOC_VERSION substr('$Revision: 1.46 $',11, -2)
+!define DOC_VERSION substr('$Revision: 1.47 $',11, -2)
!define DOC_STATUS "Draft"
!define DOC_PROJECT "Interchange"
!define DOC_URL "http://interchange.redhat.com/doc/icdatabase.html"
@@ -1076,37 +1076,6 @@
</a>
!endblock
=20
-H2: Range Searching
-
-Range searching allows qualification of search returns with a field that m=
ust be within a certain numeric or alphanumeric range. To use it, set the C=
<mv_range_look> variable to the products database field, or a column/field =
number for another file. Then, set the corresponding C<mv_range_min> and C<=
mv_range_max> variables with a selectable field.
-
-!block example
- <INPUT TYPE=3D"hidden" NAME=3D"mv_range_look" VALUE=3D"price">
- Search on Price
- Min <SELECT NAME=3D"mv_range_min">
- <OPTION value=3D0 SELECTED> Free
- <OPTION value=3D1000000> $1,000,000
- <OPTION value=3D10000000> $10,000,000
- <OPTION value=3D20000000> $20,000,000
- <OPTION value=3D40000000> $40,000,000
- </SELECT><BR>
- Max <SELECT NAME=3D"mv_range_max">
- <OPTION value=3D0 SELECTED> no object
- <OPTION value=3D1000000> $1,000,000
- <OPTION value=3D10000000> $10,000,000
- <OPTION value=3D20000000> $20,000,000
- <OPTION value=3D40000000> $40,000,000
- </SELECT>
-!endblock
-
-The value of 0 for C<mv_range_max> is equivalent to infinity if doing a nu=
meric search. This makes it impossible to search for a ceiling of 0 with a =
negative C<mv_range_min>.
-
-The fields are stackable, so more than one range to check can be set. The =
order is significant, in the sense that the array of field names and minimu=
m/maximum values must be kept in order to achieve correspondence.
-
-The optional C<mv_range_alpha> specification allows alphanumeric range mat=
ching for the corresponding field. If it is set, and the fields are stacked=
, they must all be set. The C<mv_case> field does apply if it is set. Other=
wise, the comparison is without regard to case.
-
-If ONLY a range search is required, all lines with C<mv_return_all>=3Dyes =
must be selected in order to make the search operate. Range-only searches w=
ill be quite slow for large databases since every line must be scanned. It =
should be quite usable for catalogs of less than 10,000 items in size on a =
fast machine. Using it in combination with another search technique (in the=
same query) will yield faster search returns.
-
H2: One-Click Searches
=20
Interchange allows a search to be passed in a URL, as shown above. Just sp=
ecify the search with the special page parameter search or special page C<s=
can>. Here is an example:
@@ -1184,13 +1153,9 @@
ra mv_return_all
rd mv_return_delim
rf mv_return_fields
- rg mv_range_alpha
- rl mv_range_look
- rm mv_range_min
rn mv_return_file_name
rr mv_return_reference
rs mv_return_spec
- rx mv_range_max
se mv_searchspec
sf mv_search_field
sg mv_search_group
@@ -1380,9 +1345,6 @@
!block example
mv_dict_look
mv_searchspec
- mv_range_look
- mv_range_min
- mv_range_max
!endblock
=20
Other than that, if C<mv_last> is set in a search profile, and there are o=
ther variables on the search form, they will not be interpreted.
@@ -1565,22 +1527,6 @@
LI1: mv_profile
=20
.Selects one of the pre-defined search specifications set by the C<SearchP=
rofile> directive. If the special variable within that file, C<mv_last>, is=
defined, it will prevent the scanning of the form input for further search=
modifications. The values of C<mv_searchspec> and C<mv_dict_look> are alwa=
ys scanned, so specify this to do the equivalent of setting multiple checkb=
oxes or radioboxes with one click, while still reading the search input tex=
t.
-
-LI1: mv_range_alpha
-
-.Sets the type of match, numeric or alphanumeric, for the range search in =
its corresponding range field. The search will return true, assuming it is =
greater than the C<mv_range_min> specification, if the field searched is le=
ss than or equal to C<mv_range_max>, in an alphanumeric sense.
-
-LI1: mv_range_look
-
-.This sets a field to scan for a range of numbers. It must be accompanied =
with corresponding C<mv_range_min> and C<mv_range_max> variables. It can be=
specified with either a field name or a column number.
-
-LI1: mv_range_max
-
-.Sets the high bound for the range search in its corresponding range field=
The search will return true, assuming it is greater than the C<mv_range_m=
in> specification, if the field searched is less than or equal to C<mv_rang=
e_max>. To set the bound at infinity, or whatever your integer limit is, se=
t C<mv_range_min> to 0.
-
-LI1: mv_range_min
-
-.Sets the low bound for the range search in its corresponding range field.=
The search will return true, assuming it is less than the C<mv_range_max> =
specification, if the field searched is less than or equal to C<mv_range_mi=
n>.
=20
LI1: mv_record_delim
=20
1.92 +2 -10 docs/ictags.sdf
rev 1.92, prev_rev 1.91
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: /anon_cvs/repository/docs/ictags.sdf,v
retrieving revision 1.91
retrieving revision 1.92
diff -u -r1.91 -r1.92
--- ictags.sdf 12 Jul 2002 17:17:15 -0000 1.91
+++ ictags.sdf 15 Jul 2002 13:52:15 -0000 1.92
@@ -1,10 +1,10 @@
!init OPT_LOOK=3D"akopia"; OPT_STYLE=3D"manual"=20
-# $Id: ictags.sdf,v 1.91 2002/07/12 17:17:15 kwalsh Exp $
+# $Id: ictags.sdf,v 1.92 2002/07/15 13:52:15 mheins Exp $
=20
!define DOC_NAME "Interchange Tags Reference"
!define DOC_TYPE ""
!define DOC_CODE "ictags"
-!define DOC_VERSION substr('$Revision: 1.91 $', 11, -2)
+!define DOC_VERSION substr('$Revision: 1.92 $', 11, -2)
!define DOC_STATUS "Draft"
!define DOC_PROJECT "Interchange"
!define DOC_URL "http://interchange.redhat.com/doc/ictags.html"
@@ -16688,10 +16688,6 @@
{{CMD[id=3D"mv_order_subject"]mv_order_subject}}||O|Sets the subject line =
of order email
{{CMD[id=3D"mv_orsearch"]mv_orsearch}}|os|S|Selects AND/OR of search words
{{CMD[id=3D"mv_profile"]mv_profile}}|mp|S|Selects search profile
-{{CMD[id=3D"mv_range_alpha"]mv_range_alpha}}|rg|S|Sets alphanumeric range =
searching
-{{CMD[id=3D"mv_range_look"]mv_range_look}}|rl|S|Sets the field to do a ran=
ge check on
-{{CMD[id=3D"mv_range_max"]mv_range_max}}|rx|S|Upper bound of range check
-{{CMD[id=3D"mv_range_min"]mv_range_min}}|rm|S|Lower bound of range check
{{CMD[id=3D"mv_record_delim"]mv_record_delim}}|dr|S|Search index record de=
limiter
{{CMD[id=3D"mv_return_all"]mv_return_all}}|ra|S|Return all lines found (su=
bject to range search)
{{CMD[id=3D"mv_return_delim"]mv_return_delim}}|rd|S|Return record delimiter
@@ -16773,13 +16769,9 @@
ra|{{CMD[jump=3D"#mv_return_all"]mv_return_all}}
rd|{{CMD[jump=3D"#mv_return_delim"]mv_return_delim}}
rf|{{CMD[jump=3D"#mv_return_fields"]mv_return_fields}}
-rg|{{CMD[jump=3D"#mv_range_alpha"]mv_range_alpha}}
-rl|{{CMD[jump=3D"#mv_range_look"]mv_range_look}}
-rm|{{CMD[jump=3D"#mv_range_min"]mv_range_min}}
rn|{{CMD[jump=3D"#mv_return_file_name"]mv_return_file_name}}
rr|{{CMD[jump=3D"#mv_return_reference"]mv_return_reference}}
rs|{{CMD[jump=3D"#mv_return_spec"]mv_return_spec}}
-rx|{{CMD[jump=3D"#mv_range_max"]mv_range_max}}
se|{{CMD[jump=3D"#mv_searchspec"]mv_searchspec}}
sf|{{CMD[jump=3D"#mv_search_field"]mv_search_field}}
si|{{CMD[jump=3D"#mv_search_immediate"]mv_search_immediate}}
1.40 +2 -6 docs/ictemplates.sdf
rev 1.40, prev_rev 1.39
Index: ictemplates.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: /anon_cvs/repository/docs/ictemplates.sdf,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -r1.39 -r1.40
--- ictemplates.sdf 22 Jun 2002 15:19:02 -0000 1.39
+++ ictemplates.sdf 15 Jul 2002 13:52:16 -0000 1.40
@@ -1,10 +1,10 @@
!init OPT_LOOK=3D"akopia"; OPT_STYLE=3D"manual"
-# $Id: ictemplates.sdf,v 1.39 2002/06/22 15:19:02 edl Exp $
+# $Id: ictemplates.sdf,v 1.40 2002/07/15 13:52:16 mheins Exp $
=20
!define DOC_NAME "Template Guide"
!define DOC_TYPE ""
!define DOC_CODE "ictemplates"
-!define DOC_VERSION substr('$Revision: 1.39 $',11, -2)
+!define DOC_VERSION substr('$Revision: 1.40 $',11, -2)
!define DOC_STATUS "Draft"
!define DOC_PROJECT "Interchange"
!define DOC_URL "http://interchange.redhat.com/doc/ictemplates.html"
@@ -2352,10 +2352,6 @@
mv_order_subject O Sets the subject line of order email
mv_orsearch os S Selects AND/OR of search words
mv_profile mp S Selects search profile
-mv_range_alpha rg S Sets alphanumeric range searching
-mv_range_look rl S Sets the field to do a range check on
-mv_range_max rx S Upper bound of range check
-mv_range_min rm S Lower bound of range check
mv_record_delim dr S Search index record delimiter
mv_return_all ra S Return all lines found (subject to range sear=
ch)
mv_return_delim rd S Return record delimiter