From: SourceForge.net <no...@so...> - 2004-08-29 09:40:25
|
Patches item #1018486, was opened at 2004-08-29 12:40 Message generated for change (Tracker Item Submitted) made by Item Submitter You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=310894&aid=1018486&group_id=10894 Category: None Group: None Status: Open Resolution: None Priority: 5 Submitted By: Mikhail Kolesnitchenko (mkolesn) Assigned to: Nobody/Anonymous (nobody) Summary: spelling of docs of 'Tcl built-in commands' Initial Comment: 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) :( ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=310894&aid=1018486&group_id=10894 |