From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Ed Reingold Newsgroups: gmane.emacs.devel Subject: Re: Comments on man/calendar.texi. Date: Tue, 30 Nov 2004 13:00:56 -0600 Message-ID: <200411301900.iAUJ0u7E016819@emr.cs.iit.edu> References: NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7BIT X-Trace: sea.gmane.org 1101841352 6766 80.91.229.6 (30 Nov 2004 19:02:32 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 30 Nov 2004 19:02:32 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Nov 30 20:02:26 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CZDGb-0005vj-00 for ; Tue, 30 Nov 2004 20:02:25 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CZDQ3-0004kA-1X for ged-emacs-devel@m.gmane.org; Tue, 30 Nov 2004 14:12:11 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CZDPa-0004gI-UA for emacs-devel@gnu.org; Tue, 30 Nov 2004 14:11:43 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CZDPX-0004e4-Q6 for emacs-devel@gnu.org; Tue, 30 Nov 2004 14:11:40 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CZDPW-0004dh-JT for emacs-devel@gnu.org; Tue, 30 Nov 2004 14:11:38 -0500 Original-Received: from [216.47.143.101] (helo=email2.iit.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CZDFH-0000jx-EH for emacs-devel@gnu.org; Tue, 30 Nov 2004 14:01:03 -0500 Original-Received: from emr.cs.iit.edu (emr.cs.iit.edu [216.47.142.126]) by email2.iit.edu (iPlanet Messaging Server 5.2 Patch 2 (built Jul 14 2004)) with ESMTP id <0I8000J70A4T4I@email2.iit.edu> for emacs-devel@gnu.org; Tue, 30 Nov 2004 13:00:29 -0600 (CST) Original-Received: from emr.cs.iit.edu (localhost [127.0.0.1]) by emr.cs.iit.edu (8.12.10+Sun/8.12.2) with ESMTP id iAUJ0u7E016819; Tue, 30 Nov 2004 13:00:56 -0600 (CST) In-reply-to: Message from Matt Hodges "of Tue, 30 Nov 2004 15:07:54 GMT." <873byr5q9h.fsf@molpro.net> Original-To: Matt Hodges X-Mailer: exmh version 2.7.0 06/18/2004 with nmh-1.0.4 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:30546 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:30546 All of these comments are on the money! Will somebody fix the .texi files? > I've read through man/calendar.texi and have some comments. > > (1) The documentation of calendar-week-start-day doesn't mention that > if this variable is changed, redraw-calendar needs calling for the > effect to be visible. Also, until the calendar is redrawn, the > movement commands (e.g., calendar-forward-day) don't work > correctly. This situation is confusing and should at least be > mentioned in the variable documentation; better still if > customizing the variable redraws the calendar automatically. > > (2) The resizing of the calendar window that can occur with, for > example, calendar-forward-month can be distracting, so a > customizable minimum window height may be useful. > > (3) In Calendar mode, SPC is bound to scroll-other-window, so binding > DEL to scroll-other-window-down seems natural (cf. view-mode). > > (4) The error message "Months before February, 1 AD are not available" > looks a bit strange if you do, for example, C-u calendar RET 1 RET > February RET then M-v (scroll-calendar-right-three-months). I > guess that the message refers specifically to using C-u M-x > calendar, but there are other routes to generate-calendar, and > maybe something like "Months before January, 1 AD cannot be > displayed" would be more informative. > > (5) The earliest Mayan long count date appears to be 7.17.18.13.3, > rather than 7.17.18.13.1. (This needs to be checked.) > > (6) Mention timeclock-change, and fix the documentation for the > default behaviour of timeclock-ask-before-exiting. > > See attached patch for suggested changes. Thanks, > > Matt > >