[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/org f4b881e 35/41: lisp/org.el: Explicit the docstrings
From: |
ELPA Syncer |
Subject: |
[elpa] externals/org f4b881e 35/41: lisp/org.el: Explicit the docstrings of org-priority-highest/lowest |
Date: |
Sun, 16 May 2021 04:57:23 -0400 (EDT) |
branch: externals/org
commit f4b881eb03d37bf540bd5f3b5256e20bc5395051
Author: Bastien <bzg@gnu.org>
Commit: Bastien <bzg@gnu.org>
lisp/org.el: Explicit the docstrings of org-priority-highest/lowest
* lisp/org.el (org-priority-highest, org-priority-lowest): Make
the docstring more explicit.
---
lisp/org.el | 30 +++++++++++++++++++++++++++---
1 file changed, 27 insertions(+), 3 deletions(-)
diff --git a/lisp/org.el b/lisp/org.el
index f7d30b7..7b4512b 100644
--- a/lisp/org.el
+++ b/lisp/org.el
@@ -2448,8 +2448,20 @@ set a priority."
(defcustom org-priority-highest ?A
"The highest priority of TODO items.
+
A character like ?A, ?B, etc., or a numeric value like 1, 2, etc.
-Must be smaller than `org-priority-lowest'."
+
+The default is the character ?A, which is 65 as a numeric value.
+
+If you set `org-priority-highest' to a numeric value inferior to
+65, Org assumes you want to use digits for the priority cookie.
+If you set it to >=65, Org assumes you want to use alphabetical
+characters.
+
+In both cases, the value of `org-priority-highest' must be
+smaller than `org-priority-lowest': for example, if \"A\" is the
+highest priority, it is smaller than the lowest \"C\" priority:
+65 < 67."
:group 'org-priorities
:type '(choice
(character :tag "Character")
@@ -2458,8 +2470,20 @@ Must be smaller than `org-priority-lowest'."
(defvaralias 'org-lowest-priority 'org-priority-lowest)
(defcustom org-priority-lowest ?C
"The lowest priority of TODO items.
-A character like ?A, ?B, etc., or a numeric value like 1, 2, etc.
-Must be higher than `org-priority-highest'."
+
+A character like ?C, ?B, etc., or a numeric value like 9, 8, etc.
+
+The default is the character ?C, which is 67 as a numeric value.
+
+If you set `org-priority-lowest' to a numeric value inferior to
+65, Org assumes you want to use digits for the priority cookie.
+If you set it to >=65, Org assumes you want to use alphabetical
+characters.
+
+In both cases, the value of `org-priority-lowest' must be greater
+than `org-priority-highest': for example, if \"C\" is the lowest
+priority, it is greater than the highest \"A\" priority: 67 >
+65."
:group 'org-priorities
:type '(choice
(character :tag "Character")
- [elpa] externals/org 336efd6 37/41: lisp/*: Use version number when obsoleting, (continued)
- [elpa] externals/org 336efd6 37/41: lisp/*: Use version number when obsoleting, ELPA Syncer, 2021/05/16
- [elpa] externals/org fdd7072 38/41: Merge branch 'master' of code.orgmode.org:bzg/org-mode, ELPA Syncer, 2021/05/16
- [elpa] externals/org 70d98b5 41/41: Merge branch 'master' of code.orgmode.org:bzg/org-mode, ELPA Syncer, 2021/05/16
- [elpa] externals/org df9b509 28/41: lisp/org-attach-git.el: New option `org-attach-git-dir', ELPA Syncer, 2021/05/16
- [elpa] externals/org c7be27d 29/41: Merge remote-tracking branch 'savannah/bugfix', ELPA Syncer, 2021/05/16
- [elpa] externals/org 91373e1 26/41: ox-latex.el: Support specific attributes for verse block, ELPA Syncer, 2021/05/16
- [elpa] externals/org ef495b7 30/41: ox-html: Fix typography in a docstring, ELPA Syncer, 2021/05/16
- [elpa] externals/org 53b5af2 39/41: Merge branch 'maint', ELPA Syncer, 2021/05/16
- [elpa] externals/org b413355 36/41: lisp/ol.el: Enhance message when the link has already been stored, ELPA Syncer, 2021/05/16
- [elpa] externals/org b91e934 33/41: lisp/org.el: Minor enhancement to `org-priority', ELPA Syncer, 2021/05/16
- [elpa] externals/org f4b881e 35/41: lisp/org.el: Explicit the docstrings of org-priority-highest/lowest,
ELPA Syncer <=
- [elpa] externals/org 4362b93 40/41: Merge branch 'maint', ELPA Syncer, 2021/05/16