[New-bugs-announce] [issue9650] format codes in time.strptime docstrings

[Catherine Devlin]

New submission from Catherine Devlin <fredv8vibwc at liquidid.net>:

Is there any reason not to include the strftime formatting codes in the docstrings of time.strftime and time.strptime? 

>>> print time.strftime.__doc__
strftime(format[, tuple]) -> string

Convert a time tuple to a string according to a format specification.
See the library reference manual for formatting codes. When the time tuple is not present, current time as returned by localtime() is used.


Sending users to look up such a basic, frequently-used, hard-to-remember set of codes in the docs every single time seems unfriendly.  Even a tightly abbreviated list would be very convenient.

----------
components: Library (Lib)
messages: 114427
nosy: catherine
priority: normal
severity: normal
status: open
title: format codes in time.strptime docstrings
type: feature request
versions: Python 3.2

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue9650>
_______________________________________