GNU bug report logs - #56870
company-dabbrev variable documentation

Previous Next

Full log

Message #69 received at 56870 <at> debbugs.gnu.org (full text, mbox):

From: YE <yet <at> ego.team>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: matt <at> rfc20.org, yet <at> ego.team, uzibalqa <at> proton.me, larsi <at> gnus.org,
 56870 <at> debbugs.gnu.org
Subject: [PATCH] Re: bug#56870: company-dabbrev variable documentation
Date: Sat, 06 Aug 2022 15:42:15 +0300

[Message part 1 (text/plain, inline)]

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

[0001-Link-from-emacs-Init-Syntax-to-elisp-Introduction.patch (text/x-patch, attachment)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.