o Remove 4.X information, this includes notes and sections.
o Update documentation to reflect 5.X and 6.X.
o In some areas, try to make the new content version agnostic.
o Skip areas stating "5.[0-5] and later" as it's relevant - we
need a better way to handle these.
For several items, I checked the NOTES files, manual pages,
CVS history, etc.
Discussed on: -doc
A few ideas from: remko
informaltable element properly, unless the pgwide attribute is
explicitly set to 1. Use this consistently within the (en) tree, and
update the FDP accordingly. This should finally silence the demons in:
PR: docs/73095
Submitted by: Hilko Meyer <Hilko dot Meyer at gmx dot de>
in HTML and much better in print.
Also, add a colwidth attribute that makes the print output look better
and has no effect on the HTML output (browsers size the columns there)
- Use trademark entities.
- Add trademark attributions.
- Always use correct case for trademarks.
- Don't join trademarks with other words, e.g. using hyphens.
- Use 'UNIX like systems' instead of 'UNIX systems'.
trademark.ent:
- Add entities for more trademarks / companies.
* 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:
* Reword several paragraphs for clarity.
* Reorganize the section on modifying accounts --
Display a table of available account manipulation commands at the
beginning with a short summary of each, and then use the subsections
to describe each in greater detail with examples.
* First and last word uppercase
* Prepositions, articles, and short conjunctions lowercase
* The word 'to' lowercase
* Preserved capitalization for program/command names
Reviewed by: murray
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.
Placed sh, bash, csh, tcsh in <command>
Placed commands in <command>
Placed options in <option>
Placed several commands in man entities
Placed several applications in <application>
Placed make vars/targets into <makevar>/<maketarget>
Placed filenames in <filename>
<literal>chmod()</literal> -> <function>chmod()</function>
Standardize:
ATT -> AT&T
endeavour -> endeavor
tcl -> Tcl
Reviewed by: murray
Reword a couple of run-on sentences to use better subject-verb
agreement.
Terminate all items in a list with a period, not just some of
them.
Add <username> and <application> tags as appropriate.
"pw(8) has the information"
doesn't look well without the benefits of a hyperlink. Reword this to:
"For more information, please see pw(8)."
Update example to change shells to zsh since tcsh is now in the base
system.
