Re: master d506d91b1f 2/2: Make linum.el obsolete

[Philip Kaludercic <philipk@posteo.net>]

Stefan Kangas <stefankangas@gmail.com> writes:

> branch: master
> commit d506d91b1fa98b3868437e4d3638f606b4bd20a0
> Author: Stefan Kangas <stefankangas@gmail.com>
> Commit: Stefan Kangas <stefankangas@gmail.com>
>
>     Make linum.el obsolete
>     
>     * lisp/obsolete/linum.el: Add Obsolete-since.
>     * etc/NEWS: Announce obsoletion of linum.el.  (Bug#57412)
>     
>     * doc/misc/efaq.texi (Displaying the current line or column):
>     * etc/TODO:
>     * lisp/faces.el: Don't mention linum.el.
> ---
>  doc/misc/efaq.texi     | 3 ---
>  etc/NEWS               | 6 ++++++
>  etc/TODO               | 6 ------
>  lisp/faces.el          | 1 -
>  lisp/obsolete/linum.el | 8 ++++++++
>  5 files changed, 14 insertions(+), 10 deletions(-)
>
> diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
> index ccaca1d017..0da397919d 100644
> --- a/doc/misc/efaq.texi
> +++ b/doc/misc/efaq.texi
> @@ -1810,9 +1810,6 @@ optional display.  Alternatively, you can use the
>  customize @code{display-line-numbers-type} with the same value as you
>  would use with @code{display-line-numbers}.
>  
> -There is also the @samp{linum} package which will henceforth become
> -obsolete.  We recommend using @samp{display-line-numbers} instead.
> -
>  @node Displaying the current file name in the titlebar
>  @section How can I modify the titlebar to contain the current file name?
>  @cindex Titlebar, displaying the current file name in
> diff --git a/etc/NEWS b/etc/NEWS
> index 5e34f43179..97174ba7a2 100644
> --- a/etc/NEWS
> +++ b/etc/NEWS
> @@ -389,6 +389,12 @@ The user options 'url-gateway-rlogin-host',
>  'url-gateway-rlogin-parameters', and 'url-gateway-rlogin-user-name'
>  are also obsolete.
>  
> +---
> +** The linum.el library is now obsolete.
> +We recommend using either the built-in `display-line-numbers-mode', or
> +the `nlinum' package from GNU ELPA instead.  The former has better
> +performance, but the latter is closer to a drop-in replacement.

If I try to load linum now, I just get a message that it is deprecated,
but no hint to use `display-line-numbers-mode'.  Can that be added?

>  ---
>  ** The autoarg.el library is now marked obsolete.
>  This library provides the 'autoarg-mode' and 'autoarg-kp-mode' minor
> diff --git a/etc/TODO b/etc/TODO
> index 5a89c47a9c..3e4979da8a 100644
> --- a/etc/TODO
> +++ b/etc/TODO
> @@ -1686,12 +1686,6 @@ and the one to use when terminating the selection.
>  More specifically do what's needed to make ibuffer.el the default, or
>  just an extension of buff-menu.el.
>  
> -** Replace linum.el with nlinum.el
> -https://lists.gnu.org/r/emacs-devel/2013-08/msg00379.html
> -
> -(Since Emacs 26 introduced native line numbers, this item is
> -probably obsolete.)
> -
>  ** Merge sendmail.el and messages.el
>  Probably not a complete merge, but at least arrange for messages.el to
>  be a derived mode of sendmail.el.  Or arrange for messages.el to be
> diff --git a/lisp/faces.el b/lisp/faces.el
> index e171b32e31..ffdc391f66 100644
> --- a/lisp/faces.el
> +++ b/lisp/faces.el
> @@ -2548,7 +2548,6 @@ default."
>    :version "21.1"
>    :group 'basic-faces)
>  
> -;; Definition stolen from linum.el.
>  (defface line-number
>    '((t :inherit (shadow default)))
>    "Face for displaying line numbers.
> diff --git a/lisp/obsolete/linum.el b/lisp/obsolete/linum.el
> index 1b897a2bd2..017c06e426 100644
> --- a/lisp/obsolete/linum.el
> +++ b/lisp/obsolete/linum.el
> @@ -6,6 +6,7 @@
>  ;; Maintainer: emacs-devel@gnu.org
>  ;; Keywords: convenience
>  ;; Old-Version: 0.9x
> +;; Obsolete-since: 29.1
>  
>  ;; This file is part of GNU Emacs.
>  
> @@ -24,6 +25,13 @@
>  
>  ;;; Commentary:
>  
> +;; NOTE: This library was made obsolete in Emacs 29.1.  We recommend
> +;; using either the built-in `display-line-numbers-mode', or the
> +;; `nlinum' package from GNU ELPA instead.  The former has better
> +;; performance, but the latter is closer to a drop-in replacement.
> +;;
> +;; --------------------
> +;;
>  ;; Display line numbers for the current buffer.
>  ;;
>  ;; Toggle display of line numbers with M-x linum-mode.  To enable