From c8c8e3326d5ec47cd2a477e699996b98b7c2a520 Mon Sep 17 00:00:00 2001 From: Ihor Radchenko Date: Wed, 21 Jun 2023 20:22:43 +0300 Subject: [PATCH] org-priority-show: Fix the docstring after changes in "priority" for agenda * lisp/org.el (org-priority-show): Do not wrongly assert that the priority is affected by scheduled and deadline values. This was not true in the past for Org mode buffers, and it is no longer true after 8fab6eeef renamed composite agenda rank from priority to urgency. * etc/ORG-NEWS (~org-priority=show~ command no longer adjusts for scheduled/deadline): Document the change, right before the NEWS item describing changes in the agenda. --- etc/ORG-NEWS | 9 +++++++++ lisp/org.el | 5 ++--- 2 files changed, 11 insertions(+), 3 deletions(-) diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS index a24caddfe..94efa8fa8 100644 --- a/etc/ORG-NEWS +++ b/etc/ORG-NEWS @@ -13,6 +13,15 @@ Please send Org bug reports to mailto:emacs-orgmode@gnu.org. * Version 9.7 (not released yet) ** Important announcements and breaking changes +*** ~org-priority=show~ command no longer adjusts for scheduled/deadline + +In agenda views, ~org-priority=show~ command previously displayed the +composite rank consisting of the item priority and overdue. This is +no longer the case. The displayed and returned value only depends on +the item priority now. + +The behavior in Org buffers is unchanged. + *** "Priority" used to sort items in agenda is renamed to "urgency" Previously, ~priority-up~ and ~priority-down~ in diff --git a/lisp/org.el b/lisp/org.el index 4273385bf..46ca26fb9 100644 --- a/lisp/org.el +++ b/lisp/org.el @@ -10940,9 +10940,8 @@ or a character." (defalias 'org-show-priority 'org-priority-show) (defun org-priority-show () - "Show the priority of the current item. -This priority is composed of the main priority given with the [#A] cookies, -and by additional input from the age of a schedules or deadline entry." + "Show the priority of the current item as number. +Return the priority value." (interactive) (let ((pri (if (eq major-mode 'org-agenda-mode) (org-get-at-bol 'priority)