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

Graham Perrin <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.doc
Message-ID <[email protected]>
The branch main has been updated by grahamperrin:

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

commit c68a09252dd1468aad41dabe184d6bea8c62a3d9
Author:     Graham Perrin <[email protected]>
AuthorDate: 2023-08-15 02:01:20 +0000
Commit:     Graham Perrin <[email protected]>
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.