From patchwork Mon May 25 18:58:28 2020
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: ref-manual: explain how to un-blacklist a recipe
From: "Robert P. J. Day" <rpjday@crashcourse.ca>
X-Patchwork-Id: 172827
Message-Id: <alpine.LFD.2.21.2005251457130.6275@localhost.localdomain>
To: YP docs mailing list <docs@lists.yoctoproject.org>
Date: Mon, 25 May 2020 14:58:28 -0400 (EDT)

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>

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>