ref-manual: explain how to un-blacklist a recipe
Details
Commit Message
@@ -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>
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> ---