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/)]

[Samuel Wales <samologist@gmail.com>]

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 <mbork@mbork.pl> wrote:
>
> On 2019-06-19, at 21:19, Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:
>
>> 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.
>
> 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.