Author fdrake
Recipients fdrake, georg.brandl, lukasz.langa, michael.foord, pitrou
Date 2010-09-04.04:37:25
SpamBayes Score 1.28633e-05
Marked as misclassified No
Message-id <1283575051.89.0.90970691293.issue9421@psf.upfronthosting.co.za>
In-reply-to
Content
The patch has been commited largely as-is (r84486).

I'm not happy with the documentation yet:

- Markup like this:

    .. method:: ConfigParser.getint(section, option, raw=False,
                [vars, default])

  doesn't sit well with me.  I'm going to dig around current practice
  a bit and discuss with Georg sometime over the next few days, and
  see how best to adjust that.

- Inclusion of references to internal names in the API docs, like this
  in the signatures:

    comment_prefixes=_COMPATIBLE

  is just bad form.  Again, we need a better way.  I suspect there is
  little if any considered precedent, so we'll come up with something.

Neither of these are blockers; we can adjust this independently of the
code and doocumentation content.  (It's not part of the feature.)

Leaving this issue open for the completion of these changes.
History
Date User Action Args
2010-09-04 04:37:33fdrakesetrecipients: + fdrake, georg.brandl, pitrou, michael.foord, lukasz.langa
2010-09-04 04:37:31fdrakesetmessageid: <1283575051.89.0.90970691293.issue9421@psf.upfronthosting.co.za>
2010-09-04 04:37:30fdrakelinkissue9421 messages
2010-09-04 04:37:26fdrakecreate