From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: YE via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#56870: [PATCH] Re: bug#56870: company-dabbrev variable documentation Date: Fri, 05 Aug 2022 12:10:33 +0300 Message-ID: References: Reply-To: YE Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="32991"; mail-complaints-to="usenet@ciao.gmane.io" Cc: matt@rfc20.org, yet@ego.team, uzibalqa@proton.me, larsi@gnus.org, 56870@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Aug 05 11:11:48 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oJtMy-0008PT-0V for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 05 Aug 2022 11:11:48 +0200 Original-Received: from localhost ([::1]:36904 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oJtMw-0006fI-8E for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 05 Aug 2022 05:11:46 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43496) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oJtME-0006f8-Ny for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 05:11:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:38183) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oJtME-0005DF-95 for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 05:11:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oJtME-000782-4h for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 05:11:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: YE Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 05 Aug 2022 09:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 56870 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug Original-Received: via spool by 56870-submit@debbugs.gnu.org id=B56870.165969064627380 (code B ref 56870); Fri, 05 Aug 2022 09:11:02 +0000 Original-Received: (at 56870) by debbugs.gnu.org; 5 Aug 2022 09:10:46 +0000 Original-Received: from localhost ([127.0.0.1]:56165 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oJtLx-00077Y-Na for submit@debbugs.gnu.org; Fri, 05 Aug 2022 05:10:46 -0400 Original-Received: from out0.migadu.com ([94.23.1.103]:11582) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oJtLu-00077O-5R for 56870@debbugs.gnu.org; Fri, 05 Aug 2022 05:10:44 -0400 X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ego.team; s=key1; t=1659690640; h=from:from:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to; bh=s7Fw2jJziNLMC/qrmVW5Ip12QEWz4N5otyV3PjqkRfg=; b=Gob1JUsJtWteZuNQW0hqdjrz0ptb/QK5g1zhi3KEyiS+jv37G91NUu6M7FuLU6JUQb8nP+ YlgOnEmB36mzlZf0G3nArdbLC5lRvcRXxQIWSAXK7UimW4OuBDOwl811cCaYT8aB6aVHrw Excvly42HwaCGlpCk7zsR6OWwqzaQWg= In-Reply-To: <83czdg2c7x.fsf@gnu.org> (message from Eli Zaretskii on Thu, 04 Aug 2022 19:41:06 +0300) X-Migadu-Flow: FLOW_OUT X-Migadu-Auth-User: ego.team X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" X-ACL-Warn: , YE Xref: news.gmane.io gmane.emacs.bugs:238845 Archived-At: Eli Zaretskii writes: >> My take on the 'Init File' docs improvement is attached. > > Thanks. However, this basically adds to the Emacs manual stuff whose > place is in the ELisp manual. This patch clarifies _existing_ node of the Emacs manual: 1. Adds indexes. 2. Adds links to the ELisp manual for further reading. 3. Clarifies how to use _wide-spread_ symbols (extensively used by newbies). Which part _exactly_ you don't find suitable for the Emacs manual? Don't Symbols deserve the same attention as Numbers, Strings, Characters described extensively in `(emacs) Init Syntax'? Maybe, according to your point of view, this node should be removed from the Emacs manual altogether, (linking to the ELisp manual)? In my fresh memory, this part of the manual was one of the least helpful and the most confusing. So my (vanishing) hope was to contribute a little bit of improvement to it to help fellow beginner users, when one of the issues with it was articulated. Or should I submit a new bug report with the vague: `(emacs) Init File' is confusing and isn't instructive enough for the newbies? Many (if not most) of the beginners start tweaking Emacs via the init file, not Customize interface. So well-written beginner instructions on how to use init file is a _need_, not a whim. > So I'm not sure we should start on this > slippery slope. We start on the slippery slope when the reported issues aren't resolved. > Users who need to write complex Lisp in their init > files need to read the ELisp manual anyway. What part of the patch touches the "complex Lisp"?