Clarify display-line-numbers width in manual

[Pedro Andres Aranda Gutierrez <paaguti@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 1147 bytes --]

HI

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)
+
 @vindex display-line-numbers-width-start
 @vindex display-line-numbers-grow-only
 @vindex display-line-numbers-width

Best, /Pedro A.
-- 
Fragen sind nicht da um beantwortet zu werden,
Fragen sind da um gestellt zu werden
Georg Kreisler

[-- Attachment #2: Type: text/html, Size: 1516 bytes --]