Re: sox-14.4.0 - mandoc glitches
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
sox-14.4.0 - mandoc glitches
Attached is a port of audio/sox, bringing it to 14.4.0. Tested on i386 and amd. make package complains: warning: file `man1/play.1', around line 2667: table wider than line width grotty:standard input (man1/play.1):47303: character above first line discarded warning: file `man1/rec.1', around line 2667: table wider than line width grotty:standard input (man1/rec.1):47303: character above first line discarded 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 warning: file `man7/soxeffect.7', around line 2667: table wider than line width grotty:standard input (man7/soxeffect.7):47303: character above first line discarded Indeed, sox.1 includes this table that is too wide. (source:) as detailed in the following table: .ne 6 .TS center; lB lw52. \-M/\-I/\-L Phase response = minimum/intermediate/linear \-s Steep filter (band-width = 99%) \-a Allow aliasing/imaging above the pass-band \-b\ 74\-99\*d7 Any band-width % \-p\ 0\-100 T{ .na Any phase response (0 = minimum, 25 = intermediate, 50 = linear, 100 = maximum) T} .TE (rendered:) -M/-I/-L Phase response = minimum/intermediate/linear -s Steep filter (band-width = 99%) -a Allow aliasing/imaging above the pass-band -b 74-99.7 Any band-width % -p 0-100 Any phase response (0 = minimum, 25 = intermediate, 50 = linear, 100 = maximum) 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.) Apart from that: comments? OK? Jan port-sox-14.4.0.tgz Description: application/tar-gz
Re: sox-14.4.0 - mandoc glitches
On Mar 05 16:46:25, Jan Stary wrote: Attached is a port of audio/sox, bringing it to 14.4.0. Tested on i386 and amd. Better now, courtesy of port-lib-depends-check. Jan port-sox-14.4.0.tgz Description: application/tar-gz