Page MenuHomeFreeBSD
Differential D46265

handbook/desktop: fix internal xrefs
AbandonedPublic
Actions

Authored by concussious.bugzilla_runbox.com on Aug 10 2024, 8:56 AM.
Tags
Referenced Files
Unknown Object (File)
Fri, Nov 8, 11:23 AM
Unknown Object (File)
Fri, Nov 1, 3:35 PM
Unknown Object (File)
Mon, Oct 28, 12:10 AM
Unknown Object (File)
Thu, Oct 24, 2:53 AM
Unknown Object (File)
Wed, Oct 16, 2:50 AM
Unknown Object (File)
Mon, Oct 14, 2:46 AM
Unknown Object (File)
Sat, Oct 12, 10:36 AM
Unknown Object (File)
Oct 10 2024, 1:53 AM
View All 26 Files
Subscribers
fernape
docs

Details

Reviewers
bcr
fernape
concussious.bugzilla_runbox.com
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 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

https://reviews.freebsd.org/D46264

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

concussious.bugzilla_runbox.com requested review of this revision.Aug 10 2024, 8:56 AM
concussious.bugzilla_runbox.com created this revision.
concussious.bugzilla_runbox.com mentioned this in D46266: handbook/disks: fix internal xrefs.Aug 10 2024, 9:27 AM
fernape requested changes to this revision.Aug 27 2024, 4:46 PM
fernape added a subscriber: fernape.

See https://reviews.freebsd.org/D46266#inline-277720 before working on this

This revision now requires changes to proceed.Aug 27 2024, 4:46 PM
concussious.bugzilla_runbox.com added a comment.Aug 28 2024, 1:42 AM

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

fernape added a comment.Aug 28 2024, 6:42 AM
In D46265#1059046, @concussious.bugzilla_runbox.com wrote:

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 mentioned this in D46480: [documentation]: Fix links.Aug 29 2024, 5:18 PM
concussious.bugzilla_runbox.com resigned from this revision.Sep 2 2024, 3:41 PM

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

concussious.bugzilla_runbox.com abandoned this revision.Sep 2 2024, 3:41 PM

Revision Contents
Changeset List

PathSize
documentation/
content/
en/
books/
handbook/
desktop/
4 lines

Diff 141973

View Options

documentation/content/en/books/handbook/desktop/_index.adoc

Loading...