git: c68a09252d - main - FreeBSD Handbook: fix a long note
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Tue, 15 Aug 2023 02:05:36 UTC
The branch main has been updated by grahamperrin:
URL: https://cgit.FreeBSD.org/doc/commit/?id=c68a09252dd1468aad41dabe184d6bea8c62a3d9
commit c68a09252dd1468aad41dabe184d6bea8c62a3d9
Author: Graham Perrin <grahamperrin@FreeBSD.org>
AuthorDate: 2023-08-15 02:01:20 +0000
Commit: Graham Perrin <grahamperrin@FreeBSD.org>
CommitDate: 2023-08-15 02:01:20 +0000
FreeBSD Handbook: fix a long note
The unusually long note at
https://github.com/freebsd/freebsd-doc/commit/a7640c82441bdf19f738af7d3b144b011750e0be?diff=unified#diff-ea68d032fa51f56f82ff87b0de858972275dc98728c98e5a8b28b6ef9640cc1cR1208-R1299
(lines 1208–1299) included a title and paragraph; a table; some
paragraphs, one of which referenced the table; then a callout list,
with number 2 referencing the same table.
The nested table at
https://docs-archive.freebsd.org/doc/11.1-RELEASE/usr/local/share/doc/freebsd/en_US.ISO8859-1/books/handbook/makeworld.html#updating-src-obtaining-src-checkout
scales well enough when the browser window is narrowed.
Nesting in the current edition of the chapter, captured at
https://web.archive.org/web/20230810000557/https://docs.freebsd.org/en/books/handbook/cutting-edge/#synching
does not scale so well.
PDF is similarly bugged; page 597 under
https://web.archive.org/web/20230813183522if_/https://download.freebsd.org/doc/en/books/handbook/handbook_en.pdf#%5B%7B%22num%22%3A4112%2C%22gen%22%3A0%7D%2C%7B%22name%22%3A%22XYZ%22%7D%2C0%2C260.15%2Cnull%5D
The original note was probably intended to end after the first
paragraph – before the table. Do this now, before other changes to the
chapter.
Fixes: a7640c82441b Rewrite the Build from Source section, simplifying and clarifying.
---
documentation/content/en/books/handbook/cutting-edge/_index.adoc | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/documentation/content/en/books/handbook/cutting-edge/_index.adoc b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
index 6b11ddc80d..8f33b9a18e 100644
--- a/documentation/content/en/books/handbook/cutting-edge/_index.adoc
+++ b/documentation/content/en/books/handbook/cutting-edge/_index.adoc
@@ -783,10 +783,11 @@ After it finishes, the source code is up to date and the build process described
[NOTE]
====
-*Obtaining the Source:* +
+Obtaining the source:
If the output says `fatal: not a git repository`, the files there are missing or were installed with a different method.
A new checkout of the source is required.
+====
[[updating-src-obtaining-src-repopath]]
.FreeBSD Versions and Repository Branches
@@ -833,7 +834,6 @@ That path is used when checking out the source:
<.> Move the old directory out of the way. If there are no local modifications in this directory, it can be deleted.
<.> The path from <<updating-src-obtaining-src-repopath>> is added to the repository URL. The third parameter is the destination directory for the source code on the local system.
-====
[[updating-src-building]]
=== Building from Source