[Epydoc-devel] Uninformative boxes dropped

[Daniele V. <pi...@de...>]

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