Author martin.panter
Recipients Antony.Lee, docs@python, martin.panter
Date 2016-01-30.07:02:34
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1454137354.88.0.550610978725.issue26240@psf.upfronthosting.co.za>
In-reply-to
Content
IMO the doc strings should be reduced down so that it is a concise summary, and divided or merged into doc strings of each class, method, function. Less important details should be moved to the main RST documentation (if they aren’t already there).

Regarding list2cmdline(), see the comment next to __all__ in the source code, and Issue 11827. BTW modifying __all__ would not automatically affect what is written in the RST files, which is where the “official” HTML docs come from :)
History
Date User Action Args
2016-01-30 07:02:34martin.pantersetrecipients: + martin.panter, docs@python, Antony.Lee
2016-01-30 07:02:34martin.pantersetmessageid: <1454137354.88.0.550610978725.issue26240@psf.upfronthosting.co.za>
2016-01-30 07:02:34martin.panterlinkissue26240 messages
2016-01-30 07:02:34martin.pantercreate