On 2026-01-25 06:53, Ihor Radchenko wrote:
> Applied, onto main. […] There was a typo in the ORG-NEWS
> announcement.
Thanks, good catch!
>> Subject: [PATCH 4/6] Improve documentation of numeric priorities
>>
>> * doc/org-guide.org (Priorities): Describe numeric priorities
>> --8<--
>
> I think changes to org-guide a bit too much. org-guide is supposed
> to be short and not overloaded with various customization. Talking
> about numerical priories seems to be an overkill in my eyes.
Fair enough! I’ve attached the remaining documentation changes
separately, in case there’s parts you want to apply and squash.
>> There’s some priority logic that has to change in [‘org-ql'] (and
>> [‘org-super-agenda’] to a lesser extent) which may need bug
>> reports. […] Are there any other popular packages that might be
>> affected?
>> --8<--
>> [‘org-ql’]<https://github.com/alphapapa/org-ql>
>> [‘org-super-agenda’]<https://github.com/alphapapa/org-super-agenda>
>
> org-jira
Thanks, I’ve:
+ left a comment on [PR #313] to ‘org-ql’ by Tommy Jollyboat (who
started this thread),
+ opened [bug #287] in ‘org-super-agenda’,
+ opened [bug #382] in ‘org-jira’,
[PR #313]
<https://github.com/alphapapa/org-ql/pull/313#issuecomment-3802119534>
[bug #287]
<https://github.com/alphapapa/org-super-agenda/issues/287>
[bug #382]
<https://github.com/ahungry/org-jira/issues/382>
--
Jacob S. Gordon
[email protected]
Please don’t send me HTML emails or MS Office/Apple iWork documents.
https://useplaintext.email/#etiquette
https://www.fsf.org/campaigns/opendocument
From 2dca0a45aa40930e14ef02b0a9a1334d3722295f Mon Sep 17 00:00:00 2001
From: "Jacob S. Gordon" <[email protected]>
Date: Mon, 26 Jan 2026 16:20:00 -0500
Subject: [PATCH v2 1/3] org-manual: Correct documentation of in-buffer
priority settings
* doc/org-manual.org (Summary of In-Buffer Settings): Correct range of
numeric priorities.
---
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 7e9756d09..c60179364 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -20774,7 +20774,7 @@ ** Summary of In-Buffer Settings
#+vindex: org-priority-lowest
#+vindex: org-priority-default
This line sets the limits and the default for the priorities. All
- three must be either letters A--Z or numbers 0--9. The highest
+ three must be either letters A--Z or numbers 0--64. The highest
priority must have a lower ASCII number than the lowest priority.
- =#+PROPERTY: Property_Name Value= ::
base-commit: 707eaf6c24d7e91df1a2419a87269b4ba0a30f22
--
Jacob S. Gordon
[email protected]
Please don’t send me HTML emails or MS Office/Apple iWork documents.
https://useplaintext.email/#etiquette
https://www.fsf.org/campaigns/opendocument
From 5ed5225f3a2383502fe94ff13585493aa97f4dc6 Mon Sep 17 00:00:00 2001
From: "Jacob S. Gordon" <[email protected]>
Date: Mon, 26 Jan 2026 16:21:00 -0500
Subject: [PATCH v2 2/3] org-manual: Generalize documentation of urgency score
* doc/org-manual.org (Sorting of agenda items): Generalize description
of urgency score.
---
doc/org-manual.org | 10 ++++++----
1 file changed, 6 insertions(+), 4 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index c60179364..a01cee6f9 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -9790,10 +9790,12 @@ *** Sorting of agenda items
time-of-day specification. These entries are shown at the beginning
of the list, as a /schedule/ for the day. After that, items remain
grouped in categories, in the sequence given by ~org-agenda-files~.
- Within each category, items are sorted by urgency, which is composed
- of the base priority (see [[*Priorities]]; 2000 for priority =A=, 1000
- for =B=, and 0 for =C=), plus additional increments for overdue
- scheduled or deadline items.
+ Within each category, items are sorted by urgency, which is derived
+ from the priority (see [[*Priorities]]), plus additional increments
+ for overdue scheduled or deadline items. The lowest priority is
+ scored as 0, the next as 1000, and continues in steps of 1000 until
+ reaching the highest priority, e.g., =C=, =B=, =A= are scored as 0,
+ 1000, and 2000, respectively.
- For the TODO list, items remain in the order of categories, but
within each category, sorting takes place according to urgency. The
--
Jacob S. Gordon
[email protected]
Please don’t send me HTML emails or MS Office/Apple iWork documents.
https://useplaintext.email/#etiquette
https://www.fsf.org/campaigns/opendocument
From ee27c503c78a77b8f40f21c79a3f9e0724ee7c09 Mon Sep 17 00:00:00 2001
From: "Jacob S. Gordon" <[email protected]>
Date: Mon, 26 Jan 2026 16:22:00 -0500
Subject: [PATCH v2 3/3] org-guide: Correct typo in export settings
* doc/org-guide.org (Export Settings): Correct typo.
---
doc/org-guide.org | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/doc/org-guide.org b/doc/org-guide.org
index ae8fe602d..3a1bf59ab 100644
--- a/doc/org-guide.org
+++ b/doc/org-guide.org
@@ -2150,7 +2150,7 @@ ** Export Settings
: #+TITLE: I'm in the Mood for Org
-Most proeminent export options include:
+Most prominent export options include:
| =TITLE= | the title to be shown |
| =AUTHOR= | the author (default taken from ~user-full-name~) |
--
Jacob S. Gordon
[email protected]
Please don’t send me HTML emails or MS Office/Apple iWork documents.
https://useplaintext.email/#etiquette
https://www.fsf.org/campaigns/opendocument
