summaryrefslogtreecommitdiffstats
path: root/manuals.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-03-22 20:55:18 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-03-22 20:55:18 +0000
commitf7595e06b7d68d999e7b45df820581b5b95f1b30 (patch)
tree7f347c603085679934c5fb03d4b88157ad537b22 /manuals.7
parent6f557f6ecc849cf77ee5d8d5a86e1db949877425 (diff)
downloadmandoc-f7595e06b7d68d999e7b45df820581b5b95f1b30.tar.gz
More manuals.7.
Diffstat (limited to 'manuals.7')
-rw-r--r--manuals.716
1 files changed, 4 insertions, 12 deletions
diff --git a/manuals.7 b/manuals.7
index 6b4f2c5d..89bc1d34 100644
--- a/manuals.7
+++ b/manuals.7
@@ -229,20 +229,12 @@ publications, please use the
block macros.
.\" SUBSECTION
.Ss Formatting
-Let the front-ends worry about formatting for you, but if you must think
-about formatting (at times necessary, especially for tagged and columnar
-lists), assume that your output device is a fixed-width terminal window:
-.Bd -literal -offset indent
-\&.Bl \-tag \-width "-o outfile"
-\&.It \&Fl \&Ar outfile
-.Ed
-.Pp
-You may assume that the width calculated by the string literal
-.Qq Fl o Ar outfile
-will be covered by the \-width argument.
+.Em Don't style your manual.
+Give it meaningful content. The front-end will worry about formatting
+and style.
.\" SECTION
.Sh MAINTENANCE
As your component changes and bugs are fixed, your manual may become out
of date. You may be tempted to use automation tools like Doxygen to
smooth the development of your manuals. Don't. Source documentation is
-different from a component manual.
+different from a component manual.