pointed out by Rick Robinson. Found and fixed some grammar problems
at the same time.
Note: the reason for avoiding contractions is two-fold:
1) It makes the text easier to understand for people who speak English
as a second language.
2) Expanding the contractions often reveals poorly worded passages.
eg: options "SCSI_DELAY=15" should be options SCSI_DELAY=15, as config
knows about the "=" and splits it correctly into key=value for the #defines.
The only options that need quotes are those that have numbers as part of
the actual name, eg: "TUNE_1542" and "COMPAT_IBCS2".
Discourage the use of the EXB-2501 by now, and slightly improve the
formatting for this entry.
Correct some minor oddities for the Tandberg entries based on my input
data.
Minor addition to the <!-- tech> section for QIC.
I was in the middle of one of these "projects" when I started
on the next, so they wound up all intermixed)
Move the mailing list entities from authors.sgml to the new file
lists.sgml. Add an entity for majordomo at the same time.
Avoid the use of contractions. This revealed some grammer problems,
and also has the benefit of helping make things clearer for those people
who do make speak English as a their first language.
we are consistent in how they are referenced in the handbook, and
so that they are now all clickable URLs. E.g. no more mis-matched
freebsd-hackers@freebsd.org and hackers@freebsd.org. They are used
just like the individual mail addresses defined in authors.sgml.
E.g. &a.doc will expand to:
FreeBSD documentation project mailing list <freebsd-doc@FreeBSD.ORG>
Be consistent in using the FreeBSD.ORG address. All references
to freebsd.org were changed to FreeBSD.ORG.
Use pre-defined addresses for some individuals where available.
actually follow the links, and change references from DigiBoard
to Digi International (I'm currently working for Digi, and we were
just asked to do the same thing with everything we are working
on when possible, so I figured I might as well do the same under FreeBSD).
1. Import UART technical description from Frank Durda IV
<uhclem@nemesis.lonestar.org>.
2. Push existing sio chapter out of hw.sgml and make a separate
document out of it.
3. Make hw.sgml include the first two under serial devices section.
Submitted by: Frank Durda IV <uhclem@nemesis.lonestar.org> & I
