> > 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/