Bug 255026 - many kernel configuration files link to outdated Handbook version
Summary: many kernel configuration files link to outdated Handbook version
Status: New
Alias: None
Product: Base System
Classification: Unclassified
Component: kern (show other bugs)
Version: CURRENT
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
Depends on:
Reported: 2021-04-13 08:46 UTC by Michael Büker
Modified: 2021-04-19 08:57 UTC (History)
4 users (show)

See Also:

Patch for src/* (34.12 KB, patch)
2021-04-14 13:51 UTC, Ceri Davies
no flags Details | Diff
New patch (34.41 KB, patch)
2021-04-19 08:57 UTC, Ceri Davies
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Michael Büker 2021-04-13 08:46:50 UTC
Almost all kernel configuration files contain in their header the following Handbook link:


However, that links to an outdated version of the Handbook, and should be:


The following 35 kernel configuration files are affected:

# grep -Rl "en_US.ISO8859-1" /usr/src/sys/*/conf/

Comment 1 Ceri Davies 2021-04-14 13:51:59 UTC
Created attachment 224107 [details]
Patch for src/*

Mega patch for all of src attached.

RELNOTES_LANG in release/Makefile doesn't seem to do anything, but the removal might need testing.
Comment 2 Ed Maste freebsd_committer 2021-04-14 18:02:47 UTC
Should the new link be:

Comment 3 Graham Perrin 2021-04-14 18:14:15 UTC
8.4 at <https://docs.freebsd.org/en/books/handbook/kernelconfig-config.html> does appear to be outdated, compared to 8.4 at <https://docs.freebsd.org/en/books/handbook/kernelconfig/#kernelconfig-config>

The former refers to: 

> Section A.3, “Using Subversion”

If one begins at the FreeBSD home page, then the FreeBSD Handbook finds 'Using Subversion' at section _4_ of Appendix A, <https://docs.freebsd.org/en/books/handbook/mirrors/#svn>.
Comment 4 Michael Büker 2021-04-17 06:29:32 UTC
I concur, the correct link is:

Comment 5 Ceri Davies 2021-04-19 08:57:12 UTC
Created attachment 224244 [details]
New patch

New patch attached.