- Eliminate reference to books for generalization ("document")
- Use <sgmltag> where applicable
- Mark up quotes with <quote>
- Fix spelling of "non-breaking"
sentence at the end of a paragraph so that the readers don't think
that some text is missing.
Consistently use colons to finish sentences introductory to examples.
most widely used. This is not really a change of policy, just
documenting the current de facto policy.
Quoting blackend (but don't blame this commit on him):
CD-ROM seems to be the more widely used spelling, most of new
additions use CD-ROM, "legacy" docs use CDROM. Since CD-ROM
may be seen as the right solution, let's keep the old spelling
for the moment and just use CD-ROM in every new additions.
Semi-intresting google statistics: 9,950,000 hits for CDROM,
28,800,000 hits for "CD-ROM".
PR: docs/77535
Submitted by: Jesus R. Camou <jcamou@cox.net>
* Use ftp.hostname.com/directory rather than
ftp.hostname.com:directory.
* s/freebsd.org/FreeBSD.org/
* Use relative links for FreeBSD.org documents
PR: 31447
Submitted by: Cyrille Lefevre
Found by: linbot
dictionary, so it doesn't make sense to list common, every-day words
with well-known spellings. Besides, "can not" is a proper, albeit
confusing, construct. For example:
The quick brown fox can not jump over the lazy dog.
The above isn't saying that the fox isn't capable of jumping over the
dog, but rather that the fox is capable of *not* jumping over it
(e.g., it can walk around it). It is confusing (and should be
avoided), but nonetheless valid, English.
documentation is placed under it. Replaces the empty FAQ section and the
only partly completed Handbook section. This is because the information
in here applies to all the documentation under doc/, not just the Handbook.
Move the style guide information out of the-handbook/chapter.sgml and in
to writing-style/chapter.sgml. It doesn't really belong here either, but
we don't have a general style chapter (yet).
Update Makefile to know about this, and use the doc.project.mk file.
Update book.sgml to know about the new chapter.
Remove the old chapters.
enough for most people, and gets it into the repository, making it
easier for others to add to as necessary.
This has not (yet) been turned on in the upper level Makefile or
listed on the web site yet, I want to get some more feedback
from readers first. It should be "made visible" later this week.
