From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Emanuel Berg via Users list for the GNU Emacs text editor Newsgroups: gmane.emacs.help Subject: Re: [External] : A peek to the other side Date: Sat, 26 Feb 2022 04:45:46 +0100 Message-ID: <87wnhi70k5.fsf@zoho.eu> References: Reply-To: Emanuel Berg Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="11078"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) To: help-gnu-emacs@gnu.org Cancel-Lock: sha1:H5GPhVoDWqQOD9RK2gfIA48dVlQ= Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane-mx.org@gnu.org Sat Feb 26 04:46:47 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 1nNo2g-0002gk-T2 for geh-help-gnu-emacs@m.gmane-mx.org; Sat, 26 Feb 2022 04:46:46 +0100 Original-Received: from localhost ([::1]:60046 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nNo2f-00050d-Cw for geh-help-gnu-emacs@m.gmane-mx.org; Fri, 25 Feb 2022 22:46:45 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:38802) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nNo1u-0004y6-Gk for help-gnu-emacs@gnu.org; Fri, 25 Feb 2022 22:45:58 -0500 Original-Received: from ciao.gmane.io ([116.202.254.214]:53466) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nNo1s-0001cy-U7 for help-gnu-emacs@gnu.org; Fri, 25 Feb 2022 22:45:58 -0500 Original-Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1nNo1p-0001ag-C5 for help-gnu-emacs@gnu.org; Sat, 26 Feb 2022 04:45:53 +0100 X-Injected-Via-Gmane: http://gmane.org/ Mail-Followup-To: help-gnu-emacs@gnu.org Mail-Copies-To: never 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: -16 X-Spam_score: -1.7 X-Spam_bar: - X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.249, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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:136194 Archived-At: Drew Adams wrote: > Intention to be internal, as a _Note to (communal) self_ > that XYZ might be fragile, or might need to change soon, or > has this limitation, or whatever, is better written out > specifically in comments or doc - saying why, in what ways, > under what conditions, etc. Specifics, reasons - think it > out and express it explicitly. Don't just label: `--'. Indeed, if it doesn't do anything it has no meaning ... If it has meaning in the sense we hope it will be used correctly by the guy writing the code and this meaning will hopefully reach the guy reading the code and this meaning will hopefully be correctly conveyed to him and hopefully acted upon as intended then ... how often do we hope all that will happen? When it comes to humans, even a simple task like closing a door or putting back a tool in its right place ... this fails _at least_ one or two times out of five. That kind of half-random stuff should never be built into computers and programming languages ... -- underground experts united https://dataswamp.org/~incal