From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.help Subject: Re: Morally equivalent Date: Mon, 17 Oct 2022 02:53:32 +0200 Message-ID: <87mt9vcltf.fsf@web.de> References: <87y1tfzhzm.fsf@undisclosedlocation.com> <877d0zfjqa.fsf@web.de> <87h703e445.fsf@web.de> <8735bne2d4.fsf@web.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="35576"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) To: help-gnu-emacs@gnu.org Cancel-Lock: sha1:Q0jPDNTHeLDavtvRrifsJqhYmjo= Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Mon Oct 17 02:54:37 2022 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 1okEOq-00092y-Cf for geh-help-gnu-emacs@m.gmane-mx.org; Mon, 17 Oct 2022 02:54:36 +0200 Original-Received: from localhost ([::1]:60480 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1okEOp-0006mn-9b for geh-help-gnu-emacs@m.gmane-mx.org; Sun, 16 Oct 2022 20:54:35 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53414) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1okENz-0006mH-II for help-gnu-emacs@gnu.org; Sun, 16 Oct 2022 20:53:43 -0400 Original-Received: from ciao.gmane.io ([116.202.254.214]:50636) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1okENy-00049M-3Y for help-gnu-emacs@gnu.org; Sun, 16 Oct 2022 20:53:43 -0400 Original-Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1okENw-0007zn-Bk for help-gnu-emacs@gnu.org; Mon, 17 Oct 2022 02:53:40 +0200 X-Injected-Via-Gmane: http://gmane.org/ Received-SPF: pass client-ip=116.202.254.214; envelope-from=geh-help-gnu-emacs@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.29 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:140038 Archived-At: Christopher Dimech writes: > Right. But I would say that the easiest thing is to write better > documentation (in source) as you are writing the code. At least that > part should be good. The source documentation is the biggest strength > of this system. Sounds excellent in theory. In reality lots of people are not good at writing good documentation. Or don't want to. Or hate it. Although everybody knows that they _should_ do exactly what you describe. The problem is not that they don't know. > The documentation is getting longer and longer. IME the documentation gets longer approx. in the same rate that Emacs grows. And it still does grow. Selective reading is not prohibited, as is selective familiarization with Emacs. Documentation is also quite good, on average, and also partly redundant, so you even have the luxury to choose between several paths. The hard part in mastering Emacs is Emacs, not its documentation. People do it nonetheless because it's worth it. Others don't because it's not worth it for them. Michael.