On Tue, Feb 3, 2015 at 2:12 PM, Nicolas Goaziou <m...@nicolasgoaziou.fr> 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.