git: c68a09252d - main - FreeBSD Handbook: fix a long note

From: Graham Perrin <grahamperrin_at_FreeBSD.org>
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