Page MenuHomeFreeBSD

handbook/desktop: fix internal xrefs
AbandonedPublic

Authored by concussious.bugzilla_runbox.com on Aug 10 2024, 8:56 AM.
Tags
Referenced Files
F94576459: D46265.diff
Tue, Sep 17, 6:23 PM
Unknown Object (File)
Mon, Sep 9, 1:21 AM
Unknown Object (File)
Sun, Sep 8, 12:51 AM
Unknown Object (File)
Tue, Aug 20, 12:28 AM
Unknown Object (File)
Aug 13 2024, 4:45 PM
Subscribers

Details

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 cutting-edge : https://reviews.freebsd.org/D46264
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

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

This revision now requires changes to proceed.Tue, Aug 27, 4:46 PM

Thank you sir. I have tried several things to no avail and I am still working on this issue.

Thank you sir. I have tried several things to no avail and I am still working on this issue.

I have something that works in all outputs, but it needs some clean up.
I'll keep you posted.

Fernape has fixed the internal macro in D46480, so I'm going to close this.