From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Pedro Andres Aranda Gutierrez Newsgroups: gmane.emacs.devel Subject: Clarify display-line-numbers width in manual Date: Sat, 17 Oct 2020 07:30:49 +0200 Message-ID: Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="000000000000c2f27005b1d72faa" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="18085"; mail-complaints-to="usenet@ciao.gmane.io" To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Oct 17 07:32:16 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kTepE-0004cS-DI for ged-emacs-devel@m.gmane-mx.org; Sat, 17 Oct 2020 07:32:16 +0200 Original-Received: from localhost ([::1]:36340 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kTepD-0007Su-C3 for ged-emacs-devel@m.gmane-mx.org; Sat, 17 Oct 2020 01:32:15 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50924) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kTeo5-000720-Sl for emacs-devel@gnu.org; Sat, 17 Oct 2020 01:31:05 -0400 Original-Received: from mail-lj1-x233.google.com ([2a00:1450:4864:20::233]:45160) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kTeo3-0002ZF-O3 for emacs-devel@gnu.org; Sat, 17 Oct 2020 01:31:05 -0400 Original-Received: by mail-lj1-x233.google.com with SMTP id a4so4993092lji.12 for ; Fri, 16 Oct 2020 22:31:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=syJbK+SdFIU2/CmuK1to4h/nZ3FcbETWhaYuBzM29HU=; b=M3ybW5/Ky12U1opSM/rKEC/FQH9Auidte9PcVr1W0IsyV741PWbTSl5ntKxmuaXSvw 5wIXchtz5MpV6nO05vjCaCwYxnd4gzOWXz08jGzPwKObPJ2mSsJja8ykPhepglUGkc2F 23M1yGtduHDKh5rE/UM39+numkdrMq342qes77FJVy0FhT9n7x/7TmgPL9N2fxWBdvwN ASQIE3uZkB6a0qf0E7OERuCLA+ZakfRhpWtty25w6x2xU4yRM+EaQMltx5rQm377ImH+ 4YZCyDQoyLfwnW1QX1KlufYynYt0+J1IqPmMk/AGtIj02zs79tlzvyfG4OoeU74nALFi wIDA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=syJbK+SdFIU2/CmuK1to4h/nZ3FcbETWhaYuBzM29HU=; b=SgTVQvM3xgGueN5d/cvXQSHrcM4JEsB7nLVU/SW85Sl4w4wzgSiipROMCc0pzhAwZi X3tfdmaBxkaUsVp9XtK0tCTY88XS4yANch/U4z3jOFwaVCq2JwKWlO68KoRNcGLfZsAO TYZW3HNWO/pfJ6Cq1lc0tzo7tU7CNT5tb4oSgl1SQlZCkoYzXFkkpE8AA8whhmxg5oxf TavVRE6e6HBhvo2fTVH3LCAiCF8v+pHeVrH2nm/nMPcSp8ump3dE040RgLTfhoNfAAgT ZVqaBz/Jyfwsf3xN5JdmajdTmZexlxogBkLl1UFC1gw3muzw8tv9QEw7j8oCi9CXNRMW +CHA== X-Gm-Message-State: AOAM531rlJzKDBBnYeiPZzUEQgPBgrAfgTvCbYBv/3D2HkN3zJFE2RtI 8y9gAYi04SJhlfvT6aGVZZUanMZFPO/M4KlL0Vbv3jr+Avg= X-Google-Smtp-Source: ABdhPJzeGQU/p85ifXbRLs0sqzFfApaFZnRT3R1s4yfP7C6mGO5NGk7SfhzABxMDWuEJVWRuoU1TJRdqQ9cOdv+eSaU= X-Received: by 2002:a2e:8986:: with SMTP id c6mr2946668lji.29.1602912660942; Fri, 16 Oct 2020 22:31:00 -0700 (PDT) Received-SPF: pass client-ip=2a00:1450:4864:20::233; envelope-from=paaguti@gmail.com; helo=mail-lj1-x233.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:257912 Archived-At: --000000000000c2f27005b1d72faa Content-Type: text/plain; charset="UTF-8" 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 --000000000000c2f27005b1d72faa Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
HI

I recently had to migrate= to display-line-numbers-mode. It was hard to find what I wanted in the man= ual 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 propo= sal to highlight the variable in the manual

diff -= -git a/doc/emacs/display.texi b/doc/emacs/display.texi
index a4040d9..ee= 76e77 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.tex= i
@@ -1882,6 +1882,12 @@ Display Custom
=C2=A0non-@code{nil}.=C2=A0 I= t has no effect when set to zero, or when line
=C2=A0numbers are not abs= olute.
=C2=A0
+@vindex display-line-numbers-width
+Set the value o= f @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 cor= rectly)
+
=C2=A0@vindex display-line-numbers-width-start
=C2=A0@vi= ndex display-line-numbers-grow-only
=C2=A0@vindex display-line-numbers-w= idth

Best, /Pedro A.
--
<= div dir=3D"ltr">
Fragen sind nicht da um bea= ntwortet zu werden,
Fragen sind da um gestellt zu werden
= Georg Kreisler
--000000000000c2f27005b1d72faa--