Page MenuHomeFreeBSD

handbook/advanced-networking: fix internal xrefs
AbandonedPublic

Authored by ziaee on Aug 9 2024, 10:38 PM.
Tags
Referenced Files
Unknown Object (File)
Sat, Aug 1, 3:38 AM
Unknown Object (File)
Wed, Jul 29, 4:15 PM
Unknown Object (File)
Tue, Jul 28, 10:19 AM
Unknown Object (File)
Sun, Jul 26, 7:39 PM
Unknown Object (File)
Thu, Jul 23, 7:10 AM
Unknown Object (File)
Thu, Jul 23, 1:44 AM
Unknown Object (File)
Wed, Jul 22, 11:44 PM
Unknown Object (File)
Wed, Jul 22, 8:16 PM
Subscribers

Details

Reviewers
bcr
fernape
Group Reviewers
docs
Summary

After testing a previous revision, I discovered internal xrefs generated with crossref: do not work at all on PDF [0].
This revision updates all of the internal links in this chapter to use the syntax instructed in Asciidoctor official doc on xrefs [1].

I am currently going through the rest of the handbook for these while digesting the considerations from x11 refactor, this seems like a great task for me.

[0] https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=266107
[1] https://docs.asciidoctor.org/asciidoc/latest/macros/xref/

Test Plan

Links worked in 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

Event Timeline

ziaee requested review of this revision.Aug 9 2024, 10:38 PM
ziaee created this revision.

Forgot to capitalize "Network Chapter", as it was previously.

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

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