- Use trademark entities.
- Add trademark attributions.
- Always use correct case for trademarks.
- Don't join trademarks with other words, e.g. using hyphens.
- Don't use trademarks as nouns (e.g. don't use "Windows NT's").
diskless-x/article.sgml:
- While I'm here anyway add trademark tags for all trademarks, now
that the stylesheet handles it right.
trademark.ent:
- Add entities for more trademarks / companies.
Also rename the 3Com trademark entity from t3com to tm.3com. This
should make the entity naming convention a bit more consitent. This is
done now since the entity is not used too many places yet.
files, and a grep on all the manpages shows that this is used more
often. Try to be a tiny bit more consistent.
PR: docs/36624
Submitted by: Martin Heinen <martin@sumuk.de>
Some parts of the documentation are using COM1:
instead of COM1 to describe the first serial interface
in MS-DOS. The device name should be COM1, ':' was used
as separator by the mode command.
PR: 36010
Submitted by: Martin Heinen <martin@sumuk.de>
* After reading this chapter you will know:
-> After reading this chapter, you will know:
* Before reading this chapter you should:
-> Before reading this chapter, you should:
* First and last word uppercase
* Prepositions, articles, and short conjunctions lowercase
* The word 'to' lowercase
* Preserved capitalization for program/command names
Reviewed by: murray
instead of creating a new subsection for each field. The output is
much more succinct and legible.
- Add a note about FreeBSD 5.0 and devfs that obviates the 'Making
Device Special Files' section.
- Remove reference to a book that we don't have any bibliographical
information for and that is a bit tangential to the subject at hand
(RS-232 Bible).
- Add missing words to make complete sentences.
- Simplify discussion of null-modem and "straight" serial cables.
- Consistently use a replaceable 'N' for the last character of
terminal devices instead of interspersing ? and X.
- Remove duplicate 'See the sio(4) manual page for more information.'
lines. One of these is quite sufficient per section.
- Remove more duplicate information that is unnecessary since this
chapter has been reorganized.
- Enclose a hint in the <tip> tag.
This chapter still needs work.
* OSs -> Operating Systems
* commmunications -> communications
* realise -> realize
* customising -> customizing
* customise -> customize
* realise -> realize
* behaviour -> behavior
British to American spelling for some of the above words only in the
Handbook as discussed on -doc.
Reviewed by: murray
Many of the sections in this chapter contained duplicate information
(about FreeBSD 1.1.5.1, mind you).
This commit adds a more substantial introduction section with
information about terminology, cables and ports, kernel configuration
of serial devices, and using stty for serial configuration. The
remaining sections ("terminals", "dial-in service", "dial-out
service", and "setting up a serial console") can then refer to this
earlier section instead of duplicating how to setup /etc/ttys and HUP
init, etc. in each one.
Also contains a couple more markup fixes for <keycode>s.
PR: 19481
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
