Bugs item #1185124, was opened at 2005-04-18 05:18 Message generated for change (Comment added) made by ping You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1185124&group_id=5470
Category: Python Library Group: Python 2.4 Status: Open Resolution: None Priority: 5 Submitted By: Kent Johnson (kjohnson) Assigned to: Ka-Ping Yee (ping) Summary: pydoc doesn't find all module doc strings Initial Comment: pydoc.synopsis() attempts to find a module's doc string by parsing the module text. But the parser only recognizes strings created with """ and r""". Any other docstring is ignored. I've attached a patch against Python 2.4.1 that fixes pydoc to recognize ''' and r''' strings but really it should recognize any allowable string format. ---------------------------------------------------------------------- >Comment By: Ka-Ping Yee (ping) Date: 2005-04-18 11:23 Message: Logged In: YES user_id=45338 PEP 257 recommends: "For consistency, always use """triple double quotes""" around docstrings." I think that's why this was originally written to only look for triple double-quotes. Are there a large number of modules written using triple-single quotes for the module docstring? ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1185124&group_id=5470 _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
