[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: description writing guide

On Wed, 2002-12-04 at 18:55, Daniel Burrows wrote:

>   That might be true, but I would like to see language such as "best
> package for foo" explicitly deprecated in the guide.  I've even written
> such stuff myself, back before I realized what the problems were.
> (hopefully there isn't anything like that left in my packages :) )

Ok, done.

>   On an unrelated topic, it would be nice if the description format
> allowed whitespace to be collapsed/expanded on wordwrapped lines.  The last
> time I checked, it seemed to at least imply that whitespace was sancrosact,
> and I found several packages that relied on this in their description.
> (sorry, I don't remember which)

I think this is hard to without switching to a format which allows us to
include more metadata (like XML).  So we can explicitly use stuff like
<ul> and <li> for lists, instead of relying on ASCII renderings.  That
way we can safely word-wrap the description, instead of just treating it
as the equivalent of <pre>.

Reply to: