[docs] tuple or struct_time

Georg Brandl georg at python.org
Mon Jan 3 19:40:35 CET 2011


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 03.01.2011 19:35, schrieb Alexander Belopolsky:
> Functions in the time module that expect broken down time are
> currently documented as accepting "tuple or struct_time".  For
> example,
> 
> http://docs.python.org/py3k/library/time.html#time.strftime
> 
> However, in recent versions, ".. or struct_time" is redundant because
> 
>>>> issubclass(time.struct_time, tuple)
> True
> 
> I think it would be more informative for a reader to change "tuple or
> struct_time" to "9-tuple".

I don't think so -- the reader may not be aware of that subclass
relationship, and the repr() of struct_time also doesn't make that
clear (which is anyway not its job).  It certainly doesn't hurt to
be a little helpful here.

Georg
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.16 (GNU/Linux)

iEYEARECAAYFAk0iGCMACgkQN9GcIYhpnLDmKQCePKov8SmLcA1zs1TXXiBNqD+O
A1oAnie+elSLWddJK4HYVx0M9hL2tP0j
=MjyU
-----END PGP SIGNATURE-----


More information about the docs mailing list