From: Stefan Kangas <stefankangas@gmail.com>
Date: Tue, 20 Sep 2022 18:52:42 +0000 (+0200)
Subject: Make linum.el obsolete
X-Git-Tag: emacs-29.0.90~1856^2~342
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=d506d91b1fa98b3868437e4d3638f606b4bd20a0;p=emacs.git

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.
---

diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index ccaca1d017c..0da397919db 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 5e34f43179f..97174ba7a2d 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.
+
 ---
 ** 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 5a89c47a9c1..3e4979da8a7 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 e171b32e317..ffdc391f669 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 1b897a2bd22..017c06e426e 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