From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.help Subject: RE: Auto Fill Comments Date: Fri, 27 Nov 2020 09:51:37 -0800 (PST) Message-ID: References: <> <<87pn419aha.fsf@robertthorpeconsulting.com>> <> <> <> <> <<20201126160013.GD28931@tuxteam.de>> <> <<20201126182734.GA5175@tuxteam.de>> <> <<54331aa0-6a9a-4809-9f2d-88deee31558b@default>,> <> <> <<83o8jjp83z.fsf@gnu.org>> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="38200"; mail-complaints-to="usenet@ciao.gmane.io" To: Eli Zaretskii , help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Fri Nov 27 18:52:29 2020 Return-path: Envelope-to: geh-help-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 1kihv2-0009pS-VB for geh-help-gnu-emacs@m.gmane-mx.org; Fri, 27 Nov 2020 18:52:29 +0100 Original-Received: from localhost ([::1]:40384 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kihv1-0003xa-W8 for geh-help-gnu-emacs@m.gmane-mx.org; Fri, 27 Nov 2020 12:52:28 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57668) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kihuP-0003xB-PF for help-gnu-emacs@gnu.org; Fri, 27 Nov 2020 12:51:49 -0500 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:32840) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kihuM-0007SF-Tx; Fri, 27 Nov 2020 12:51:49 -0500 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 0ARHmhqt039491; Fri, 27 Nov 2020 17:51:40 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=S0tzSytUrsw7NFBlgFRez8XPdlDGApGBFODzbBtguT8=; b=bCwmtjDRwKq0+ApDjWWsz5kUN0bXKj0nFMdbTAz4YwNIcdtOihHzUw8gWw6nwPfpg+ok 4ijlBemngzSbXEmU7PjTusBiZ5/oEF4vY9JkqFo2pySMZDLbP1m2sSP9Z8gGj5j4yrVd Q3TgkTD8VqlHkkx/SedqCBcryXfqmdQrC5UYK/K91Zt/UDhpM/O2JWEbLnsk754Z/0yu yoFRjj6dAOclTlp9REpFHlWshx6RINntqj3vF1E8w4Yv081rdVohQFs78sp5r65sV+I0 BiVZP5IFQzFjfyjflcl9Oi0Ey1Y7DLa7byWANZCRR1U2F3skBg3jKPWXCgfmY/MbwKxI 8Q== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by aserp2120.oracle.com with ESMTP id 351kwhj623-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Fri, 27 Nov 2020 17:51:40 +0000 Original-Received: from pps.filterd (aserp3030.oracle.com [127.0.0.1]) by aserp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 0ARHoBEX080390; Fri, 27 Nov 2020 17:51:40 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserp3030.oracle.com with ESMTP id 351n2mh4x2-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Nov 2020 17:51:40 +0000 Original-Received: from abhmp0011.oracle.com (abhmp0011.oracle.com [141.146.116.17]) by userv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 0ARHpchW008618; Fri, 27 Nov 2020 17:51:39 GMT In-Reply-To: <<83o8jjp83z.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5071.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9818 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 bulkscore=0 mlxlogscore=999 spamscore=0 phishscore=0 malwarescore=0 adultscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2011270105 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9818 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 mlxlogscore=999 lowpriorityscore=0 suspectscore=0 adultscore=0 impostorscore=0 mlxscore=0 spamscore=0 phishscore=0 malwarescore=0 clxscore=1031 priorityscore=1501 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2011270105 Received-SPF: pass client-ip=141.146.126.78; envelope-from=drew.adams@oracle.com; helo=aserp2120.oracle.com X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "help-gnu-emacs" Xref: news.gmane.io gmane.emacs.help:125673 Archived-At: > > Yes, Emacs terminology is old. >=20 > Which is why we have an elaborate Glossary chapter in the manual. +1. ________ I'll mention also (definitely not _instead_) that Emacs Wiki has a Glossary page: https://www.emacswiki.org/emacs/Glossary (There's also a link to it at the top left of every wiki page - hard to miss.) And more generally, there's even a Glossary _category_ page, which points to other pages that explain or cover things in more detail: https://www.emacswiki.org/emacs/CategoryGlossary And all of that is easily findable from the main wiki page - categories are listed there, and there's Search: https://www.emacswiki.org/ As is the case for most Emacs Wiki pages, anyone can contribute to (edit) the Glossary page. So it presents terminology as many different Emacs _users_ see it. The page may help you, or not. (And many wiki pages are available in other languages besides English. And _you_ can translate a page or improve a translation.) The point is that people have tried to help each other better understand Emacs and its terminology, in different ways, with their own voices. Instead of just complaining about someone else's attempt to describe, define, or explain something, you can pitch in and help in your own way. You can add wiki pages and edit existing pages. You can write your own Emacs manual there, if you like... Most importantly, you can take advantage of this aid from other users. I _do_ strongly recommend the Glossary in the Emacs manual, but no one is limited to any particular "official" presentation or interpretation of such things. There's little excuse for complaining that there's "too much" help, or it's not clear enough, or whatever. In my humble opinion. I also recommend these guiding wiki pages: Newbie: https://www.emacswiki.org/emacs/EmacsNewbie Learning Emacs: https://www.emacswiki.org/emacs/LearningEmacs Learning Elisp: https://www.emacswiki.org/emacs/LearnEmacsLisp Category Doc: https://www.emacswiki.org/emacs/CategoryDocumentation The wiki is for everyone. You can contribute, you can ask questions there,... It's yours (if you want it). ________ BTW, if you use my library Info+, then by default: Glossary words, that is, words that are defined in a manual's `Glossary' node, are highlighted and linked to their glossary entries, if option `Info-fontify-glossary-words' is non-`nil'. =20 By default, a mouseover on such a link shows a tooltip with the word's definition from the glossary, and either `mouse-2' or `RET' on a link takes you to the entry in the Glossary. And glossary entries that mention other entries link to them. By default, words in all manuals are linked to the `Glossary' node of the _Emacs_ manual. But you can control which manuals use which glossaries (or none), using option `Info-glossary-fallbacks-alist'. (Currently only the Emacs and Semantic manuals have `Glossary' nodes, as far as I know. But I use only the Info manuals provided by default with GNU Emacs on MS Windows.) ,---- | Info-glossary-fallbacks-alist is a variable | defined in `info+.el'. Its value is ((emacs . t)) |=20 | Documentation: | Alist of fallback manuals to use for glossary links. | | Each element is of the form (GLOSSARY-MANUAL . MANUALS). | The glossary of GLOSSARY-MANUAL is used to create | glossary links for each manual in MANUALS, if it has | no glossary of its own. If MANUALS is `t' then all | manuals use the glossary of GLOSSARY-MANUAL. |=20 | This has no effect if option | `Info-fontify-glossary-words' is nil. |=20 | You can customize this variable. `---- https://www.emacswiki.org/emacs/InfoPlus Code: https://www.emacswiki.org/emacs/download/info%2b.el