GNU bug report logs - #33914
In man pages, the URL's should not be split on two lines

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Pádraig Brady <P <at> draigBrady.com>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#33914: closed (In man pages, the URL's should not be split on
 two lines)
Date: Tue, 01 Jan 2019 14:43:01 +0000

[Message part 1 (text/plain, inline)]

Your message dated Tue, 1 Jan 2019 06:42:38 -0800
with message-id <6acd8177-3b44-92c2-f945-295001c9b297 <at> draigBrady.com>
and subject line Re: bug#33914: In man pages, the URL's should not be split on two lines
has caused the debbugs.gnu.org bug report #33914,
regarding In man pages, the URL's should not be split on two lines
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
33914: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=33914
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Vincent Lefevre <vincent <at> vinc17.net>
To: bug-coreutils <at> gnu.org
Subject: In man pages, the URL's should not be split on two lines
Date: Sun, 30 Dec 2018 01:41:20 +0100

In the dircolors(1) man page (and other ones for long command names)
of GNU coreutils 8.30, as output in a 80-column terminal, one has

REPORTING BUGS
       GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
       Report   dircolors   translation   bugs   to   <https://translationpro‐
       ject.org/team/>

and

SEE ALSO
       Full  documentation at: <https://www.gnu.org/software/coreutils/dircol‐
       ors>
       or available locally via: info '(coreutils) dircolors invocation'

Two of the URL's are split on two lines, making them difficult to
follow.

The corresponding dircolors.1 file contains:

Report dircolors translation bugs to <https://translationproject.org/team/>

and

Full documentation at: <https://www.gnu.org/software/coreutils/dircolors>

The issue may come from the fact that the URL's are not marked up as
such. http://man7.org/linux/man-pages/man7/groff_man.7.html mentions
macros for hyperlinks. Thus this might be the solution...

-- 
Vincent Lefèvre <vincent <at> vinc17.net> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / AriC project (LIP, ENS-Lyon)

[Message part 3 (message/rfc822, inline)]

From: Pádraig Brady <P <at> draigBrady.com>
To: Vincent Lefevre <vincent <at> vinc17.net>, 33914-done <at> debbugs.gnu.org
Subject: Re: bug#33914: In man pages, the URL's should not be split on two
 lines
Date: Tue, 1 Jan 2019 06:42:38 -0800

[Message part 4 (text/plain, inline)]

On 29/12/18 16:41, Vincent Lefevre wrote:
> In the dircolors(1) man page (and other ones for long command names)
> of GNU coreutils 8.30, as output in a 80-column terminal, one has
> 
> REPORTING BUGS
>        GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
>        Report   dircolors   translation   bugs   to   <https://translationpro‐
>        ject.org/team/>
> 
> and
> 
> SEE ALSO
>        Full  documentation at: <https://www.gnu.org/software/coreutils/dircol‐
>        ors>
>        or available locally via: info '(coreutils) dircolors invocation'
> 
> Two of the URL's are split on two lines, making them difficult to
> follow.
> 
> The corresponding dircolors.1 file contains:
> 
> Report dircolors translation bugs to <https://translationproject.org/team/>
> 
> and
> 
> Full documentation at: <https://www.gnu.org/software/coreutils/dircolors>
> 
> The issue may come from the fact that the URL's are not marked up as
> such. http://man7.org/linux/man-pages/man7/groff_man.7.html mentions
> macros for hyperlinks. Thus this might be the solution...

.UR macros do work, though are not universally available.
The attached takes the simpler approach of ensuring
the lines are short enough for an 80 column display,
for displaying 8 and 9 character command names.

cheers,
Pádraig

[url-wrap.patch (text/x-patch, attachment)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.