Re: [O] Bug: agenda interaction with org-agenda-dim-blocked-tasks, org-agenda-max-entries and org-enforce-todo-dependencies [8.3beta (release_8.3beta-785-gb5d9f4 @ /Users/yn/dotfiles/org.emacs.d/org-mode/lisp/)]

[Yuri Niyazov]

On Tue, Feb 3, 2015 at 2:12 PM, Nicolas Goaziou <address@hidden> wrote:
> Documentation (e.g., docstrings) may be improved, then. Would you want
> to suggest such an improvement?

In the docstring for "org-agenda-dim-blocked-tasks"

"Because dimming is not the same as skipping, items dimmed to
invisible count against the limits specified by org-agenda-max-*"

In the docstring for entries like org-agenda-max-entries and
org-agenda-max-todos

"If org-agenda-dim-blocked-tasks is set to invisible, those entries
will still count towards the limits specified by this setting."

> As you noticed, skipping is not the same as dimming. The latter is
> purely visual. See `org-agenda-skip-function' to really skip tasks from
> agenda, and probably `org-entry-blocked-p' to ignore blocked tasks.

I now think that having the ability to dim to invisible is a feature
mistake. I'm having a difficult time seeing when a user would want to
dim to invisible purely visually, rather than really skipping a
blocked task. There's no visual difference between dimming to
invisible and skipping, but they have subtly different and
non-intuitive differences in behavior. A better fix would be to create
a org-agenda-skip-blocked-tasks setting (which would be implemented
much like other skip settings) and in the docstring in dim to
invisible setting explain the difference and point to the new setting,
and maybe eventually deprecate dim to invisible.

If you think that is an acceptable direction, I am happy to start
working on a patch.