Re: [aj@xxxxxxxxxx: RE: [AD] [AL] docs, return values?]

[ Thread Index | Date Index | More lists.liballeg.org/allegro-developers Archives ]


On 2002-11-11, Grzegorz <gradha@xxxxxxxxxx> wrote:
> You can grab him now. Patch attached, includes documentation,
> a goto (they are so few of them that they deserve the attention),

Good work.  But don't you think it's weird to have the "See also" boxes
inside the "Return value" boxes?

> three redocumented functions to show the use in html and man pages,
> and yet another CSS color trick to make people vomit (just in case
> you haven't noticed, it's all to drive people to text browsers).

(Text browsers ought to support CSS too.)

> 
> Feel free to ignore the CSS part when applying.

Can it be left out?  The bold "Return value" marker is already easy for
the eye to find.  There's no need to make the return value paragraph
look like it is more important than the rest of the description.

-- 
王浩禎



Mail converted by MHonArc 2.6.19+ http://listengine.tuxfamily.org/