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: RE: Auto Fill Comments Date: Thu, 26 Nov 2020 21:32:05 -0800 (PST) Message-ID: <0d76ad17-4496-4202-982d-b44e8b2eb46a@default> References: <20201126160013.GD28931@tuxteam.de> <20201126182734.GA5175@tuxteam.de> <54331aa0-6a9a-4809-9f2d-88deee31558b@default> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6642"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Christopher Dimech , help-gnu-emacs@gnu.org To: Jean Louis Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Fri Nov 27 06:32:40 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 1kiWN5-0001a5-Na for geh-help-gnu-emacs@m.gmane-mx.org; Fri, 27 Nov 2020 06:32:39 +0100 Original-Received: from localhost ([::1]:50918 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kiWN4-0003Dl-Fd for geh-help-gnu-emacs@m.gmane-mx.org; Fri, 27 Nov 2020 00:32:38 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:56890) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kiWMi-0003D1-0H for help-gnu-emacs@gnu.org; Fri, 27 Nov 2020 00:32:16 -0500 Original-Received: from userp2130.oracle.com ([156.151.31.86]:54936) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kiWMf-0002Ps-Pp for help-gnu-emacs@gnu.org; Fri, 27 Nov 2020 00:32:15 -0500 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 0AR5TBPA072734; Fri, 27 Nov 2020 05:32:08 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=UaQQI864LXqTb68nzLSz1QHd2oLnGP+hYiLRcUQ6kpE=; b=jRCeonO8GQUxB3XKPKe5yopFmLfp+h5wbKbB5YzaN35Zwo6g6xUkSGwirQiuGVRbO3Z+ rZsxVRp6BvkLQgFcoAd9amtZ7xnNmNJljcBM78mO3gDgzCFucH2sy+gsawKK+Vwx39AP c5h9DmY4VlqbWPMYEfVXiVTQLPRY9yXfPV1Ys8EMYfvqnjt4CL2gq36iWj/YVSMbrI8u /REweD9I8d7FVWh4yNItM3FiJ5tIM4PJ94wRUxsxZIYibifWF8E3bXmNjJgEu5jbA8JM uWOTf5JdKf04dzwxpr1meH7ykE6i+6ZjPnybdMMcnC/D5xTNhbP6EpH7vlojqi1NPAh1 Hg== Original-Received: from aserp3030.oracle.com (aserp3030.oracle.com [141.146.126.71]) by userp2130.oracle.com with ESMTP id 351kwhqw8j-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Fri, 27 Nov 2020 05:32:08 +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 0AR5UAmn048456; Fri, 27 Nov 2020 05:32:08 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by aserp3030.oracle.com with ESMTP id 351n2kw4s3-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 27 Nov 2020 05:32:07 +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 0AR5W6Bn017684; Fri, 27 Nov 2020 05:32:06 GMT In-Reply-To: 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=9817 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-2011270031 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9817 signatures=668682 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 impostorscore=0 malwarescore=0 lowpriorityscore=0 adultscore=0 priorityscore=1501 suspectscore=0 bulkscore=0 spamscore=0 mlxlogscore=999 mlxscore=0 clxscore=1031 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2011270031 Received-SPF: pass client-ip=156.151.31.86; envelope-from=drew.adams@oracle.com; helo=userp2130.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, 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:125618 Archived-At: > Example of such well hyperlinked document is the Common Lisp > Hyperspec: > https://urldefense.com/v3/__http://www.lispworks.com/documentation/Hype > rSpec/Body/03_dd.htm__;!!GqivPVa7Brio!M0oMWYk7ycXnM09iZWgxA9rs9YHwszzUU > mkxyu4rqQ8q1NPYUklPucBUWHTBipB9$ >=20 > Documentation of the Common Lisp Hyperspec if very complex but with > finely grained references hyperlinks it becomes pleasure to learn and > programmers can orient themselves easier in the apparently complex > document. That is example of complex instructions well prepared for > easier understanding. FWIW - Though I use the hyperspec sometimes I vastly prefer CLTL2. It gives you conceptual info about the language and Lisp generally (in addition to giving the API info that the hyperspec provides). CLTL describes the language design, and tells you reasons why it's the way it is, as well as some of the important consequences. Someone wondering about the seeming oddities of Lisp will begin to understand them with CLTL. In a nutshell, it shows you Lisp, what it is and why. No doubt that's why it has the title it does: Common Lisp The Language. You don't get that from the hyperspec. The hyperspec is essentially just API doc - it provides little understanding. (Yes, it's hyperlinked, which is good.) You can actually sit down and learn Common Lisp (and Lisp generally) by reading CLTL. It takes you from pretty much no knowledge to pretty much complete info about the language. CLTL is not a how-to book - not a tutorial. It's a spec of the language, but in English, not algebra. (Another book that's in a similar spirit, but isn't a spec of a particular language, is Abelson & Sussman's Structure & Interpretation of Computer Programs.)