Util-Linux package development
 help / color / mirror / Atom feed
* documents (andoc files), spelling mistakes
@ 2023-07-31  0:13 Bjarni Ingi Gislason
  0 siblings, 0 replies; only message in thread
From: Bjarni Ingi Gislason @ 2023-07-31  0:13 UTC (permalink / raw)
  To: util-linux

  From "codespell"

./misc-utils/uuidd.8.adoc:28: gurantees ==> guarantees

-.-.

./term-utils/scriptlive.1.andoc:

*Be careful!* Do not forget that the typescript may contains arbitrary
commands. It is recommended to use *"scriptreplay --stream in --log-in
typescript"* (or with *--log-io* instead of *--log-in*) to verify the
typescript before it is executed by *scriptlive*.

contains -> contain

-.-.

  The distance between sentences is hardcoded in the sources.

-.-.

  Separate the sentences and subordinate clauses;
each begins on a new line.
See man-pages(7) ("Conventions for source file layout") and "info
groff" ("Input Conventions").

  The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.

Remember coding: Only one command ("sentence") on each (logical) line.

E-mail: Easier to quote exactly the relevant lines.

Generally: Easier to edit the sentence.

Patches: Less unaffected text.

Search for two adjacent words is easier,
when they belong to the same line,
and the same phrase.

  Man pages (with groff, man (man-db)):

  The amount of space between sentences in the output can then be
controlled with the ".ss" request.

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2023-07-31  0:14 UTC | newest]

Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2023-07-31  0:13 documents (andoc files), spelling mistakes Bjarni Ingi Gislason

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox