From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Matt Armstrong Newsgroups: gmane.emacs.bugs Subject: bug#56870: company-dabbrev variable documentation Date: Mon, 01 Aug 2022 14:49:15 -0700 Message-ID: <87y1w73a90.fsf@rfc20.org> References: <878ro74pz5.fsf@rfc20.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="21627"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 56870@debbugs.gnu.org To: uzibalqa Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Aug 01 23:50:14 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 1oIdIj-0005SJ-U2 for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 01 Aug 2022 23:50:14 +0200 Original-Received: from localhost ([::1]:54860 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oIdIi-0001IR-Qa for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 01 Aug 2022 17:50:12 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34402) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oIdIY-0001II-CX for bug-gnu-emacs@gnu.org; Mon, 01 Aug 2022 17:50:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52011) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oIdIY-00015k-2a for bug-gnu-emacs@gnu.org; Mon, 01 Aug 2022 17:50:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oIdIX-0007SP-UT for bug-gnu-emacs@gnu.org; Mon, 01 Aug 2022 17:50:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Matt Armstrong Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 01 Aug 2022 21:50:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 56870 X-GNU-PR-Package: emacs Original-Received: via spool by 56870-submit@debbugs.gnu.org id=B56870.165939056928597 (code B ref 56870); Mon, 01 Aug 2022 21:50:01 +0000 Original-Received: (at 56870) by debbugs.gnu.org; 1 Aug 2022 21:49:29 +0000 Original-Received: from localhost ([127.0.0.1]:41753 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oIdI1-0007RA-Gs for submit@debbugs.gnu.org; Mon, 01 Aug 2022 17:49:29 -0400 Original-Received: from relay9-d.mail.gandi.net ([217.70.183.199]:39517) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oIdHz-0007Qs-0h for 56870@debbugs.gnu.org; Mon, 01 Aug 2022 17:49:28 -0400 Original-Received: (Authenticated sender: matt@rfc20.org) by mail.gandi.net (Postfix) with ESMTPSA id 50BBEFF806; Mon, 1 Aug 2022 21:49:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rfc20.org; s=gm1; t=1659390560; h=from:from: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:references:references; bh=6cCpBvz4RurDCwq2t8DJV8ts0nBi5i08sW94mfNp440=; b=howUC/ySPlkjXaEwdAEK77WLBoR/+PdariG99yzdqVc7aKU8+31JGktdAr3CYm8+CNz9we goZoIn2nZtMKEcjrpQ5TlJrUbDdGk2vcC9wwa7PVna2y4iVcydlgstoAr2kgq2KX0/tvJL SMXqxd1bucilEoFhg5YNe4i4peuNBhjPyLnYQh4MtRXKBipRQ2uCG1mQfamGDn1pjG9lfS tOV4DYahFL/qlS9Kfz+wDHmNizNUSJ5a/2HselZEPAAmnloN4JbdUc/BLZB6vZZC9lreps CNAnIuIzS9KU3aZUCS4co97io8vH19qtezCmw7Q+bYzEq6V62Gn1U/ddqDwS/g== Original-Received: from matt by naz with local (Exim 4.96) (envelope-from ) id 1oIdHn-00185K-3B; Mon, 01 Aug 2022 14:49:15 -0700 In-Reply-To: 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" Xref: news.gmane.io gmane.emacs.bugs:238471 Archived-At: uzibalqa writes: > On Monday, August 1st, 2022 at 9:24 PM, Matt Armstrong wrote: >> Hope that helps! > > It is a shame that documentation does not come with example. It is > what is much lacking. I think the "friendly" way to customize Emacs is intended to be the customization system: https://www.gnu.org/software/emacs/manual/html_node/emacs/Easy-Customization.html In most cases, the customize interface hides lisp level details from the user. There is project level goal that most of the useful customizations a user can do in Emacs should be possible in the customize system, without using lisp. This is one reason the help text does not often describe things with Lisp examples. They would be of no use to the people using the Customize interface, and possibly even confusing. I still think your original point is a good one. I found the one piece of documentation explaining how to write quoted things in Emacs documentation, but I could not find a place explaining the conventions for quoted things mean in Emacs help. Perhaps another person can find that, or suggest a way to explain it to new users.