Page MenuHomeFreeBSD

handbook/cutting-edge: fix internal xrefs
AbandonedPublic

Authored by ziaee on Aug 10 2024, 8:42 AM.
Tags
Referenced Files
Unknown Object (File)
Fri, Jan 31, 8:25 PM
Unknown Object (File)
Fri, Jan 31, 6:00 AM
Unknown Object (File)
Mon, Jan 27, 4:50 PM
Unknown Object (File)
Dec 18 2024, 2:55 PM
Unknown Object (File)
Dec 5 2024, 7:20 PM
Unknown Object (File)
Oct 16 2024, 10:31 AM
Unknown Object (File)
Oct 6 2024, 8:25 AM
Unknown Object (File)
Oct 5 2024, 5:00 AM
Subscribers

Details

Reviewers
bcr
fernape
Group Reviewers
docs
Summary

Internal crossreferences in the FreeBSD handbook using crossref: are currently broken on PDF output. The official docs [0] say to use <<here-is-the-xref>>. Most xrefs are already written in that notation, they are clean and work great. Update the rest of the remaining xrefs in this chapter to this notation.

[0] : https://docs.asciidoctor.org/asciidoc/latest/macros/xref/

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

Similar fix for boot : https://reviews.freebsd.org/D46263
Similar fix for bsdinstall : https://reviews.freebsd.org/D46262
Similar fix for audit : https://reviews.freebsd.org/D46261
Similar fix for basics : https://reviews.freebsd.org/D46260
Similar fix for advanced networking : https://reviews.freebsd.org/D46258

Test Plan

Building in en/{html,pdf}, and testing links.

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped