[issue29601] Need reST markup for enum types

2017-02-19 Thread Barry A. Warsaw

Barry A. Warsaw added the comment:

On Feb 20, 2017, at 12:03 AM, Fred L. Drake, Jr. wrote:

>Is there some special treatment you think should be given to specific enum
>values as well?

The only thing I thought about was optionally provide the enum item's value,
when that's useful.  Usually you shouldn't care what the item's value is, but
maybe sometimes you do, and in that case it would be nice if there was a way
to express that.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue29601] Need reST markup for enum types

2017-02-19 Thread Fred L. Drake, Jr.

Fred L. Drake, Jr. added the comment:

Is there some special treatment you think should be given to specific enum 
values as well?

--
nosy: +fdrake

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com



[issue29601] Need reST markup for enum types

2017-02-19 Thread Barry A. Warsaw

New submission from Barry A. Warsaw:

Over in https://github.com/python/cpython/pull/138 I noticed that we don't 
currently have markup for enum types.  While class:: is technically still 
correct, it's not helpful because the html documentation should render this as 
`Enum SafeUUID` not `class SafeUUID`.

--
assignee: docs@python
components: Documentation
messages: 288147
nosy: barry, berker.peksag, docs@python
priority: normal
severity: normal
status: open
title: Need reST markup for enum types
versions: Python 3.7

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com