Page MenuHomeFreeBSD

handbook/bsdinstall: fix internal xrefs
AbandonedPublic

Authored by concussious.bugzilla_runbox.com on Aug 10 2024, 7:44 AM.
Tags
Referenced Files
Unknown Object (File)
Tue, Nov 5, 8:19 AM
Unknown Object (File)
Wed, Oct 30, 6:41 AM
Unknown Object (File)
Sep 29 2024, 9:46 PM
Unknown Object (File)
Sep 27 2024, 5:52 PM
Unknown Object (File)
Sep 15 2024, 2:12 PM
Unknown Object (File)
Sep 8 2024, 4:58 PM
Unknown Object (File)
Sep 8 2024, 7:17 AM
Unknown Object (File)
Aug 19 2024, 11:58 PM
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 links are already written with that notation, they are clean and they 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 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

Built and test on HTML-en and PDF-en, by opening and clicking around the links.

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

This revision now requires changes to proceed.Aug 13 2024, 3:06 PM

Closing: overcome by events: Fernape fixed the internal macro in D46480!