From mboxrd@z Thu Jan 1 00:00:00 1970 From: Marcin Borkowski Subject: 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: Tue, 18 Jun 2019 08:55:09 +0200 Message-ID: <87k1dj2xiq.fsf@mbork.pl> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:46446) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hd83V-0003tB-3S for emacs-orgmode@gnu.org; Tue, 18 Jun 2019 02:57:22 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hd83T-0002c3-Vi for emacs-orgmode@gnu.org; Tue, 18 Jun 2019 02:57:21 -0400 Received: from mail.mojserwer.eu ([195.110.48.8]:51084) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hd83T-0002bN-O8 for emacs-orgmode@gnu.org; Tue, 18 Jun 2019 02:57:19 -0400 Received: from localhost (localhost [127.0.0.1]) by mail.mojserwer.eu (Postfix) with ESMTP id 70DFFE6743 for ; Tue, 18 Jun 2019 08:57:17 +0200 (CEST) Received: from mail.mojserwer.eu ([127.0.0.1]) by localhost (mail.mojserwer.eu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 9r5fIkTw-849 for ; Tue, 18 Jun 2019 08:57:13 +0200 (CEST) Received: from localhost (apn-5-60-160-133.dynamic.gprs.plus.pl [5.60.160.133]) by mail.mojserwer.eu (Postfix) with ESMTPSA id 271C6E63AE for ; Tue, 18 Jun 2019 08:57:13 +0200 (CEST) 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: emacs-orgmode@gnu.org Remember to cover the basics, that is, what you expected to happen and what in fact did happen. You don't know how to make a good report? See https://orgmode.org/manual/Feedback.html#Feedback Your bug report will be posted to the Org mailing list. ------------------------------------------------------------------------ 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. Best, mb Emacs : GNU Emacs 27.0.50 (build 2, x86_64-pc-linux-gnu, GTK+ Version 3.24.8) of 2019-06-15 Package: Org mode version 9.2 (release_9.2-215-g5b39d8 @ /home/mbork/others-works/emacs/org-mode/lisp/) -- Marcin Borkowski http://mbork.pl