1 files changed, 31 insertions, 6 deletions

diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 966f7c2663..6d8e7aa0aa 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -5572,14 +5572,37 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
 
         <glossentry id='var-PRINC'><glossterm>PRINC</glossterm>
             <glossdef>
-                <para>Causes the <link linkend='var-PR'><filename>PR</filename></link>
+
+                <para>
+                    The <filename>PRINC</filename> variable has been deprecated
+                    and triggers a warning if detected during a build.
+                    For
+                    <link linkend='var-PR'><filename>PR</filename></link>
+                    increments on changes, use the PR service instead.
+                    You can find out more about this service in the
+                    "<ulink url='&YOCTO_DOCS_DEV_URL;#working-with-a-pr-service'>Working With a PR Service</ulink>"
+                    section in the Yocto Project Development Manual.
+                </para>
+<!--
+
+                <para>
+                    Causes the
+                    <link linkend='var-PR'><filename>PR</filename></link>
                     variable of <filename>.bbappend</filename> files to
                     dynamically increment.
-                    This increment minimizes the impact of layer ordering.</para>
-                <para>In order to ensure multiple <filename>.bbappend</filename> files can co-exist,
+                    This increment minimizes the impact of layer ordering.
+                </para>
+
+                <para>
+                    In order to ensure multiple <filename>.bbappend</filename>
+                    files can co-exist,
                     <filename>PRINC</filename> should be self-referencing.
-                    This variable defaults to 0.</para>
-                <para>Following is an example that increments <filename>PR</filename> by two:
+                    This variable defaults to 0.
+                </para>
+
+                <para>
+                    Following is an example that increments
+                    <filename>PR</filename> by two:
                     <literallayout class='monospaced'>
      PRINC := "${@int(PRINC) + 2}"
                     </literallayout>
@@ -5587,7 +5610,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     this usage is very sensitive to layer ordering.
                     You should avoid explicit assignments as they cannot
                     adequately represent multiple
-                    <filename>.bbappend</filename> files.</para>
+                    <filename>.bbappend</filename> files.
+                </para>
+-->
             </glossdef>
         </glossentry>