From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Arthur Miller Newsgroups: gmane.emacs.help Subject: Re: Auto Fill Comments Date: Fri, 27 Nov 2020 22:26:13 +0100 Message-ID: References: <54331aa0-6a9a-4809-9f2d-88deee31558b@default> <83pn3zp8bu.fsf@gnu.org> <20201127160216.GA27998@tuxteam.de> <20201127175346.GB27998@tuxteam.de> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="34212"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: help-gnu-emacs@gnu.org To: Christopher Dimech Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Fri Nov 27 22:27:30 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 1kilH8-0008oz-LC for geh-help-gnu-emacs@m.gmane-mx.org; Fri, 27 Nov 2020 22:27:30 +0100 Original-Received: from localhost ([::1]:47276 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kilH7-0001Ni-MZ for geh-help-gnu-emacs@m.gmane-mx.org; Fri, 27 Nov 2020 16:27:29 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:57728) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kilG4-0001Ly-Uo for help-gnu-emacs@gnu.org; Fri, 27 Nov 2020 16:26:24 -0500 Original-Received: from mail-vi1eur05olkn2030.outbound.protection.outlook.com ([40.92.90.30]:11616 helo=EUR05-VI1-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kilG0-0004LW-IM for help-gnu-emacs@gnu.org; Fri, 27 Nov 2020 16:26:23 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=G9g2MslYmjkpYK6obhMESEplIkQfkXH0VAeuJ49wxeiGKpfYuuTPorwScR1Fo0tdsmDxjS19HrmaVaQRlIrM/tJqDDErvAVwQsRNpQWE3Lwetkl5huo5Ix2XkD77EA77yXD8nUmf/dFhufrqI2tM9x1G2/JLZsz3G7MXouGg3Pm+OVc3ADsCFRKFslU/7jtscdiIhgzNI0JuhcC9ZjP86v0zrAL5EGE8EWGkx4gz+43AQefsWMZq5t5EGKNX5EhaEViEB+KsTqlQIu8lGFCRPhmeA23Aa34FfTCBjGuTeh60WpxKcicTqCbVIYQg7M0a14WlY+d3PBuhlqcNia24WA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=3bpW/YAZ+JGn2OFwwaFKWd+4d2Rqe/ZQKUqyQ4R2+8M=; b=Lo62ReeN5RQWQgwLDKFelAOBB+llX7/JYbhy6DgPV7LmKAJnKdnj8C3v/4V52n6SFXbLQ3ZcRZ6IRrV0lzxsCME/kWBTLpzfCBKPPxyEo4aq297XeHAQwb1B+z9FT4D4JyxeBz1/IB3mpsGPZP/JcYmJcIzDZ6iYynighco7O+Jbl3P8rieUXNaeVQH5Hjh2fXk6idB24OpTDKuCNfqnFOZpZt/x5YvSnH1MBmtFGpz3r3DvwFVtynq26UGCLMAcoq/1azk+EJCea4EyuUYrpRwAT7O4BhAjpjSHCV41ntZgACToeggnA5xNDnC5DL+pLjwlGKLmBXAFmcuq+ZTsJg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=live.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=3bpW/YAZ+JGn2OFwwaFKWd+4d2Rqe/ZQKUqyQ4R2+8M=; b=RdfeNaaUMlLxOZItdNG04bGqPxTErm3d9ZnYnCoiCRAKLk0Hi1FfjomIcpzvVramwyzU+mKIf/Gr/76MXUwR9eb97SMgZ43zzGIMFvIaawg2nLTYcRcH1ejcVyLlvjhymdpcpNCuoYamLEXP7VDsi3LgpaqhBW7CJg6/hvHYVqnvrRucfG3W1W5oMUnOYpUEe2z9cPCzU0qMPQrkXc5hn2OPnQu1OSPZidVA1s1M6KfFpKdfKXACPnZTLl1Yh0IvRCWZTDlZQtFUKztf2vUCKlAEmq8W8pEP/Bi9j0oN3+PSAj7SOYL0BUKsS8jft0zcLr3rX8xzG0FNQn1oWbN+hg== Original-Received: from DB8EUR05FT047.eop-eur05.prod.protection.outlook.com (2a01:111:e400:fc0f::4d) by DB8EUR05HT177.eop-eur05.prod.protection.outlook.com (2a01:111:e400:fc0f::420) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3611.23; Fri, 27 Nov 2020 21:26:14 +0000 Original-Received: from AM0PR06MB6577.eurprd06.prod.outlook.com (2a01:111:e400:fc0f::52) by DB8EUR05FT047.mail.protection.outlook.com (2a01:111:e400:fc0f::452) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3611.23 via Frontend Transport; Fri, 27 Nov 2020 21:26:14 +0000 X-IncomingTopHeaderMarker: OriginalChecksum:913046DCD746AC6938448423AC9DB49D5D652686E776E3BC67601ADD134367F2; UpperCasedChecksum:722D152789F55EFD5935B3115B0FC0EA3AC7DBB05DB2207D02FDEACFA906CF44; SizeAsReceived:8328; Count:46 Original-Received: from AM0PR06MB6577.eurprd06.prod.outlook.com ([fe80::9487:8c7d:da00:4993]) by AM0PR06MB6577.eurprd06.prod.outlook.com ([fe80::9487:8c7d:da00:4993%7]) with mapi id 15.20.3611.025; Fri, 27 Nov 2020 21:26:14 +0000 In-Reply-To: (Christopher Dimech's message of "Fri, 27 Nov 2020 20:39:46 +0100") X-TMN: [8dJ1e/NUuFGqLrO1/hirz+wgi/f7AeNR] X-ClientProxiedBy: AM6P193CA0080.EURP193.PROD.OUTLOOK.COM (2603:10a6:209:88::21) To AM0PR06MB6577.eurprd06.prod.outlook.com (2603:10a6:208:19a::23) X-Microsoft-Original-Message-ID: <871rge1oga.fsf@live.com> X-MS-Exchange-MessageSentRepresentingType: 1 Original-Received: from pascal.homepc (90.230.29.56) by AM6P193CA0080.EURP193.PROD.OUTLOOK.COM (2603:10a6:209:88::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3611.20 via Frontend Transport; Fri, 27 Nov 2020 21:26:13 +0000 X-MS-PublicTrafficType: Email X-IncomingHeaderCount: 46 X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-Correlation-Id: a1c989bd-5aaf-44f3-705a-08d8931b1155 X-MS-TrafficTypeDiagnostic: DB8EUR05HT177: X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: vtXT26AefOisLdJXoF/qq0R7J0VhldOcjuSufnVKFATCauj5X5pV0hCZm8iKgW40KHiEXNAdqXMuPCjCuAa3v8rWHk8+GH3/0hjFBIkTfAOCalQYyWPWban2CXEtDzCJq4NTZx99m4mXuw5plpr2/TSA5LUYFXj13aomNQR11mnndfWuGGqGSnmnYRWUzOzIfh7d0EiHjJZo1K38pOg9WQ== X-MS-Exchange-AntiSpam-MessageData: U5cn6BnAMGsU/o5AapPD0pRHIzn1kOVVVdhx8ZzZWsaUDNu9MGgiwZ58W6eI0elwRifqfhakpIT9Vapq/kSIptMyLb6NFbSxiifOIAaqQzD8AHvnsKlToBlVS+fDWuCP80J2YZWbV11IRBazlxYwrg== X-OriginatorOrg: live.com X-MS-Exchange-CrossTenant-Network-Message-Id: a1c989bd-5aaf-44f3-705a-08d8931b1155 X-MS-Exchange-CrossTenant-OriginalArrivalTime: 27 Nov 2020 21:26:14.0203 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-AuthSource: DB8EUR05FT047.eop-eur05.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: Internet X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB8EUR05HT177 Received-SPF: pass client-ip=40.92.90.30; envelope-from=arthur.miller@live.com; helo=EUR05-VI1-obe.outbound.protection.outlook.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, MSGID_FROM_MTA_HEADER=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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:125698 Archived-At: Christopher Dimech writes: >> Sent: Friday, November 27, 2020 at 8:03 PM >> From: "Arthur Miller" >> To: "Christopher Dimech" >> Cc: help-gnu-emacs@gnu.org >> Subject: Re: Auto Fill Comments >> >> Christopher Dimech writes: >> >> > My experience has been that as I got to do more things in emacs lisp, >> > the understanding needed quickly exceeded my rate of learning. >> > One can get to sophisticated constructs, even when trying to do >> > relatively simple things. You never know where your original >> > plan could get you. Many times the importance of a work is not >> > measured by its consequences (i.e. by the final command). >> That is probably because you try to do more difficult things then >> before. >> >> I have been using Emacs for like almost 20 years, and was enough with >> setq-ing few variables, and wrapping ocassional few lines in a defun to >> put it on a hook. > > I used to argue that code must be adequately commented. Later on I realised > that adequacy is determined by the skill of the reader. Currently I advocate > that code comments are to give an overview of the code to help you reduce > the downtime required to work on the code after a time of inactivity. > > Documentation, however, is to be structured according to different levels > of sophistication. But I understand it could be a lot of work to complete. > Was not my intention to deride anyone. but to describe how it is. Documentation > is always better than no documentation. And everyone does as one can. True. However, Emacs manuals are written by volunteers with limited resources in their spair time (I hack Emacs as a hobby when I drink coffee), so what is practical has also to be take into account. They have to prioritize what level they put themselves on, especially Elisp manual. I think it currently has good balance between targetting basics and advanced usage.