commit:     46664472272593f89f2e19213366f4ebdf93392e
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Sun Aug  1 01:58:03 2021 +0000
Commit:     Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Sat Aug 14 01:49:47 2021 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=46664472

profiles: mention PMS as the main source of documentation

While `man portage` may be a useful source of information,
it's not the "source of truth" on profiles - PMS is.

Reported-by: Joshua Kinard <kumba <AT> gentoo.org>
Signed-off-by: Sam James <sam <AT> gentoo.org>
Closes: https://github.com/gentoo/devmanual/pull/240
Signed-off-by: Sam James <sam <AT> gentoo.org>

 profiles/text.xml | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/profiles/text.xml b/profiles/text.xml
index 3269d33..f652088 100644
--- a/profiles/text.xml
+++ b/profiles/text.xml
@@ -5,8 +5,12 @@
 
 <body>
 <p>
-This section provides details on the <c>profiles/</c> directory. All of these 
files
-are also documented in <c>man portage</c>.
+This section provides details on the <c>profiles/</c> directory. All of these
+files are also documented in <c>man portage</c>, but the canonical reference
+for profiles is within
+<uri link="https://projects.gentoo.org/pms/8/pms.html#x1-320004.4";>PMS</uri>.
+
+Portage-specific behaviour must not be relied upon in the repository.
 </p>
 </body>
 

Reply via email to