Skip to content

handbook: fix outdated references and minor grammar issues#646

Open
hypery11 wants to merge 2 commits intofreebsd:mainfrom
hypery11:fix/handbook-outdated-refs-and-typos
Open

handbook: fix outdated references and minor grammar issues#646
hypery11 wants to merge 2 commits intofreebsd:mainfrom
hypery11:fix/handbook-outdated-refs-and-typos

Conversation

@hypery11
Copy link
Copy Markdown
Contributor

@hypery11 hypery11 commented Apr 6, 2026

Went through a few more handbook chapters and found some stuff that's out of date or just wrong:

  • config: inetd is referenced as a current way to start services, but it's been deprecated. Reworded to note that.
  • disks/gbde: the whole gbde example still uses the old ad* device naming (pre-CAM ATA driver). Updated to ada* to match what people actually see on modern FreeBSD.
  • disks/gbde: there was a NOTE warning about sysinstall being incompatible with gbde. sysinstall has been gone since FreeBSD 10, so I removed it.
  • desktop: "a easy-to-use" → "an easy-to-use", "different kind of documents" → "different kinds"

- config: note that inetd has been deprecated in recent releases
- disks/gbde: update device names from ad* to ada* throughout the
  example to match modern FreeBSD naming
- disks/gbde: remove sysinstall NOTE (sysinstall was removed in
  FreeBSD 10)
- desktop: fix "a easy-to-use" -> "an easy-to-use"
- desktop: fix "different kind" -> "different kinds"

Other services can be started using man:inetd[8].
Working with man:inetd[8] and its configuration is described in depth in crossref:network-servers[network-inetd,“The inetd Super-Server”].
Historically, other services could be started using man:inetd[8], though this has been deprecated in recent FreeBSD releases.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think some services are still operated via inetd, like tftpd.

inetd is still used for some services like tftpd, so the original
wording was fine.
@hypery11
Copy link
Copy Markdown
Contributor Author

Good call on the inetd thing — you're right, tftpd and others still use it. I reverted that change, the original wording is fine.

@sergio-carlavilla
Copy link
Copy Markdown
Contributor

What's left here? Can I proceed?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants