PROJ icon indicating copy to clipboard operation
PROJ copied to clipboard

`"-` artifact in rendered cct man page

Open jidanni opened this issue 1 year ago • 4 comments

There is a weird "- artifact in

$ nroff -man Downloads/cct.1 | grep -A 3 concat 
troff:Downloads/cct.1:63: warning [p 1, 4.3i]: cannot adjust line
troff:Downloads/cct.1:194: warning: cannot select font 'C'
troff:Downloads/cct.1:207: warning: cannot select font 'C'
troff:Downloads/cct.1:219: warning: cannot select font 'C'
troff:Downloads/cct.1:233: warning: cannot select font 'C'
troff:Downloads/cct.1:247: warning: cannot select font 'C'
troff:Downloads/cct.1:261: warning: cannot select font 'C'
          • a  OGC  URN combining references for concatenated operations (e.g.
            "‐
            urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,co‐
            ordinateOperation:EPSG::1618")
troff:Downloads/cct.1:276: warning: cannot select font 'C'
troff:Downloads/cct.1:291: warning: cannot select font 'C'
troff:Downloads/cct.1:306: warning: cannot select font 'C'
troff:Downloads/cct.1:321: warning: cannot select font 'C'

But there is no smoking gun in cct.rst. Maybe the too long line triggered a bug.

Never mind the font C warnings. That is some other worldwide issue.

jidanni avatar Mar 24 '24 09:03 jidanni

I can get a similar result using your commands but it doesn't show when viewed as an actual man page. Is this really a problem?

Screenshot 2024-03-24 at 10 50 26

kbevers avatar Mar 24 '24 10:03 kbevers

Seems like you're testing it on a super wide screen.

I read Man pages with M-X man in emacs, and stared at it for quite a while trying to figure out what it was trying to say.

jidanni avatar Mar 24 '24 12:03 jidanni

It doesn't make a difference if page is rendered wide or narrow:

Screenshot 2024-03-24 at 14 24 39

kbevers avatar Mar 24 '24 13:03 kbevers

I see what's going on.

It's trying to hyphen- ate a long word.

$ COLUMNS=80 man cct 2>&-|grep -B 1 EPSG::3895
            "‐
            urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,co‐
$ COLUMNS=800 man cct 2>&-|grep -B 1 EPSG::3895

          • a OGC URN combining references for concatenated operations (e.g. "urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,coordinateOperation:EPSG::1618")

I suppose the commas are our chance to break this long sentence into digestible lines...

OK, I'll see what I can do...

jidanni avatar Apr 02 '24 04:04 jidanni