Re: sox-14.4.0 - mandoc glitches

2012-03-07 Thread Ingo Schwarze 
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

2012-03-05 Thread Jan Stary 
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

2012-03-05 Thread Jan Stary 
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