Subject: Improve documentation of `makunbound' and `fmakunbound'

From: Stefan Kangas <[email-masked]>
Date: Sat, 2 May 2020 15:53:37 +0200

Severity: wishlist

Any objections to or comments on the attached patch?  Thanks.

Best regards,
Stefan Kangas
From f1cab1061f02cb88c9e63a67935e9701cee3781d Mon Sep 17 00:00:00 2001
From: Stefan Kangas <[email-masked]>
Date: Sat, 2 May 2020 15:51:31 +0200
Subject: [PATCH] Improve doc strings of makunbound and fmakunbound

* src/data.c (Fmakunbound, Ffmakunbound): Improve doc strings.
---
 src/data.c | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/src/data.c b/src/data.c
index bce2e53cfb..e7b9e74a30 100644
--- a/src/data.c
+++ b/src/data.c
@@ -695,8 +695,12 @@ DEFUN ("fboundp", Ffboundp, Sfboundp, 1, 1, 0,
 }
 
 DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0,
-       doc: /* Make SYMBOL's value be void.
-Return SYMBOL.  */)
+       doc: /* Make variable SYMBOL's value be void.
+Return SYMBOL.
+
+For more information, see Info node `(elisp) Void Variables'.
+
+The corresponding operation for functions is `fmakunbound'.  */)
   (register Lisp_Object symbol)
 {
   CHECK_SYMBOL (symbol);
@@ -708,7 +712,11 @@ DEFUN ("makunbound", Fmakunbound, Smakunbound, 1, 1, 0,
 
 DEFUN ("fmakunbound", Ffmakunbound, Sfmakunbound, 1, 1, 0,
        doc: /* Make SYMBOL's function definition be nil.
-Return SYMBOL.  */)
+Return SYMBOL.
+
+For more information, see Info node `(elisp) Function Cells'.
+
+The corresponding operation for variables is `makunbound'.  */)
   (register Lisp_Object symbol)
 {
   CHECK_SYMBOL (symbol);
-- 
2.26.2