[docs] docs - heins modified ictags.sdf

docs at icdevgroup.org docs at icdevgroup.org
Mon Aug 4 02:20:00 EDT 2003

User:      heins
Date:      2003-08-04 05:20:25 GMT
Modified:  .        ictags.sdf
* Add documentation for date-based counter behavior.

Revision  Changes    Path
1.112     +24 -6     docs/ictags.sdf

rev 1.112, prev_rev 1.111
Index: ictags.sdf
RCS file: /anon_cvs/repository/docs/ictags.sdf,v
retrieving revision 1.111
retrieving revision 1.112
diff -u -r1.111 -r1.112
--- ictags.sdf	8 Jul 2003 19:12:59 -0000	1.111
+++ ictags.sdf	4 Aug 2003 05:20:25 -0000	1.112
@@ -1,10 +1,10 @@
 !init OPT_LOOK="icdevgroup"; OPT_STYLE="manual" 
-# $Id: ictags.sdf,v 1.111 2003/07/08 19:12:59 mheins Exp $
+# $Id: ictags.sdf,v 1.112 2003/08/04 05:20:25 mheins Exp $
 !define DOC_NAME "Interchange Tags Reference"
 !define DOC_TYPE ""
 !define DOC_CODE "ictags"
-!define DOC_VERSION substr('$Revision: 1.111 $', 11, -2)
+!define DOC_VERSION substr('$Revision: 1.112 $', 11, -2)
 !define DOC_STATUS "Draft"
 !define DOC_PROJECT "Interchange"
 !define DOC_URL "http://www.icdevgroup.org/doc/ictags.html"
@@ -3621,9 +3621,9 @@
 H3: Summary
-\Parameters: B<file>
+\Parameters: B<file start date sql>
-Positional parameters in same order.
+\Positional parameters: B<file>
 Invalidates cache: B<YES>
@@ -3636,6 +3636,7 @@
 >         file => VALUE,
 >         sql => VALUE,
 >         start => VALUE,
+>         date => 'local' || 'gmt',
 >        }
 >    )
@@ -3659,6 +3660,12 @@
 Alias for file
+Asserts a SQL-based counter
+Asserts a date-based counter
 !block table; colvaligns="TT"
@@ -3706,14 +3713,17 @@
 The counter value is stored in the specified file. If the file name begins with a "/" then it is an absolute path. Otherwise, it is relative to VendRoot. The default file is C<etc/counter>. If the file does not exist, it is created and initialized to the value of the C<start> parameter.
-The counter is implemented using Perl's C<File::Counter> module, which protects the file against simultaneous access by multiple processes.
 If the optional C<sql> attribute is used, a SQL sequence will be used. Currently
 MySQL and Postgres are supported. The sequence must already exist. If no C<bypass>
 parameter is sent, the table in the sequence callout (explained below) will be used
 and must be an Interchange table (i.e. set up with Database setting). If C<bypass>
 is set, then the DSN for the sequence will be passed in the C<dsn> parameter.
+If the optional C<date> attribute is used, a date-based counter will be made.
+It takes the form of the date in YYYYMMDD followed by the C<start> value, by
+default C<0001>. When the date changes, the counter will flip over to the
+next day and the beginning C<start> value.
 \WARNING: This tag may not work under {{CMD[jump="http://www.perl.com/pub/doc/manual/html/lib/Safe.html"]Safe}}, i.e. in embedded Perl.
 Additional parameters:
@@ -3745,6 +3755,14 @@
 If the type of database is MySQL, an AUTO_INCREMENT key column is
 assumed and an insert of C<0> followed by "select last_insert_id()" will
 increment then access the counter.
+H4: {{CMD[id="counter_date"]date="local"}}
+Specifies the counter will be date-based with local time.
+H4: {{CMD[id="counter_date"]date="gmt"}}
+Specifies the counter will be date-based with GMT.
 # BEGIN ########### counter Subsections ##############
 H4: {{CMD[id="counter_file"]file}}

More information about the docs mailing list