From: Pedro Andres Aranda Gutierrez <paaguti@gmail.com>
To: Eli Zaretskii <eliz@gnu.org>
Cc: emacs-devel@gnu.org
Subject: Re: Clarify display-line-numbers width in manual
Date: Sun, 18 Oct 2020 18:01:13 +0200 [thread overview]
Message-ID: <CAO48Bk9x2YxWm6dWmd9Grb7wmx1H8htW4ABWVNjANdiFXVYkaQ@mail.gmail.com> (raw)
In-Reply-To: <83pn5hteyr.fsf@gnu.org>
[-- Attachment #1: Type: text/plain, Size: 2571 bytes --]
Hi,
well, I was on the old linum package and now that emacs26 is widely
available and I started to get a weird
behaviour on emacs27, the time seemed to have come to move on to
display-line-numbers.
One of the things I'm only to used to change is that the line number field
has a fixed width (ie it doesn't depend
on the lines being displayed). And going through the manual, it was not
obvious at all how to do that.
s/fix the width/set the width/g
And let me think how to reword the 'display correctly' sentence
Best, /PA
On Sat, 17 Oct 2020 at 10:49, Eli Zaretskii <eliz@gnu.org> wrote:
> > From: Pedro Andres Aranda Gutierrez <paaguti@gmail.com>
> > Date: Sat, 17 Oct 2020 07:30:49 +0200
> >
> > I recently had to migrate to display-line-numbers-mode. It was hard to
> find what I wanted in the manual at
> > first glance, which was how to set the width of the line numbers to
> fixed width. It was somehow buried in a
> > paragraph along with other succinct explanations for other variables.
> >
> > Here is a proposal to highlight the variable in the manual
> >
> > diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
> > index a4040d9..ee76e77 100644
> > --- a/doc/emacs/display.texi
> > +++ b/doc/emacs/display.texi
> > @@ -1882,6 +1882,12 @@ Display Custom
> > non-@code{nil}. It has no effect when set to zero, or when line
> > numbers are not absolute.
> >
> > +@vindex display-line-numbers-width
> > +Set the value of @code{display-line-numbers-width} to fix the width
> > +of the line number. Make sure it is large enough for the largest files
> > +you expect to edit (e.g. @code{4} would allow up to @code{9999} lines
> > +to be displayed correctly)
>
> Thanks. However, I don't understand the motivation well enough to
> judge the patch, or to propose some different text to take care of
> this issue. You say "to fix the width" and "to be displayed
> correctly", and that hints on, or could be interpreted as, saying that
> the default values yield incorrect display. Which is not what I see
> here.
>
> So please tell what display problems you tried to fix by setting
> display-line-numbers-width in your configuration, and what information
> you tried to find in the manual about that.
>
> In any case, you copied the @vindex entry to your text, but left the
> original one intact, which would have the effect of having 2 identical
> index entries pointing to very close locations in the text, something
> that is undesirable.
>
--
Fragen sind nicht da um beantwortet zu werden,
Fragen sind da um gestellt zu werden
Georg Kreisler
[-- Attachment #2: Type: text/html, Size: 3433 bytes --]
prev parent reply other threads:[~2020-10-18 16:01 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-10-17 5:30 Clarify display-line-numbers width in manual Pedro Andres Aranda Gutierrez
2020-10-17 8:49 ` Eli Zaretskii
2020-10-18 16:01 ` Pedro Andres Aranda Gutierrez [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=CAO48Bk9x2YxWm6dWmd9Grb7wmx1H8htW4ABWVNjANdiFXVYkaQ@mail.gmail.com \
--to=paaguti@gmail.com \
--cc=eliz@gnu.org \
--cc=emacs-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.