emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Clarify display-line-numbers width in manual


From: Pedro Andres Aranda Gutierrez
Subject: Clarify display-line-numbers width in manual
Date: Sat, 17 Oct 2020 07:30:49 +0200

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

reply via email to

[Prev in Thread] Current Thread [Next in Thread]