Most of those were fixed.
- "(s)" used 5 times Please do not form plurals this way. It is a
holdover from lazy programming practices, is difficult to read, and
almost always unnecessary. A plural formed with a plain "s" is usually
correct when speaking about numbers of one or more.
- "in order to" used 6 times Unless "in order to" has some special
meaning here, "to" is simpler.
- "i.e." used 1 time "I.e." (Latin "id est") means "that is" and is
mostly used in academic and scientific writing. Consider replacing
with the more common English words. Both forms are usually followed by
a comma for a verbal pause: "i.e., a b c" or "that is, a b c"
- "e.g." used 1 time "E.g." (Latin "exempli gratia") means "for example"
and is mostly used in academic and scientific writing. Consider
replacing with the more common English words. Both forms are usually
followed by a comma for a verbal pause: "e.g., a b c" or "for example,
a b c"
- "simply" used 3 times Use "simply" to mean "in a simple manner",
"just", or "merely", not the patronizing "details omitted because they
are not simple enough for you". "basically" used 2 times Use
"basically" to mean "essentially" or "fundamentally", not "only the
basics are shown because anything more will be too complicated for
you".
- "the following" used 18 times "as follows" used 3 times If something
is following, the reader can see it without being told.
- "should" used 83 times Use "should" sparingly, it is feeble and
suggests unsureness. Attempt to be imperative: "do this" rather than
"you should do this".
- "you" used 176 times "your" used 84 times "You" and "your" are
informal and subjective. Attempt to be formal and objective: "the
file" rather than "your file".
Reviewed by: wblock
Sponsored by: Absolight
Differential Revision: https://reviews.freebsd.org/D7531
fc5ccafc7a