[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs-25 25b4cf3 56/64: Describe WHEN in all the define-ob
From: |
Lars Ingebrigtsen |
Subject: |
[Emacs-diffs] emacs-25 25b4cf3 56/64: Describe WHEN in all the define-obsolete- macros |
Date: |
Sun, 01 May 2016 18:18:42 +0000 |
branch: emacs-25
commit 25b4cf33dddf9af02b94237d65a6c163bd308747
Author: Lars Ingebrigtsen <address@hidden>
Commit: Lars Ingebrigtsen <address@hidden>
Describe WHEN in all the define-obsolete- macros
* lisp/emacs-lisp/byte-run.el (define-obsolete-face-alias):
Say more verbosely what WHEN is (bug#21225).
(define-obsolete-function-alias): Describe the WHEN parameter.
(define-obsolete-variable-alias): Ditto.
(cherry picked from commit 247c388f160581d207e41ca5926990bbf69d4a0f)
---
lisp/emacs-lisp/byte-run.el | 10 ++++++++--
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/lisp/emacs-lisp/byte-run.el b/lisp/emacs-lisp/byte-run.el
index 83cb7e7..ed457d9 100644
--- a/lisp/emacs-lisp/byte-run.el
+++ b/lisp/emacs-lisp/byte-run.el
@@ -362,6 +362,9 @@ is equivalent to the following two lines of code:
\(defalias \\='old-fun \\='new-fun \"old-fun's doc.\")
\(make-obsolete \\='old-fun \\='new-fun \"22.1\")
+If provided, WHEN should be a string indicating when the function
+was first made obsolete, for example a date or a release number.
+
See the docstrings of `defalias' and `make-obsolete' for more details."
(declare (doc-string 4)
(advertised-calling-convention
@@ -404,6 +407,9 @@ dumped with Emacs). This is so that any user
customizations are
applied before the defcustom tries to initialize the
variable (this is due to the way `defvaralias' works).
+If provided, WHEN should be a string indicating when the function
+was first made obsolete, for example a date or a release number.
+
For the benefit of `custom-set-variables', if OBSOLETE-NAME has
any of the following properties, they are copied to
CURRENT-NAME, if it does not already have them:
@@ -428,8 +434,8 @@ CURRENT-NAME, if it does not already have them:
;; It only really affects M-x describe-face output.
(defmacro define-obsolete-face-alias (obsolete-face current-face when)
"Make OBSOLETE-FACE a face alias for CURRENT-FACE and mark it obsolete.
-The string WHEN gives the Emacs version where OBSOLETE-FACE became
-obsolete."
+If provided, WHEN should be a string indicating when the function
+was first made obsolete, for example a date or a release number."
`(progn
(put ,obsolete-face 'face-alias ,current-face)
;; Used by M-x describe-face.
- [Emacs-diffs] emacs-25 ad5572b 35/64: Fix custom types for cursor-in-non-selected-windows, (continued)
- [Emacs-diffs] emacs-25 ad5572b 35/64: Fix custom types for cursor-in-non-selected-windows, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 8aa4147 64/64: tramp.texi: Revert last change due to backward compatibility, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 619f1ed 29/64: Move doc of backup-directory-alist to the Backup node, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 c3b3b90 61/64: normal-top-level-add-subdirs-to-load-path doc fix, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 2ef780f 34/64: Doc clarification to mwheel-scroll, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 1378680 31/64: Have the doc strings of `load-path' and `require' mention each other, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 ed8474e 33/64: Clarify the doc of eval-expression-print-format, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 925af7e 27/64: Fill the doc string of font-lock-keywords, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 6d8c2d0 49/64: custom-buffer-style doc fix, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 3cbc1e3 07/64: Change all occurrences of "Mouse-[0-9]" to "mouse-[0-9]", Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 25b4cf3 56/64: Describe WHEN in all the define-obsolete- macros,
Lars Ingebrigtsen <=
- [Emacs-diffs] emacs-25 9f27bcf 60/64: isearch-search-fun-function doc tweak, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 3bc26a7 53/64: clear-visited-file-modtime doc string fix, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 afb2257 46/64: completion-table-with-predicate doc string fix, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 d1ab001 58/64: Fmarker_position doc string clarification, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 ef32be6 48/64: Rearrange the doc of query-replace slightly, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 f3f4502 45/64: Fill the completion-table-with-predicate doc string, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 9722ae1 54/64: with-silent-modifications doc clarification, Lars Ingebrigtsen, 2016/05/01
- [Emacs-diffs] emacs-25 78ae805 59/64: Fill some imenu--index-alist doc lines, Lars Ingebrigtsen, 2016/05/01