git: 85cf32848c - main - Porters handbook: Fix pdf build

Go to: [ bottom of page ] [ top of archives ] [ this month ]
From: Sergio Carlavilla Delgado <carlavilla_at_FreeBSD.org>
Date: Wed, 13 Aug 2025 08:30:55 UTC
The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=85cf32848ccf6e1ca6c8825f08023bc2217d6db1

commit 85cf32848ccf6e1ca6c8825f08023bc2217d6db1
Author:     Jim Brown <jpb@jimby.name>
AuthorDate: 2025-08-13 08:29:33 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2025-08-13 08:29:33 +0000

    Porters handbook: Fix pdf build
    
    Differential Revision:  D48476
---
 .../content/en/books/porters-handbook/makefiles/_index.adoc    | 10 +++++-----
 .../content/en/books/porters-handbook/testing/_index.adoc      |  4 ----
 .../content/en/books/porters-handbook/versions/_index.adoc     |  6 ------
 3 files changed, 5 insertions(+), 15 deletions(-)

diff --git a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
index 7b76b21ab1..e98d2ff336 100644
--- a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
@@ -101,8 +101,8 @@ From time to time, some software will use a version scheme that is not compatibl
 
 [TIP]
 ====
-When updating a port, it is possible to use man:pkg-version[8]'s `-t` argument to check if the new version is greater or lesser than before.
-See crossref:makefiles[makefile-versions-ex-pkg-version, Using man:pkg-version\[8\] to Compare Versions].
+When updating a port, it is possible to use the `-t` argument of man:pkg-version[8] to check if the new version is greater or lesser than before.
+See below on how to use  man:pkg-version[8] to compare versions.
 ====
 
 [[makefile-versions-ex-pkg-version]]
@@ -1581,8 +1581,8 @@ USE_GITHUB=	yes
 GH_TAGNAME=	c472d66b
 ....
 
-This creates a versioning scheme that increases over time, and that is still
-before version `0` (see crossref:makefiles[makefile-versions-ex-pkg-version, Using man:pkg-version\[8\] to Compare Versions] for details on man:pkg-version[8]):
+This creates a versioning scheme that increases over time, and that is still before version `0`.
+See crossref:makefiles[makefile-versions-ex-pkg-version, this secion on how to compare versions] using man:pkg-version[8]):
 
 [source,shell]
 ....
@@ -1627,7 +1627,7 @@ USE_GITHUB=	yes
 ....
 
 This creates a versioning scheme that increases over time (well, over commits), and does not conflict with the creation of a `0.7.4` version.
-(See crossref:makefiles[makefile-versions-ex-pkg-version, Using man:pkg-version\[8\] to Compare Versions] for details on man:pkg-version[8]):
+See crossref:makefiles[makefile-versions-ex-pkg-version, this section for how to compare versions] using  man:pkg-version[8]):
 
 [source,shell]
 ....
diff --git a/documentation/content/en/books/porters-handbook/testing/_index.adoc b/documentation/content/en/books/porters-handbook/testing/_index.adoc
index 0f7239536f..4c94b4fc85 100644
--- a/documentation/content/en/books/porters-handbook/testing/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/testing/_index.adoc
@@ -113,9 +113,7 @@ For a new port, `portlint -A` is the most thorough; for an existing port, `portl
 
 Since `portlint` uses heuristics to try to figure out errors, it can produce false positive warnings.
 In addition, occasionally something that is flagged as a problem really cannot be done in any other way due to limitations in the ports framework.
-pass:[<!-- vale Vale.Terms = NO -->]
 When in doubt, the best thing to do is ask on {freebsd-ports}.
-pass:[<!-- vale Vale.Terms = YES -->]
 
 [[testing-porttools]]
 == Port Tools
@@ -354,9 +352,7 @@ The command:
 ....
 
 updates the specified jail to the latest version available.
-pass:[<!-- vale Vale.Terms = NO -->]
 For FreeBSD releases, update to the latest patchlevel with man:freebsd-update[8].
-pass:[<!-- vale Vale.Terms = YES -->]
 For FreeBSD versions built from source, update to the latest git revision in the branch.
 
 [TIP]
diff --git a/documentation/content/en/books/porters-handbook/versions/_index.adoc b/documentation/content/en/books/porters-handbook/versions/_index.adoc
index f7aeec0525..e633ba2fb7 100644
--- a/documentation/content/en/books/porters-handbook/versions/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/versions/_index.adoc
@@ -4060,9 +4060,7 @@ Template:
 |1001509
 |link:https://svnweb.freebsd.org/changeset/base/279287[279287]
 |February 25, 2015
-pass:[<!-- vale Vale.Terms = NO -->]
 |10-STABLE after FreeBSD-EN-15:01.vt, FreeBSD-EN-15:02.openssl, FreeBSD-EN-15:03.freebsd-update, FreeBSD-SA-15:04.igmp, and FreeBSD-SA-15:05.bind.
-pass:[<!-- vale Vale.Terms = YES -->]
 
 |1001510
 |link:https://svnweb.freebsd.org/changeset/base/279329[279329]
@@ -4710,9 +4708,7 @@ pass:[<!-- vale Vale.Terms = YES -->]
 |903508
 |link:https://svnweb.freebsd.org/changeset/base/279287[279287]
 |February 25, 2015
-pass:[<!-- vale Vale.Terms = NO -->]
 |9-STABLE after FreeBSD-EN-15:01.vt, FreeBSD-EN-15:02.openssl, FreeBSD-EN-15:03.freebsd-update, FreeBSD-SA-15:04.igmp, and FreeBSD-SA-15:05.bind.
-pass:[<!-- vale Vale.Terms = YES -->]
 
 |903509
 |link:https://svnweb.freebsd.org/changeset/base/296219[296219]
@@ -5495,9 +5491,7 @@ pass:[<!-- vale Vale.Terms = YES -->]
 |804508
 |link:https://svnweb.freebsd.org/changeset/base/279287[279287]
 |February 25, 2015
-pass:[<!-- vale Vale.Terms = NO -->]
 |8-STABLE after FreeBSD-EN-15:01.vt, FreeBSD-EN-15:02.openssl, FreeBSD-EN-15:03.freebsd-update, FreeBSD-SA-15:04.igmp, and FreeBSD-SA-15:05.bind.
-pass:[<!-- vale Vale.Terms = YES -->]
 
 |804509
 |link:https://svnweb.freebsd.org/changeset/base/305736[305736]