From mboxrd@z Thu Jan 1 00:00:00 1970 From: Marcin Borkowski 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: Mon, 24 Jun 2019 21:08:06 +0200 Message-ID: <87d0j2yf6x.fsf@mbork.pl> References: <87k1dj2xiq.fsf@mbork.pl> <87d0j9pelr.fsf@nicolasgoaziou.fr> <87wohck0jf.fsf@mbork.pl> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:43075) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hfULt-0006sz-Ov for emacs-orgmode@gnu.org; Mon, 24 Jun 2019 15:10:07 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hfULs-0004PN-Aq for emacs-orgmode@gnu.org; Mon, 24 Jun 2019 15:10:05 -0400 Received: from mail.mojserwer.eu ([195.110.48.8]:53460) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hfULs-0004ME-2h for emacs-orgmode@gnu.org; Mon, 24 Jun 2019 15:10:04 -0400 In-reply-to: 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: Samuel Wales Cc: emacs-orgmode@gnu.org, Nicolas Goaziou On 2019-06-23, at 21:29, Samuel Wales wrote: > 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. Good points, though (as you said) this is out of scope of my humble patch:-). Best, -- Marcin Borkowski http://mbork.pl