First step of a major overhaul of this chapter. Split into multiple
commits to make it slightly easier on the translation teams.
- Add a standard synopsis
- Remove references to FreeBSD 1.1.5.1 and FreeBSD 1.1. Document the behavior of 4.x / 5.x and ignore the paleontology.
- Move <indexterm>s around so that printed output looks better.
- Reference other chapters in the Handbook instead of duplicating information.
- Rephrase many sentences to be more concise.
- <filename> -> <command>
- Refer to the text as "this chapter" instead of "this document"
- Refer to manual pages consistently.
- Turns a couple of question and answer entries into more formal paragraphs.
- Don't intersperse example commands inside paragraphs as often. Instead, talk about something and then provide an example.
- Mark up contributors in <sectNinfo>.
- Remove synopsis-like information from one of the individual sections, since this has been expanded at the front of the chapter.
- Mark up keys in <keycode>
- Remove acknowledgments section. This is inappropriate for a book chapter and the acknowledged person has been moved to the <sectNinfo> as an additional contributor.
- Remove "information integrated from FAQ", that describes much of our documentation.
- Remove troubleshooting entry about needing to be in a specific group to run tip or cu, since this is no longer the case.
PR: 19481