Hi Jan, Jan Stary wrote on Mon, Mar 05, 2012 at 04:46:26PM +0100:
> Attached is a port of audio/sox, bringing it to 14.4.0. > Tested on i386 and amd. > > make package complains: > > warning: file `man1/sox.1', around line 2667: table wider than line width > grotty:<standard input> (man1/sox.1):47303: character above first line > discarded These are *not* mandoc(1) glitches, but groff error messages produced by grotty(1). > Indeed, sox.1 includes this table that is too wide. > > What do? Shall I persuade upstream to wrap the lines > to make mandoc happy? Or provide a patch? (That would > be a good excuse to finally learn the man(doc) syntax.) Please don't, this is a tricky case and not the right place to start learning man(7) and tbl(7). Don't try to talk to upstream about so difficult stuff; making good recommendations upstream requires thorough knowledge in this case, which you don't appear to have yet. These pages exhibit groff bugs, mandoc bugs *and* questionable formatting - to talk to upstream, you must be able to tell apart the three classes of problems, or you would cause more confusion than help. Since groff(1) actually wraps the tables better than mandoc(1), even though it complains, i suggest to keep USE_GROFF and simply ignore the groff warnings in this particular case. Yours, Ingo
