[PATCH] Add missing "stuck" agenda view to Special Agenda Views section of manual

[PATCH] Add missing "stuck" agenda view to Special Agenda Views section of manual

[Ruslan Bekenev]

Hi guys, 

I’ve been trying to make my custom agenda view and I really wanted to see the list of stuck projects in there. 
Looking at “Special Agenda Views” section of the manual I was sure there is no ~stuck~ special view because it isn’t mentioned there.
Turned out there is such a view, it just mentioned in “Block agenda” section of the manual.

I think "Special Agenda Views” section must also mention ~stuck~ as an option. 

The patch below just adds it. 

Let me know if it makes any sense. 

Thanks,
Ruslan

From 7ffa93aa66eab099d7c41d0d1c99aa97818fd39e Mon Sep 17 00:00:00 2001
From: Ruslan Bekenev <furyinbox@gmail.com>
Date: Sat, 8 Apr 2023 17:38:40 +1000
Subject: [PATCH] doc/org-manual.org; Add missing ~stuck~ agenda view

---
 doc/org-manual.org | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index 4644e5adc..4881b9a76 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -21441,7 +21441,7 @@ Org provides a special hook to further limit items in agenda views:
 ~agenda~, ~agenda*~[fn:: The ~agenda*~ view is the same as ~agenda~
 except that it only considers /appointments/, i.e., scheduled and
 deadline items that have a time specification =[h]h:mm= in their
-time-stamps.], ~todo~, ~alltodo~, ~tags~, ~tags-todo~, ~tags-tree~.
+time-stamps.], ~todo~, ~alltodo~, ~tags~, ~tags-todo~, ~tags-tree~, ~stuck~.
 Specify a custom function that tests inclusion of every matched item
 in the view.  This function can also skip as much as is needed.
 
-- 
2.37.1 (Apple Git-137.1)

Re: [PATCH] Add missing "stuck" agenda view to Special Agenda Views section of manual

[Ihor Radchenko]

Ruslan Bekenev <furyinbox@gmail.com> writes:

> I’ve been trying to make my custom agenda view and I really wanted to see the list of stuck projects in there. 
> Looking at “Special Agenda Views” section of the manual I was sure there is no ~stuck~ special view because it isn’t mentioned there.
> Turned out there is such a view, it just mentioned in “Block agenda” section of the manual.
>
> I think "Special Agenda Views” section must also mention ~stuck~ as an option. 

The purpose of the paragraph you are referring to is not listing all the
special agenda views, but describing `org-agenda-skip-function'. `stuck'
type agenda ignores user-defined `org-agenda-skip-function'.

Canceled.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>