ref-manual: explain how to un-blacklist a recipe

Submitted by Robert P. J. Day on May 25, 2020, 6:58 p.m. | Patch ID: 172827

Details

Message ID alpine.LFD.2.21.2005251457130.6275@localhost.localdomain
State New
Headers show

Commit Message

Robert P. J. Day May 25, 2020, 6:58 p.m.
Add to explanation of PNBLACKLIST variable how to un-blacklist a
recipe, and the conditions under which that's allowed.

Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>

---

Patch hide | download patch | download mbox

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 364cd09eb..9b85befed 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -10771,11 +10771,27 @@ 
                     <filename>PNBLACKLIST</filename> variable in your
                     <filename>local.conf</filename> file.
                     Here is an example that prevents
-                    <filename>myrecipe</filename> from being built:
+                    <filename>myrecipe</filename> from being built,
+                    along with the reason for its blacklisting:
                     <literallayout class='monospaced'>
      PNBLACKLIST[myrecipe] = "Not supported by our organization."
                     </literallayout>
                 </para>
+
+                <para>
+                    If the blacklisting was done in the recipe file itself,
+                    you can un-blacklist that recipe by setting its blacklist
+                    reason to the empty string in your
+                    <filename>local.conf</filename> file, as in:
+                    <literallayout class='monospaced'>
+     PNBLACKLIST[myrecipe] = ""
+                    </literallayout>
+                    but only if the blacklisting was done with a weak
+                    assignment in the recipe file thusly:
+                    <literallayout class='monospaced'>
+     PNBLACKLIST[myrecipe] ?= "Not supported by our organization."
+                    </literallayout>
+                </para>
             </glossdef>
         </glossentry>