CVS History for TIP #219

  Created for Andreas Kupries <andreas_kupries at users dot sf dot net>

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Added references to the companion TIPs, their Id's are now known.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Methods 'initalize' and 'watch' will always get full strings ('read',
  'write'), and never abbreviations.
  
  Method 'configure' broken up into 'configure', 'cget', and 'cgetall'.
  
  Method 'initialize'. Result value changed from nested list (version +
  list of methods) to plain list of methods. Versioning is through the
  method names. Clarified that this implies that the signature and
  semantics of 'initialize' are fixed forever, as the initial entrypoint
  the C level has to know to be able to determine all the rest.
  
  Switched from our choice of 'early binding' to use 'late binding'
  instead.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Added functions for the propagation of arbitrary Tcl error messages. Based on the TIP #220 functionality. Rewrote the specification of all methods (except 'watch').  It is now specified that error messages from the driver are propagated properly to the Tcl command which invoked the driver.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  cget and cgetall are either both supported, or neither.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Clarified behaviour of Tcl_ChannelSetInterpState
  when encountering a previously stored state.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Rewrote the API spec for error propagation.
  We have to store and retrieve data in/from both
  channels and interpreters, depending on the driver
  function.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Corect formatting errors.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  - Removal result code propagation from spec (Security hazard).
  - Clarified handling of break/continue from handler methods.
  - Clarified handling of ref coutns by the C API functions.
  - Clarified which driver functions may use which functions
    of the new API.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Removed reintroduced formatting errors.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  More misformatting corrected.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  And the last misformats.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Completed the error handling, wrote up effects of string bypass
  on the existing API.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Formatting fixes.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Correction of issues brought up by Kevin in his Review.
  - C Level API section was out-of-date
  - Changed error message to structured information
    (list, last element is message, option/value pairs
     coming before it).
  - Security precautions for this.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Removed unwanted abstract in body, small tuning of formatting.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Undo formatting reversal.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  More undo of bad reversals.

  Revision through web from Andreas Kupries <akupries at shaw dot ca>
  Again.

  Revision through web from  <akupries at shaw dot ca>
  Clarified NULL'ability of all arguments to the Tcl_{Set,Get}ChannelError[Interp] functions (They are not).

  Revision through web from  <akupries at shaw dot ca>
  Clarified that cmdprefix for 'chan create' is a list.
  Clarified that 'watch' ignores _all_ return values, whatever code.
  Clarified which methods have to be supported, always.

  Revision through web from  <akupries at shaw dot ca>
  Reworded refCount handling for SetChannelError(Interp).
  Reworded handling of -level, -code.

  Revision through web from  <akupries at shaw dot ca>
  Fixed typos

  CFV by AKu. Closes [clock format 1124478000]

  Accepted 3/0/2
  For: AKu, JH, DKF
  Against: None
  Present MS, DRH

  Implemented

  Minor change: Formatting and cross-linking-to-other-TIPs.