GNU bug report logs - #48511
26.3; Doc string of `global-display-line-numbers-mode'

Previous Next

Full log

Message #10 received at control <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 48511 <at> debbugs.gnu.org
Subject: Re: bug#48511: 26.3; Doc string of `global-display-line-numbers-mode'
Date: Wed, 19 May 2021 15:04:05 +0300

tags 48511 wontfix
close 48511
thanks

> From: Drew Adams <drew.adams <at> oracle.com>
> Date: Tue, 18 May 2021 22:25:28 +0000
> 
> The Emacs manual, node `Display Custom' says this:
> 
>   The command 'M-x display-line-numbers-mode' provides a convenient way
>   to turn on display of line numbers.  This mode has a globalized variant,
>   'global-display-line-numbers-mode'.  The user option
>   'display-line-numbers-type' controls which sub-mode of line-number
>   display, described above, will these modes activate.
>                             ^^^^^^^^^^^^^^^^^^^^^^^^^
> [...]
> 
> Please add the same or similar text about this option to the doc string
> of the global mode function as you have in the doc string of the local
> mode.

I don't agree that we should bloat the doc strings (and thus the Emacs
memory footprint) because some user failed to follow a link that
already exists.  That's a slippery slope I'd rather we don't take.

Closing.

Previous Next

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