Issues

Issue #431 resolved

autodoc: a more compact way to document static members

Anonymous created an issue

A fairly coding style is to put comments on the same line as variable/attribute definition:

{{{

!python

class Bits: SOFT_RESET = 0x01 #: comment for SOFT HARD_RESET = 0x02 #: comment for HARD

}}}

The major advantage of this style is its compactness.

I think it would be very useful to support this style in autodoc? (Currently autodoc wants special comments to be put on a separate line, which essentially doubles the size of the code)

Comments (5)

  1. Log in to comment