bug#41026: Improve documentation of `makunbound' and `fmakunbound'

[Stefan Kangas <stefan@marxist.se>]

[-- Attachment #1: Type: text/plain, Size: 111 bytes --]

Severity: wishlist

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

Best regards,
Stefan Kangas

[-- Attachment #2: 0001-Improve-doc-strings-of-makunbound-and-fmakunbound.patch --]
[-- Type: text/x-patch, Size: 1379 bytes --]

From f1cab1061f02cb88c9e63a67935e9701cee3781d Mon Sep 17 00:00:00 2001
From: Stefan Kangas <stefankangas@gmail.com>
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