aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSam James <sam@gentoo.org>2021-08-01 02:58:03 +0100
committerSam James <sam@gentoo.org>2021-08-14 02:49:47 +0100
commit46664472272593f89f2e19213366f4ebdf93392e (patch)
tree7f77192fc3f6e34bdf5dd3b0935c431f706ac707 /profiles
parentebuild-writing/file-format: rewrap long paragraph (diff)
downloaddevmanual-46664472272593f89f2e19213366f4ebdf93392e.tar.gz
devmanual-46664472272593f89f2e19213366f4ebdf93392e.tar.bz2
devmanual-46664472272593f89f2e19213366f4ebdf93392e.zip
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@gentoo.org> Signed-off-by: Sam James <sam@gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/240 Signed-off-by: Sam James <sam@gentoo.org>
Diffstat (limited to 'profiles')
-rw-r--r--profiles/text.xml8
1 files 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>