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: Vincent Lefevre <vincent <at> vinc17.net>
Subject: bug#33914: closed (Re: bug#33914: 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 bug report

#33914: In man pages, the URL's should not be split on two lines

which was filed against the coreutils package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 33914 <at> debbugs.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: 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 3 (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)]

[Message part 5 (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)

Previous Next

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