[Doc-SIG] library reference contents

Ka-Ping Yee ping@lfw.org
Sun, 26 Mar 2000 01:45:27 -0800 (PST)


The contents page of the Library Reference has a few warts:
    
  - A few section headers (e.g. operator, pprint, repr) end in
    periods that probably ought to be deleted.  (Complete list:
    3.5, 3.23, 3.24, 3.27, 3.32, 4.2, 4.3, 4.5, 5.10, 6.13, 6.15,
    7.1, 7.6, 11.11, 11.12, 11.13, 12.13, 12.14, 14.9, 14.10, 15.4.)

  - Description of 3.28 "new" doesn't make much sense: "runtime
    implementation object creation" (probably you want to
    replace "implementation" with "instance")

  - Description of 4.3 "regex" should probably say "old" or
    "deprecated".

  - Description of 6.12 "curses" has a spelling mistake:
    "Terminal independant (sic) console handling".

  - Description of 7.14 "rlcompleter" probably ought to say
    "Completion function for GNU readline".

  - Descriptions of 11.14 "SimpleHTTPServer" and 11.15
    "CGIHTTPServer" seem strange: "A Do-Something Request Handler".
    Suggest "11.14 SimpleHTTPServer -- A simple HTTP request handler"
    and "11.16 CGIHTTPServer -- A CGI-capable HTTP request handler".

Hope this helps.



-- ?!ng

"I'm not trying not to answer the question; i'm just not answering it."
    -- Lenore Snell