From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.bugs Subject: bug#74965: [PATCH] Document representation of dates in calendar.el Date: Tue, 24 Dec 2024 23:48:14 -0500 Message-ID: References: <87y10cm5i0.fsf@recursewithless.net> <87v7vgm552.fsf@recursewithless.net> <87ikrav96y.fsf@> Reply-To: rms@gnu.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="38142"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 74965@debbugs.gnu.org, rwl@recursewithless.net To: =?UTF-8?Q?Bj=C3=B6rn?= Bidar Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Dec 25 05:51:12 2024 Return-path: Envelope-to: geb-bug-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 1tQJMV-0009m9-N0 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 25 Dec 2024 05:51:11 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tQJMO-000728-4b; Tue, 24 Dec 2024 23:51:04 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tQJMN-000720-0g for bug-gnu-emacs@gnu.org; Tue, 24 Dec 2024 23:51:03 -0500 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tQJMM-0003Yi-HH for bug-gnu-emacs@gnu.org; Tue, 24 Dec 2024 23:51:02 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=Date:MIME-version:References:In-Reply-To:From:To:Subject; bh=zFuzDVoPd+3BJmnBV2iQL4fFKXctCgUxV3Nliyb98Ko=; b=RfDSF7T0A2iYgYXHAxbBpL/HPwI0nz3sNjIFQpzdfHTJKALqSWIfjsDAs9gfVu9J2rSv4TB3QzUKqlblOC8+KkXeOTrFxlcXzTobBoRHE6jYycYDfcCBkB9duLF/gL31GNUEP/fK7ss7ozA7mj2zQKWlhd+TWBwPXoAo5pKtrXVy9oEYWUWExD+abdIXmXj1QM1ieXr4kfo8sDz1zUb8lySqZtCPU1//8OQCnJtYEGMsqc/rEBfaIELLs1jGtI9HylgTvLhZLSqse96E9sRrzUE0yEc6BcbwOgoeEpHIB38wdnYzhG9hIAso3PyRcBWclVQuz/FTKhO5C0vGI0EzRg==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tQJMM-0004LV-CV for bug-gnu-emacs@gnu.org; Tue, 24 Dec 2024 23:51:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Richard Stallman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 25 Dec 2024 04:51:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 74965 X-GNU-PR-Package: emacs Original-Received: via spool by 74965-submit@debbugs.gnu.org id=B74965.173510223216639 (code B ref 74965); Wed, 25 Dec 2024 04:51:02 +0000 Original-Received: (at 74965) by debbugs.gnu.org; 25 Dec 2024 04:50:32 +0000 Original-Received: from localhost ([127.0.0.1]:35797 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tQJLs-0004KH-1V for submit@debbugs.gnu.org; Tue, 24 Dec 2024 23:50:32 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:60572) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tQJLp-0004K3-Kn for 74965@debbugs.gnu.org; Tue, 24 Dec 2024 23:50:30 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tQJJe-0002aO-Pc; Tue, 24 Dec 2024 23:48:14 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:MIME-version:References:Subject:In-Reply-To:To: From; bh=zFuzDVoPd+3BJmnBV2iQL4fFKXctCgUxV3Nliyb98Ko=; b=ZjVclObeRCtD8VSfyU9R DmixiC4D0T4x97R5hNegsourRQEJBekye5rBNaFCKIW5Cm8jDYiVDXM7wl3hghI4hYk9Rg4t/1XKn ZjgUoHe5aCSpxDVI4L1ADY/JJufOViXA2kyfJkvyfED02j+UxE5TNVkhkL2tdvCMmEcWN7ng2HXeD nuHKMsPy/CWZz1N51x7ZFDB5Dut/NEBdwcmtWrnSjApaQgbVKzWZDh0Ar0k6F7GNdCDJnoyzKlpxp cJH5g4h1kK8qEujY5790loT3bdmlyXU+5b/4XlOzfFvFa/vsa7ukHSIpiO4Y+AGoPTsY/A55INzQE 5VJMkgE56pbrQw==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1tQJJe-0002UB-3C; Tue, 24 Dec 2024 23:48:14 -0500 In-Reply-To: <87ikrav96y.fsf@> (message from =?UTF-8?Q?Bj=C3=B6rn?= Bidar on Mon, 23 Dec 2024 15:08:05 +0200) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:297713 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > There are some modes which could have more documentation on internal > functions to explain better what they are doing such as in Gnus. Yes, that is crucial for clear code. But what we really want, to make a program easy to read and understand, goes beyond that. It should have an introduction which explains the parts of the program, and how they relate in terms of jobs they do, and what the entry points are for each part. Patr of this is explicitly dividng the program into parts and starting each part with a comment saying what that part does and how to use it. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)