Tcl Source Code

some spelling and corrections to the docs of the Tcl 
built-in commands
See attached file (patch).

Affected files:
binary.n catch.n clock.n dde.n dict.n exec.n file.n 
format.n history.n http.n info.n lindex.n linsert.n 
lsearch.n lsort.n msgcat.n namespace.n pid.n registry.n 
socket.n trace.n

I'm not sure about the substitute 'http::whatever' 
with '::http::whatever' everywhere in the doc-file (just to 
be consistent across the whole file)
The same with the msgcat docs

Here is a comment on two 'bad ideas'(tm)

Plural form of punctuation symbols

namespace.n:
a)
Extra :s in a qualified name are ignored; that is, two or 
more :s are treated as a namespace separator.
b)
Qualifiers are namespace names separated by ::s.

let's continue the pattern. Here are some terrible plural 
forms: \s -s $s "s 's .s ?s %s ,s \ns %us []s hhs mms 
sses
:(

let ':' be a 'colon' and '::' - 'namespace separator' or 
just '::'
___________________________

Tcl built-in commands' NAMEs:

pid - Retrieve process id(s)
(means Retrieve process id or ids
or Retrieve process using a proc 'id',
which has single argument 's' (probably a string))

exec - Invoke subprocess(es)
(means Invoke subprocess or subprocesses
or Invoke a proc 'subprocess' having single argument
probably in Spanish (es = Espaniol))

let's continue:
glob - Return name(s) of file(s) that match(es) pattern(s)
:(

Logged In: YES 
user_id=80530


backport candidate?

Logged In: YES 
user_id=79902

Fixed and thanks.

I did not accept the alteration to dict.n or lindex.n which
were actually more correct as they stood. (e.g. dict.n was a
rare grammatical case where a double 'to' was justified
because one was linked with the preceding word instead of
being a linking word.)

File Added - 99600: docs_tcl_builtin.patch