Hi! This patch just updates documentation to explicitly mention "#" and "%" as valid tag characters as is enforced by `org-set-tags-command'
Thanks, Chris
From 1bc17fbb8baef8b4029dd732855c1153c7a7fc8c Mon Sep 17 00:00:00 2001 From: Chris Perl <[email protected]> Date: Tue, 4 Nov 2025 11:04:11 -0500 Subject: [PATCH] Document "#" and "%" as valid characters in tags * doc/org-guide.org (Tags): Update description of tags to include "#" and "%". * doc/org-manual.org (Tags): Update description of tags to include "#" and "%". `org-set-tags-command' removes any forbidden characters in tags before setting them. It explicitly allows "#" and "%" in addition to the currently documented ones, so update the documentation to match. --- doc/org-guide.org | 7 ++++--- doc/org-manual.org | 12 ++++++------ 2 files changed, 10 insertions(+), 9 deletions(-) diff --git a/doc/org-guide.org b/doc/org-guide.org index 5e59fb025..0db9ff589 100644 --- a/doc/org-guide.org +++ b/doc/org-guide.org @@ -886,9 +886,10 @@ mode has extensive support for tags. Every headline can contain a list of tags; they occur at the end of the headline. Tags are normal words containing letters, numbers, =_=, -and =@=. Tags must be preceded and followed by a single colon, e.g., -=:work:=. Several tags can be specified, as in =:work:urgent:=. Tags -by default are in bold face with the same color as the headline. +=@=, =#=, and =%=. Tags must be preceded and followed by a single +colon, e.g., =:work:=. Several tags can be specified, as in +=:work:urgent:=. Tags by default are in bold face with the same color +as the headline. ** Tag inheritance :PROPERTIES: diff --git a/doc/org-manual.org b/doc/org-manual.org index d69093441..89fe6b392 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -4918,12 +4918,12 @@ mode has extensive support for tags. #+vindex: org-tag-faces Every headline can contain a list of tags; they occur at the end of the headline. Tags are normal words containing letters, numbers, =_=, -and =@=. Tags must be preceded and followed by a single colon, e.g., -=:work:=. Several tags can be specified, as in =:work:urgent:=. Tags -by default are in bold face with the same color as the headline. You -may specify special faces for specific tags using the variable -~org-tag-faces~, in much the same way as you can for TODO keywords -(see [[*Faces for TODO keywords]]). +=@=, =#=, and =%=. Tags must be preceded and followed by a single +colon, e.g., =:work:=. Several tags can be specified, as in +=:work:urgent:=. Tags by default are in bold face with the same color +as the headline. You may specify special faces for specific tags +using the variable ~org-tag-faces~, in much the same way as you can +for TODO keywords (see [[*Faces for TODO keywords]]). ** Tag Inheritance :PROPERTIES: -- 2.51.1
