AMG: What is this? It's referenced on Hypnotoads Todo List.
aspect: it's a way to conserve memory when constant strings are used repeatedly in your code. Instead of each instance of the same string potentially allocating a duplicate Tcl_Obj, a pool is allocated and re-used.
Here's a script-level interpretation, logged in Dec 2014:
# hypnotoad @ comp.lang.tcl: # My application (The Integrated Recoverability Model) also builds giant dicts. # The only way I get around the computer eating itself alive is to re-use literals. # I do it in C, but on the Tcl level you could implement the following: proc literal VALUE { if {![info exists ::literal($VALUE)]} { set ::literal($VALUE) $VALUE } return $::literal($VALUE) } # When you build your dict: # dict set result {*}$path [literal $key] [literal $value] # # The technique allows a single Tcl_Obj* to represent every instance where the # same literal string value is used.
An extension doing the same thing can be found in odielib . The linked C file (quoting the toad) "is self contained and well behaved, so it should drop into anything else you are doing".