List three known traps upgrading to 15.0R in the release errata.
Noting: this is 34 days late, but first time since 12.0R
Discussed with: adrian, imp, jhb, jrtc27, ngie
Reviewed by: adrian
I just discovered this driver while auditing apropos results. Turns out,
this driver has existed since FreeBSD 11.0. It was not built by default
initially, but the module is present on my 15.0-RELEASE box.
Add a macro defining the latest current RELEASE that people should use
for new deployments. This will improve consistency and save time bumping
version numbers in handbook examples, which has been suprisingly error
prone.
Jan Brankamp on the Production Users Call suggested we also define a
rel-previous macro. I do not need that yet, but note it here to inspire
future discussion.
Approved by: dch (re)
Differential Revision: https://reviews.freebsd.org/D54293
Judging from the mailing list discussion, this section needs organized
better. While here, sneak in a bit of wordsmithing. We still have a lot
of work to do improving the instructions for upgrading systems installed
with packages, but we have to keep moving.
Discussed with: cperciva (it's still ok to organize better)
Discussed with: ivy (s/distribution/& sets/)
Discussed with: jrm (upgrading from source wordsmithing)
Reviewed by: dch (previous, fixed a typo since)
Differential Revision: https://reviews.freebsd.org/D54181
I tried running plasma wayland on 15.0, it works great! CPU usage
is a tad high, but I'm impressed! Freshen the branding and language
in this chapter to highlight this. Remove a stale note about adjusting
message sizes to what is now the default. Tell the reader how to search
the kde-applications category. Add instructions to launch with wayland.
Reviewed by: carlavilla (previous), makc
Differential Revision: https://reviews.freebsd.org/D54207
+ remove expat, this is a private lib and doesn't have a manual
+ move the thing that is changing to the beginingish of the sentences
+ s/foo/the foo frobber/ to match usual freebsd style
+ fix some markup and punctuation typos
These need to happen before the entries can be alphabetized.
Discussed with: jhb, olce (loosely)
Add the hgame game controller driver, and replace the handwritten sbp
firewire storage driver entry with a maintainable macro which will
notify us instead of creating a dead link if the driver is removed.
This brings in fixes to aacraid, ciss, and ice, adds nvd,
and removes a long lost section about misc. USB hardware.
PR: 290778
Reported by: bigsneaky@duck.com
There are other drivers that people have made included by default in
GENERIC kernels. These drivers need to be announced here because that
comes with a configuration change. If you know any, please come forth.
Add the cherished NVMe storage and SD host controller interface
to the Hardware Release Note.
Those uninitiated in the hardware release note may wonder the
utility of listing a host controller interface in this document.
My mantra in the FreeBSD documentation project is:
"Your use case is not the center of the usecasiverse".
Earlier this week, I had the privilege of hearing the testimony of a
contractor who designed a sensor network for speedboats using FreeBSD.
These MIPS drivers were removed in FreeBSD 14.0. Remove them from the
HW Relnotes template and the notes for versions they did not ship with.
Ref: src: 8f7835acc6d6 (Remove SOC FPGA drivers)
Reported by: jhb
These drivers were removed for FreeBSD 13. They did not appear in any
releases they did not ship with but somehow got back into the template.
Ref: src:43b16da804f6c97209 (Remove adv(4) and adw(4))
This driver was removed in src:23e124c78bcb for FreeBSD 13.0. It appears
in no hardware release notes it did not ship with, but somehow got back
into the template.
Increase utility of the hardware release note by using the official
trade name of the architecture for it's subsection heading, followed
by the hyperlinked name of the freebsd project for that architecture.
In this hardware release note, I am also claiming a minimum RAM req.
This rewrite removes platforms which are no longer shipping in 15.0,
reorganizes the platforms subsections alpheabetically by project,
rewrites the introductory paragraps for each section to accomidate
for this (and past, really) reflow(s), and refreshes the powerpc
subsection with information from ppc@ and the platforms page.
I wish people using niche architectures to clean up their platforms
pages over the next two months. There is good information in there
drowning in a sea of stale info. This looks bad upon the project and
is subject to getting lost in a website rewrite.
Discussed with: antranigv, cperciva, dch, emaste, michaeldexter
Remove the Camera section from the Hardware Release Notes template as
well as the last five years of Hardware notes where it contained only
ficticious entries.
+ The bktr driver was removed in src:daba5ace03e83a930 for FreeBSD 13.0.
+ The connectix quickcam was left over from the original hardware notes.
Hopefully we may be able to re-add the Cameras section in the future.
The u2f USB security key driver was added in src:4a04e0a6c703. Add it to
the Hardware Release Notes template in the Misc section, since the USB
section has a note saying Human Interface Devices are in Misc.
Possible todo: Refactor USB Devices and Misc to create a HID section?
The mtw(4) driver was added in src:c14b016242613 for FreeBSD 15.0
Add it to the Release Hardware Notes in the wireless section.
Reviewed by: carlavilla, mhorne (mentors)
Differential Revision: https://reviews.freebsd.org/D48906
Since this is the only usb sound driver, I think it makes more sense
to put it with the other sound drivers. Especially since nobody has
ever noticied that the link is incorrectly named and it has actually
always been broken.
Reviewed by: christos, mhorne
Differential Revision: https://reviews.freebsd.org/D51262
General:
+ Add many search keywords to tags
+ Add detail to subsections, and an abstract
+ Add drm and kms to glossary
Graphics:
+ drivers logically come first, and explain why we have to install them
+ intel graphics is not always integrated and not always cards
+ add graphics to keywords
+ refactor for flow
+ add markup for linking
Xorg:
+ add an overview subchapter
+ disambiguate Xorg server/X Window System
+ xorg-ins should directly precede xorg-cfg
+ try to tersely explain why at more points
+ autoconfiguration should not be a warning in a previous chapter,
it needs to be part of the introduction to configuration
+ explain libinput, and atomic configuration via xinput and setxkbmap
+ explain why we have xf86-input drivers, there are good use cases
Fonts:
+ sort and sync fonts intro
+ truetype fonts are what most users are looking for, for screens.
+ postscript fonts are specialized for typography, for printing.
+ therefore, move truetype first, and explain the difference.
+ add fonts to keywords
Outstanding:
+ hybrid graphics
+ the fonts section really needs more love, the X freetype module does
not actually exist for many years.
+ xorg configuration => see desktop environments
+ ...the whole thing could still be a little clearer
+ mention fwget
+ consider moving driver installation to basics
Discussed with: bcr, carlavilla, vishwin, Jim Brown
Differential Revision: https://reviews.freebsd.org/D46248
When FreeBSD calls itself Amnesiac, that is not actually the hostname.
It does that when there is no hostname set. It is not a substitute for
assigning a hostname. Setting a hostname or complaining when none is set
would introduce a regression for cases where the hostname is assigned by
the DHCP server. Attempt to clarify the handbook instead of changing the
behavior.
PR: 286847
Reported by: jrtc27
Discussed with: linimon
sio was disconnected from the build in 2008, and removed completely in
2019. These lines have actually been in the hardware release notes since
the first hardware release notes in 4.4R. Remove them from the hardware
release notes template only, we can regenerate the hardware release
notes for the upcoming release.
Ref: 71f0077631fa (Remove sio(4).)
Discussed with: emaste
Reviewed by: mhorne
Approved by: mhorne (mentor)
Differential Revision: https://reviews.freebsd.org/D50526
Remove two lost lines from the hardware release notes template, and the
past two major versions. They appeared in the original 4.4R/i386 notes
and were forgotten when the rest of the entry was removed was removed in
FreeBSD 8.0R.
Discussed with: emaste
Reviewed by: mhorne
Approved by: mhorne (mentor)
Differential Revision: https://reviews.freebsd.org/D50527
These drivers were removed for FreeBSD 13.0. Remove what remains of
them from the hardware release notes template as well as the notes for
versions they did not ship with.
Ref: aa6ea9b6ce25 (remove some long abandoned serial drivers)
Discussed with: emaste, imp
Reviewed by: mhorne
Approved by: mhorne (mentor)
Differential Revision: https://reviews.freebsd.org/D50522
FreeBSD has quite a few drivers supporting several hardware Ethernet
switches. Add all(?) of them to the Hardware Release Notes template,
under a new category since this section is not the smallest section,
and Ethernet Interfaces is quite congested.
Discussed with: adrian (special thanks), bcr, mhorne
Reviewed by: carlavilla
Approved by: carlavilla (mentor)
Differential Revision: https://reviews.freebsd.org/D50303
Add the remaining cryptographic engines which have manuals,
armv8crypto, glxsb, padlock, qat_c2xxx, and safexcel to the
hardware release notes template and the upcoming 14.3 release.
Discussed with: markj, mhorne
Reviewed by: carlavilla
Approved by: carlavilla (mentor)
Differential Revision: https://reviews.freebsd.org/D50403
The Intel qat driver manual has gained a HARDWARE section for inclusion
in the hardware release notes. Add it to the template.
Reviewed by: mhorne
Approved by: mhorne (mentor)
Differential Revision: https://reviews.freebsd.org/D50395
The iwx driver was added in in src:1ad0f7e91582dd (Import iwx) for
FreeBSD 15. Add it to the hardware release notes template.
Reviewed by: mhorne
Approved by: mhorne (mentor)
Differential Revision: https://reviews.freebsd.org/D50119
The xrpu driver was removed in d31fc8ce59a0. Remove its mention from the
Release Hardware Notes template and the last four years of releases.
Reviewed by: carlavilla, emaste
Approved by: carlavilla (mentor)
Differential Revision: https://reviews.freebsd.org/D49672
Alexander Ziaee