> > Nitpick: The lines in the DESCR go right up to 80 columns. I usually
> > prefer the results from running the DESCR through fmt(1)
> 
> It's formatted with fmt -w 80, which is in line with Porter's Handbook:
> "Lines should be no longer than 80 characters." If for some reason
> there is a consensus to stick to fewer characters, can we update the
> handbook accordingly?

there's not a hard "do not go right up to col.80" but many people
find longer lines a touch harder to read.

FWIW this one looks much better with 'fmt 76' than fmt's default
setting, and that also avoids a bit of the awkwardness (like the
dangling ", in" on line 1) given by 80.

(when I'm doing a DESCR I'll usually run through par and fmt with
a few different widths, and pick whatever flows most smoothly.
sometimes I'll get annoyed about par's stupid bugs too but it
usually makes things look nicer than fmt so I still usually try
it first ;-)

minor, s/QT/Qt/

Reply via email to