[TCLCORE] TIP 308 to be updated.

[Kevin K. <kk...@ny...>]

I've sent another batch of changes to Donal for inclusion in TIP #308.
Most of them are editorial, but there are a few that reviewers should
be aware of:

(1) The 'nextrow' method on result sets has been split into two:
       $resultset nextlist variableName
and   $resultset nextdict variableName

The 'nextrow' method, as specified in the TIP, is retained, but
database interfaces need not implement it. It is implemented in the
'tdbc::resultset' base class and delegates to the 'nextlist' or
'nextdict' method of the derived class as appropriate.  This change
saves implementors of database interfaces one round of -option
parsing.

(2) The 'transaction' method on database connections has had its
     handling of unusual status codes simplified:
       TCL_OK, TCL_BREAK, TCL_CONTINUE, TCL_RETURN: Commit the
           transaction and rethrow.
       TCL_ERROR, anything else: Rollback the transaction and
           rethrow.
     No attempt is made to decode return options on TCL_RETURN;
     the TIP warns that scripts should not 'return -code',
     'return -level' or 'return -options' to escape from a
     transaction, but that if they do, the transaction is committed.

(3) [db tables] and [db columns] were elevated to MUST.

(4) The return values for [db configure] were rationalized; it
     now returns configuration options in a parallel way to what
     [fconfigure] does.

The TIP should be on the site when Donal gets it there. I wasn't
able to do it with the 'edit' interface because the TIP content
fails to clear the spam filter.

I still plan to call the vote in the coming week, but will wait
at least 48 hours after Donal confirms updating the TIP.

-- 
73 de ke9tv/2, Kevin