Document priority_for

- Document priority_for
- Related: RHEL-68848

java-21-openjdk.spec

@@ -491,6 +491,16 @@ update-desktop-database %{_datadir}/applications &> /dev/null || :
 exit 0
 }
 
+# We want fastdebug and slowdebug alternatives to have a lower
+# priority than the normal alternatives, so the normal alternatives
+# are the default.
+# If the argument to this macro is non-nil, that is either -fastdebug
+# or -slowdebug, then priority_for will expand to a value one less
+# than the priority global.  If the argument to this macro is nil,
+# that is represents the non-debug or normal package, then the result
+# is the normal priority macro value.
+# This computation is done at RPM macro expansion time, rather than at
+# runtime, to keep scriptlets as simple as possible.
 %define priority_for() %{expand:%[%{?1:1}%{!?1:0} ? %{priority} - 1 : %{priority}]}
 
 %global man_comp .gz
@@ -2400,6 +2410,7 @@ end
 - Use RPM global macro for man page file extension and unwrap --slave lines
 - Comment on alternatives removal in preun and RPM scriptlet idiom
 - Remove unused family macros
+- Document priority_for
 - Resolves: RHEL-71920
 - Resolves: RHEL-71954
 - Resolves: RHEL-69321