TIP #209: ADD [CLOCK MILLISECONDS], AND [CLOCK MICROSECONDS] ============================================================== Version: $Revision: 1.5 $ Author: Reinhard Max State: Final Type: Project Tcl-Version: 8.5 Vote: Done Created: Monday, 12 July 2004 URL: https://tip.tcl-lang.org209.html Post-History: ------------------------------------------------------------------------- ABSTRACT ========== This TIP proposes to replace *clock clicks -milliseconds* by *clock milliseconds* and *clock clicks -microseconds* by *clock microseconds*. PROPOSED CHANGE ================= 1. Rename the *clock clicks -microseconds* command as defined by [TIP #124] to *clock microseconds*. 2. Deprecate *clock clicks -milliseconds*, and make it's functionality as defined by [TIP #124] available as *clock milliseconds*. RATIONALE =========== In the author's understanding, the whole purpose of the *clock clicks* name was to indicate that the returned value is neither absolute nor guaranteed to have the same unit on different platforms. With the changes of [TIP #124] in place both cases are not true anymore. Therefore the commands to return absolute timestamps with millisecond and microsecond resolution should be on the same level as *clock seconds* rather than being switches to *clock clicks*. The *-microseconds* option can be removed from *clock clicks* immediately, because it never has been part of an official Tcl release while *-milliseconds* has to be kept at least until the next major release for backwards compatibility. REFERENCE IMPLEMENTATION ========================== A reference implementation has been added to the Tcl patch tracker at SourceForge, item #991742 . COPYRIGHT =========== This document has been placed in the public domain. ------------------------------------------------------------------------- TIP AutoGenerator - written by Donal K. Fellows