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
* inter-operate -> interoperate
* e-mail -> email (email is used much more throughout the rest of the
handbook)
* Open System -> open system
* on-line -> online
While I'm here, fix some punctuation as well.
introduction. While I'm at it, change "dipped in to" to "read" in the
system administration intro. Also reword the first sentence to read a
little better.
index. Our index is layed out differently (two columns) so the rule
overlaps text. This only affects the NICE_HEADERS option for print
output.
PR: 29403
Submitted by: Peter Johnson <peter@bilogic.org>
Nuke the distinction between the Networking and Advanced <part>s.
These are all now one big System Administration <part>.
Add some chat to the beginning of the two main parts explaining what
they are for, and how they are organised.
"Contributors List" article.
Remove the list of contributors from the "Contributing to FreeBSD"
chapter.
Remove the "High Priority Tasks" and "Medium Priority Tasks" from the
"Contributing to FreeBSD" chapter since this destined to always be
hopelessly out of date. Keep the information about what we always
need.
Before reading this chapter you should have read:
* Unix Basics (Chapter ..)
to
Before reading this chapter you should:
* Read ....
so the same boilerplate text can be used with the other synopses.
