[Python-Dev] Documenting enum types (original) (raw)
Victor Stinner victor.stinner at gmail.com
Thu Aug 14 11:25:06 CEST 2014
- Previous message: [Python-Dev] Documenting enum types
- Next message: [Python-Dev] Documenting enum types
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
Hi,
IMO we should not document enum types because Python implementations other than CPython may want to implement them differently (ex: not all Python implementations have an enum module currently). By experience, exposing too many things in the public API becomes a problem later when you want to modify the code.
Victor Le 14 août 2014 07:47, "Serhiy Storchaka" <storchaka at gmail.com> a écrit :
Should new enum types added recently to collect module constants be documented at all? For example AddressFamily is absent in socket.all [1].
[1] http://bugs.python.org/issue20689
Python-Dev mailing list Python-Dev at python.org https://mail.python.org/mailman/listinfo/python-dev Unsubscribe: https://mail.python.org/mailman/options/python-dev/ victor.stinner%40gmail.com -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://mail.python.org/pipermail/python-dev/attachments/20140814/bd818dec/attachment.html>
- Previous message: [Python-Dev] Documenting enum types
- Next message: [Python-Dev] Documenting enum types
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]