From mboxrd@z Thu Jan 1 00:00:00 1970 From: Samuel Wales 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: Sun, 23 Jun 2019 12:29:04 -0700 Message-ID: References: <87k1dj2xiq.fsf@mbork.pl> <87d0j9pelr.fsf@nicolasgoaziou.fr> <87wohck0jf.fsf@mbork.pl> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:39735) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hf8An-0007Eo-CB for emacs-orgmode@gnu.org; Sun, 23 Jun 2019 15:29:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hf8Am-0005aP-5F for emacs-orgmode@gnu.org; Sun, 23 Jun 2019 15:29:09 -0400 Received: from mail-lf1-x12a.google.com ([2a00:1450:4864:20::12a]:42614) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hf8Al-0005WJ-QV for emacs-orgmode@gnu.org; Sun, 23 Jun 2019 15:29:08 -0400 Received: by mail-lf1-x12a.google.com with SMTP id x144so992062lfa.9 for ; Sun, 23 Jun 2019 12:29:06 -0700 (PDT) In-Reply-To: <87wohck0jf.fsf@mbork.pl> 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: Marcin Borkowski Cc: emacs-orgmode@gnu.org, Nicolas Goaziou this looks good, but i wonder if newcomers get confused about that todo thing. i am not proposing any solution, just brainstorming. the word todo is used in a few contexts in org: - the todo keyword per se [TODO] - todoish keywords as opposed to doneish keywords - the global todo view as opposed to the general views that cover time [called daily/weekly], structured search [called tags], and free-form search [called search] newcomers might wonder if the global todo view does anything that the general views cannot do, otherwise why does it exist. some newcomers might even wonder if todo means keyword as opposed to blank. don't take this too seriously, but i wonder if that todo- confuses newcomers even though the docstring is now clear. On 6/23/19, Marcin Borkowski wrote: > > On 2019-06-19, at 21:19, Nicolas Goaziou wrote: > >> Hello, >> >> Marcin Borkowski 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. > > I only patched the doctsrings for now. If this is fine, I'll do > a similar thing in the manual. > > WDYT? > > -- > Marcin Borkowski > http://mbork.pl > -- The Kafka Pandemic What is misopathy? https://thekafkapandemic.blogspot.com/2013/10/why-some-diseases-are-wronged.html The disease DOES progress. MANY people have died from it. And ANYBODY can get it at any time.