From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: Bug: Docstrings of =org-agenda-todo-ignore-with-date= and
 =org-agenda-todo-ignore-timestamp= unclear [9.2 (release_9.2-215-g5b39d8 @
 /home/mbork/others-works/emacs/org-mode/lisp/)]
Date: Wed, 19 Jun 2019 21:19:44 +0200
Message-ID: <87d0j9pelr.fsf@nicolasgoaziou.fr>
References: <87k1dj2xiq.fsf@mbork.pl>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:470:142:3::10]:48324)
 by lists.gnu.org with esmtp (Exim 4.86_2)
 (envelope-from <mail@nicolasgoaziou.fr>) id 1hdg7c-0007o0-02
 for emacs-orgmode@gnu.org; Wed, 19 Jun 2019 15:19:53 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <mail@nicolasgoaziou.fr>) id 1hdg7a-0004iz-HG
 for emacs-orgmode@gnu.org; Wed, 19 Jun 2019 15:19:51 -0400
Received: from relay8-d.mail.gandi.net ([217.70.183.201]:60431)
 by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
 (Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
 id 1hdg7a-0004gy-AH
 for emacs-orgmode@gnu.org; Wed, 19 Jun 2019 15:19:50 -0400
In-Reply-To: <87k1dj2xiq.fsf@mbork.pl> (Marcin Borkowski's message of "Tue, 18
 Jun 2019 08:55:09 +0200")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
 <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Marcin Borkowski <mbork@mbork.pl>
Cc: emacs-orgmode@gnu.org

Hello,

Marcin Borkowski <mbork@mbork.pl> writes:

> The docstrings of =org-agenda-todo-ignore-with-date= and
> =org-agenda-todo-ignore-timestamp= do not really tell what these
> settings are doing.  They should (imho) emphasize that the former just
> omits from the global todo list all entries with at least one active
> timestamp (in the hedaline or the body), and the latter checks the first
> active timestamp which is not SCHEDULED or DEADLINE and compares it to
> today's date.
>
> It could also be mentioned in the manual.
>
> I have GNU papers for Emacs signed.  If this is enough, I'd be happy to
> submit a patch.  If so, what would be better: to patch only the
> docstrings or the docstrings and the manual.

I would say the latter. Thank you.

Regards,

-- 
Nicolas Goaziou