[davidw]: It would be nice to see at least a simple example included for all Tcl man pages (or at the very least point to another page including an example).

Here is the current state of things:
----
'''Files with examples:'''
 after.n    continue.n    foreach.n  lassign.n   namespace.n  seek.n
 append.n   dde.n         format.n   lindex.n    open.n       set.n
 array.n    encoding.n    gets.n     linsert.n   proc.n       socket.n
 bgerror.n  error.n       glob.n     list.n      puts.n       split.n
 binary.n   exec.n        global.n   llength.n   read.n       subst.n
 break.n    exit.n        http.n     lrange.n    regexp.n     switch.n
 catch.n    expr.n        if.n       lrepeat.n   registry.n   time.n
 cd.n       fconfigure.n  incr.n     lreplace.n  regsub.n     uplevel.n
 clock.n    fcopy.n       interp.n   lsearch.n   rename.n     upvar.n
 close.n    fileevent.n   join.n     lset.n      return.n     vwait.n
 concat.n   for.n         lappend.n  lsort.n     scan.n       while.n
'''Files without examples:''' 
 Tcl.n   fblocked.n  info.n     package.n     re_syntax.n  tclvars.n  unset.n
 case.n  file.n      library.n  packagens.n   safe.n       tell.n     update.n
 dict.n  filename.n  load.n     pid.n         source.n     trace.n    variable.n
 eof.n   flush.n     memory.n   pkgMkIndex.n  string.n     unknown.n
 eval.n  history.n   msgcat.n   pwd.n         tcltest.n    unload.n
----
These are automatically generated (script below).  Some of these do have examples, such as msgcat and tcltest.  Others sort of do, but a functional bit of code that runs and demonstrates the command is always welcome.

'''Exception List''': The list of files that really do have (good) examples: msgcat.n tcltest.n.

and the list of files that describe commands that are too simple to really need examples (or that have them elsewhere): cd.n close.n

The following files probably don't need an example: Tcl.n, case.n, filename.n, library.n, packagens.n, re_syntax.n, tclvars.n (and perhaps safe.n too)
----
Adding an example doesn't take much time, and lots are already available on the wiki.  All you have to do is submit a patch to sourceforge.  The man page markup looks like this:

 .SH "EXAMPLES"

 A time server:

 .CS
 proc Server { channel clientaddr clientport } {
     puts "Connection from $clientaddr registered"
     puts $channel [clock format [clock seconds]]
     close $channel
 }

 socket -server Server 9900
 vwait forever
 .CE


I used this code to check:

 package require fileutil
 package require struct

 foreach res [fileutil::grep ".SH.*EXAMPLE" [glob *.n]] {
     lappend examplefiles [lindex [split $res :] 0]
 }
 set examplefiles [lsort $examplefiles]

 set allfiles [lsort [glob *.n]]
 set noexamplefiles [lsort [struct::set difference $allfiles $examplefiles]]

 puts "Files with examples: $examplefiles"
 puts ""
 puts "Files without examples: $noexamplefiles"
----
[DKF]: Remember that some [Tk] docs need examples as well, though I'd tend to say not the widgets, as they're better demonstrated as part of the general [widget] demo.

----
[AM] What about Wiki pages that show a particular package in action? I mention it here because it seems a nice starting place for it ... For instance:
   * the http package is nicely illustrated with the page on the [wiki-reaper]
   * [A little Unicode editor] might serve as an illustration for dealing with Unicode 

[DKF]: I'm trying to keep examples ''very'' short.  Both of those pages are several times too long for my current limit.
----
[Category Documentation]