Page MenuHomeFreeBSD

handbook/basics: fix internal xrefs
AbandonedPublic

Authored by ziaee on Aug 10 2024, 12:14 AM.
Tags
Referenced Files
Unknown Object (File)
Fri, Oct 3, 12:28 AM
Unknown Object (File)
Sep 4 2025, 4:52 PM
Unknown Object (File)
Sep 4 2025, 1:55 PM
Unknown Object (File)
Sep 3 2025, 10:10 PM
Unknown Object (File)
Sep 3 2025, 4:03 PM
Unknown Object (File)
Jul 6 2025, 12:23 AM
Unknown Object (File)
Jun 25 2025, 9:33 PM
Unknown Object (File)
Jun 24 2025, 11:27 AM
Subscribers

Details

Reviewers
bcr
fernape
Group Reviewers
docs
Summary

This revision updates all of the internal xrefs in this chapter to use the syntax instructed in Asciidoctor official doc on xrefs because crossref: is (uncrossreferencable) broken on pdf and possibly elsewhere.

Related bug : [https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=266107]

Similar fix for advanced networking chapter : [https://reviews.freebsd.org/D46258]

Asciidoctor doc reference [https://docs.asciidoctor.org/asciidoc/latest/macros/xref/]

Test Plan

Tested PDF located at doc/documentation/public/en/books/handbook/handbook_en.pdf generated with make pdf-books DOC_LANG="en" HUGO_ARGS="--verbose --debug".

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped