aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2024-11-12 21:47:19 +0100
committerUlrich Müller <ulm@gentoo.org>2024-11-12 21:47:19 +0100
commit3dec896a60f1bcf8b3a85445805ccf5dcd72b6a8 (patch)
tree6ecd5a2191c0524cdd8621b5ba8b9e9e9eca1ed6 /ebuild-writing
parentdevbook.xsl: Rework the contents template (diff)
downloaddevmanual-master.tar.gz
devmanual-master.tar.bz2
devmanual-master.zip
Refer to the Package Manager Specification by its full nameHEADmaster
Other small updates of wording (when in the same paragraph). Fix/update some external links. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
Diffstat (limited to 'ebuild-writing')
-rw-r--r--ebuild-writing/eapi/text.xml14
-rw-r--r--ebuild-writing/file-format/text.xml6
-rw-r--r--ebuild-writing/variables/text.xml11
3 files changed, 15 insertions, 16 deletions
diff --git a/ebuild-writing/eapi/text.xml b/ebuild-writing/eapi/text.xml
index c14a941..887ee29 100644
--- a/ebuild-writing/eapi/text.xml
+++ b/ebuild-writing/eapi/text.xml
@@ -5,9 +5,9 @@
<body>
<p>
-The <uri link="https://wiki.gentoo.org/wiki/Project:PMS">Package Manager
-Specification (PMS)</uri> is a standardization effort to ensure that the
-ebuild file format, the ebuild repository format (of which the Gentoo
+The <uri link="https://wiki.gentoo.org/wiki/Project:Package_Manager_Specification">
+Package Manager Specification</uri> is a standardization effort to ensure that
+the ebuild file format, the ebuild repository format (of which the Gentoo
repository is Gentoo's main incarnation) as well as behaviour of the package
managers interacting with these ebuilds is properly written down and agreed
upon.
@@ -16,8 +16,8 @@ upon.
<p>
EAPI is a version defined in ebuilds and other package manager related files
which informs the package manager about the file syntax and content. It is,
-in effect, the version of the package manager specification (PMS) that the
-file adheres to.
+in effect, the version of the Package Manager Specification that the file
+adheres to.
</p>
<p>
@@ -49,8 +49,8 @@ EAPI=7
</codesample>
<note>
-Most developers prefer to set the EAPI version without quotes. However, the PMS
-allows single and double quotes as well.
+Most developers prefer to set the EAPI version without quotes. However,
+enclosing it in single or double quotes is also allowed.
</note>
<important>
diff --git a/ebuild-writing/file-format/text.xml b/ebuild-writing/file-format/text.xml
index 8d93317..038c7ee 100644
--- a/ebuild-writing/file-format/text.xml
+++ b/ebuild-writing/file-format/text.xml
@@ -122,11 +122,11 @@ ebuild version components.
</p>
<p>
-The formal specification of version
+The formal definition of the
<uri link="https://projects.gentoo.org/pms/8/pms.html#x1-250003.2">
-format</uri> and the comparison
+version format</uri> and the
<uri link="https://projects.gentoo.org/pms/8/pms.html#x1-260003.3">
-algorithm</uri> can be found in PMS.
+comparison algorithm</uri> can be found in the Package Manager Specification.
</p>
</body>
diff --git a/ebuild-writing/variables/text.xml b/ebuild-writing/variables/text.xml
index 5477ecb..571bc9c 100644
--- a/ebuild-writing/variables/text.xml
+++ b/ebuild-writing/variables/text.xml
@@ -458,8 +458,7 @@ and the same set of mirrors is shared across multiple ebuilds, then you
don't have to repeatedly list each of them in every ebuild.
The <c>profiles/thirdpartymirrors</c> file in the <c>::gentoo</c> repository
contains named groups of mirrors, in the format specified by the
-Package Manager Specification (PMS), accessible through the
-<c>mirror://</c>
+Package Manager Specification, accessible through the <c>mirror://</c>
pseudo-protocol.
</p>
@@ -710,10 +709,10 @@ While Portage may recognise several different <c>RESTRICT</c> tokens, it is
important that you do not rely on them existing. That is, you should ensure
your ebuild does not fail if those tokens are not exposed or given a different
name by another package manager. You can make use of Portage-provided
-<c>RESTRICT</c> tokens, but do not fail hard without them. See
-<uri link="https://projects.gentoo.org/pms/7/pms.html#x1-810008.2.8">
-PMS</uri> for the list of standardised <c>RESTRICT</c> tokens, or the above
-table.
+<c>RESTRICT</c> tokens, but do not fail hard without them. See the
+<uri link="https://projects.gentoo.org/pms/8/pms.html#x1-680007.3.6">
+Package Manager Specification</uri> for the list of standardised
+<c>RESTRICT</c> tokens, or the above table.
</p>
</body>