Subject: [PATCH] Re: bug#56870: company-dabbrev variable documentation

From: YE <[email-masked]>
Date: Sat, 06 Aug 2022 15:42:15 +0300

>> Eli Zaretskii:

>> From: YE
>> Which part _exactly_ you don't find suitable for the Emacs manual?
>
> All of it.  You explain some basics of Emacs Lisp, which any user who
> is serious about customizing his/her Emacs should already know about,
> by reading the relevant parts of the ELisp manual.

>> Don't Symbols deserve the same attention as Numbers, Strings,
>> Characters described extensively in `(emacs) Init Syntax'?
>
> No, I don't think so.  And this is a slippery slope anyway, because
> there's more about Lisp objects than just telling what you suggest to
> tell.

>> What part of the patch touches the "complex Lisp"?
>
> Why does this text have to talk about doc strings, and what does it
> have to do with the syntax of the init file?  And the node to which
> you refer is a large and complex node, which is too much for simple
> customizations that Init Syntax intends to cover.
>

Thank you for the detailed response.

>> From: Matt Armstrong
>> Eli, perhaps a single link to the ELisp manual near the beginning of
>> "(emacs) Init Syntax" would be acceptable?
>
> Yes, that's a better idea.

One more tiny patch is attached.
It links 'Init Syntax' to the ELisp manual Introduction node.

>From 68a2732383e48096296da208215590c5afc62971 Mon Sep 17 00:00:00 2001
From: YugaEgo <[email-masked]>
Date: Sat, 6 Aug 2022 15:20:09 +0300
Subject: [PATCH] Link from (emacs)Init Syntax to (elisp)Introduction

* doc/emacs/custom.texi (Init Syntax): Link to the ELisp manual (Bug#56870)
---
 doc/emacs/custom.texi | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index 6ed43bcb79..efaf0dfd38 100644
--- a/doc/emacs/custom.texi
+++ b/doc/emacs/custom.texi
@@ -2452,6 +2452,9 @@ Init Syntax
 Write a single-quote (@code{'}) followed by the Lisp object you want.
 @end table
 
+  For more information on the Emacs Lisp syntax, @pxref{Introduction,,,
+elisp, The Emacs Lisp Reference Manual}.
+
 @node Init Examples
 @subsection Init File Examples
 
-- 
2.34.1