From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Christopher Dimech Newsgroups: gmane.emacs.help Subject: Re: Auto Fill Comments Date: Fri, 27 Nov 2020 22:40:50 +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; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="23158"; mail-complaints-to="usenet@ciao.gmane.io" Cc: help-gnu-emacs@gnu.org To: Arthur Miller Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Fri Nov 27 22:44:21 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 1kilXR-0005vm-8N for geh-help-gnu-emacs@m.gmane-mx.org; Fri, 27 Nov 2020 22:44:21 +0100 Original-Received: from localhost ([::1]:57184 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kilXQ-0006NL-3G for geh-help-gnu-emacs@m.gmane-mx.org; Fri, 27 Nov 2020 16:44:20 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:36292) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kilUC-0006Mq-G6 for help-gnu-emacs@gnu.org; Fri, 27 Nov 2020 16:41:02 -0500 Original-Received: from mout.gmx.net ([212.227.17.20]:47387) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kilU5-0005wi-NE for help-gnu-emacs@gnu.org; Fri, 27 Nov 2020 16:41:00 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1606513251; bh=Zvdroz6XaWyoH7OS8jCyxmw9qGVw7ViIV+nuglo5cXM=; h=X-UI-Sender-Class:From:To:Cc:Subject:Date:In-Reply-To:References; b=lFVciXEwSMnL3JmtwLyWyWircL2b1frV85nVo/LkJd/S6lAq8S/SVfyP6xrdxLnnX kxvl4EJyZfwN5AY/qrT9cj3k7l33iBAnvq2sh5SS6qI//SgMKDFnD9D+dyvQ/GyAU2 8TFGxrk+LVeqIfX+nUrWQkHMBCZpIa5A+bsDmXLo= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [213.165.168.94] ([213.165.168.94]) by web-mail.gmx.net (3c-app-mailcom-bs12.server.lan [172.19.170.180]) (via HTTP); Fri, 27 Nov 2020 22:40:50 +0100 Importance: normal Sensitivity: Normal In-Reply-To: X-UI-Message-Type: mail X-Priority: 3 X-Provags-ID: V03:K1:EwNQnPlqQrJzFiwl1BKCOIsmn6v5Ao51XNzi3RDSSUzCqZ1NBVvJEobti2BvXWHQ88FjM S8K4aJHR9Nn8aCWNqx9PZD3bzuNeDG55R2sKm5Whoz2gGA3PeZT4pQ7Y9LPycCie3174xE4YE0rv m1NTG62hEmcqM1ackd7jWGbt8F2tTLGZE/9UUz+Nku8e4GhbGLiA4cbjBZBi1YNSBU7H4REJnSbU gs63T/L+iLF1kjDLUvgt/a+InELuERB2MHGfZ12uufu6LW8d6BEUyR+xirtMAdPoax8ik6/bSOqV fs= X-UI-Out-Filterresults: notjunk:1;V03:K0:t9oqinmppd0=:hRgP0Dx/aweeS7ItaodPND QHqXp6N1hvNEvdr9BUVm4tLwiA7oNQeKaogq3du39GqkmV1l3l7+oAYav9803J+w2amjoWcuK b0t3uGhRDjNGnr/dJfIus2UMhy/jpyWhZ/pHe+5uhrtvv/VN7acSEffpHY+0LniS1uH3ejNjv xKzHE8Tf/E1Ik905Ya5x41xgh0MxZK1SDv3J5T1d9mXuWV1YiH07CvnW7edQ1EPIWQZsSwV78 P9rUlhAAt+prBR+OzMxrR5wZYOSF9RVYFxHhw7HRKlHsOX83toND53bhCCZtL3OVmybLrB6+b uRjZUYaaC0zk/fHQg6OnOJ7pnM+sf86hvEK3gr6qVWHScPnCQAWw0jz2UXQsLqqqVpyE581eM G3O4uSYPntY1UBWi1hz6O/ui/SJY+X+gyUWNio6nXtVdjVjn8i9Ej65rK71vTeQzKNv0eF7eK iwEGi1HL8TReP8bYugqcslzDmYQCeGIxoc5RmNRkPfHNo/Uam/kHYCJPnE+F0lw3ljQDtE6/g oOEbi1HcyzUJupqbyJGNOdttQp70NoXE7Q/b14+OfeZhDj1wuxuhigfA+85/nFnJPafhGzpzd 3qQiwR6myuObQ= Received-SPF: pass client-ip=212.227.17.20; envelope-from=dimech@gmx.com; helo=mout.gmx.net X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=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:125701 Archived-At: > Sent: Friday, November 27, 2020 at 10:26 PM > From: "Arthur Miller" > To: "Christopher Dimech" > Cc: help-gnu-emacs@gnu.org > Subject: Re: Auto Fill Comments > > 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 lis= p, > >> > 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 re= alised > > that adequacy is determined by the skill of the reader. Currently I a= dvocate > > that code comments are to give an overview of the code to help you red= uce > > the downtime required to work on the code after a time of inactivity. > > > > Documentation, however, is to be structured according to different lev= els > > of sophistication. But I understand it could be a lot of work to comp= lete. > > Was not my intention to deride anyone. but to describe how it is. Doc= umentation > > 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. Agreed. But telling users that one does not work for them is excessive, t= o say the least. I have hired people to work on free software, not one or two. And things were approached more professionally. Those in such position to= assign work will think twice before assigning someone to the task if they come ac= ross the wrong way. I certainly do. > I think it currently has good balance between targetting basics and > advanced usage. > >