Hello,
i just updated the Epydoc trunk to drop detail boxes for function, properties
and variables if all the details available are expressed in the summary.
When the summary is extracted from the docstring, an extra flag reports if the
docstring is longer than what returned in the summary (the test depends on the
used markup), in which case the extra box is required. The extra box is also
required if there is any field attached to the object (except the type/return
type, which fit on the summary line), or if the Python value has a long
representation.
I also changed what pyval_repr() returns: now it integrates both parsed and
introspected representations (the test used to be carried by the writers). The
value representation is now more consistent and the function is a good entry
point to refine the representation of Python values.
--
Daniele Varrazzo - Develer S.r.l.
http://www.develer.com
|
