This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.
Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.
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.
"+=" originally because (as I understand) Jordan used a sed script (or
was it perl?) to edit all the ports Makefiles automatically and he
wanted to make sure multiple CATEGORIES lines (they were inserted
after DISTNAME or something, there shouldn't have been multiple of
them to begin with but that's another story) won't be stepping on each
other's toes.
Reminded by: obrien
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.
All cross reference labels start with name of the file that contains
them. A label for the top section level is simply the name of the
file (omitting the .sgml). Other references within the file append a
colon and onother name. For example, the label on the mailing list
section in the file eresources.sgml is eresources:mail. This gives
each file its own cross reference namespace.
Rearranged a few sections, add memoryuse section.
current.sgml, ports.sgml, porting.sgml
Added a <label>s for cross reference targes.
submitters.sgml
Lots of editing, added cross references to other sections of
the handbook. Added a sample BSD-style copyright statement.
eresources.sgml
Updated the mailing list section, thanks to Peter Dufault.
authors.sgml
Added Peter Dufault, David Greenman and Joerg Wunsch.
memoryuse.sgml
A new section about how/where in PC memory the FreeBSD kernel
gets loaded and run.
Jordan K. Hubbard
Peter Wemm
Masafumi Max NAKANE
Mike Pritchard
Satoshi Asami
Wolfram Schneider
John Fieber
James Raynard
Jean-Marc Zucconi