emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [PATCH] Add missing "stuck" agenda view to Special Agenda Views section of manual
@ 2023-04-08  8:48 Ruslan Bekenev
  2023-04-08 10:42 ` Ihor Radchenko
  0 siblings, 1 reply; 2+ messages in thread
From: Ruslan Bekenev @ 2023-04-08  8:48 UTC (permalink / raw)
  To: emacs-orgmode

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)



^ permalink raw reply related	[flat|nested] 2+ messages in thread

* Re: [PATCH] Add missing "stuck" agenda view to Special Agenda Views section of manual
  2023-04-08  8:48 [PATCH] Add missing "stuck" agenda view to Special Agenda Views section of manual Ruslan Bekenev
@ 2023-04-08 10:42 ` Ihor Radchenko
  0 siblings, 0 replies; 2+ messages in thread
From: Ihor Radchenko @ 2023-04-08 10:42 UTC (permalink / raw)
  To: Ruslan Bekenev; +Cc: emacs-orgmode

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>


^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2023-04-08 10:41 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-04-08  8:48 [PATCH] Add missing "stuck" agenda view to Special Agenda Views section of manual Ruslan Bekenev
2023-04-08 10:42 ` Ihor Radchenko

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).