From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: Bug: Incorrect/incomplete documentation for org-timestamp-change Date: Tue, 07 May 2019 12:04:40 +0200 Message-ID: <87tve6eg1z.fsf@nicolasgoaziou.fr> References: <87lfzkr5e4.fsf@passepartout.tim-landscheidt.de> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([209.51.188.92]:52348) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hNwxs-0005bT-Iu for emacs-orgmode@gnu.org; Tue, 07 May 2019 06:04:49 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hNwxr-0006Gq-KR for emacs-orgmode@gnu.org; Tue, 07 May 2019 06:04:48 -0400 Received: from relay11.mail.gandi.net ([217.70.178.231]:55237) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hNwxr-0006Dp-Eu for emacs-orgmode@gnu.org; Tue, 07 May 2019 06:04:47 -0400 In-Reply-To: <87lfzkr5e4.fsf@passepartout.tim-landscheidt.de> (Tim Landscheidt's message of "Sun, 05 May 2019 20:52:03 +0000") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: Tim Landscheidt Cc: emacs-orgmode@gnu.org Hello, Tim Landscheidt writes: > I wanted to (and did) change a number of timestamps by a > constant. So I found (and successfully used) > org-timestamp-change which starts with (master): > > | [=E2=80=A6] > | (defun org-timestamp-change (n &optional what updown suppress-tmp-delay) > | "Change the date in the time stamp at point. > | The date will be changed by N times WHAT. WHAT can be `day', `month', > | `year', `minute', `second'. If WHAT is not given, the cursor position > | in the timestamp determines what will be changed. > | When SUPPRESS-TMP-DELAY is non-nil, suppress delays like \"--2d\"." > | [=E2=80=A6] > > Incorrect is the enumeration of valid values for WHAT: 'hour > is missing and 'second is probably wrong (?). > > Incomplete is the documentation for UPDOWN: I had assumed it > was the "direction" of change, but that is determined in- > stead by the sign of N. Fixed. Thank you. Regards, --=20 Nicolas Goaziou