summaryrefslogtreecommitdiffstatshomepage
path: root/manuals.7
diff options
context:
space:
mode:
authorKristaps Dzonsons <kristaps@bsd.lv>2009-07-27 13:10:08 +0000
committerKristaps Dzonsons <kristaps@bsd.lv>2009-07-27 13:10:08 +0000
commitb47e561cf549df2f08947057fecfe611e1f25f89 (patch)
treec41d70f7255eb877fab79a20f0d6d09a08e2ac23 /manuals.7
parent29761020ae538441c939e621297260904dba1160 (diff)
downloadmandoc-b47e561cf549df2f08947057fecfe611e1f25f89.tar.gz
mandoc-b47e561cf549df2f08947057fecfe611e1f25f89.tar.zst
mandoc-b47e561cf549df2f08947057fecfe611e1f25f89.zip
Re-ordered ascii.in looking for dupes.
Added `vim -q' tip to manuals.7 (thanks uqs@sporlein.net). ifdef'd production of missing specials/predefines.
Diffstat (limited to 'manuals.7')
-rw-r--r--manuals.718
1 files changed, 14 insertions, 4 deletions
diff --git a/manuals.7 b/manuals.7
index fa0b5aff..5f7c06a2 100644
--- a/manuals.7
+++ b/manuals.7
@@ -1,4 +1,4 @@
-.\" $Id: manuals.7,v 1.17 2009/07/20 13:45:11 kristaps Exp $
+.\" $Id: manuals.7,v 1.18 2009/07/27 13:10:08 kristaps Exp $
.\"
.\" Copyright (c) 2009 Kristaps Dzonsons <kristaps@kth.se>
.\"
@@ -14,7 +14,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: July 20 2009 $
+.Dd $Mdocdate: July 27 2009 $
.Dt MANUALS 7
.Os
.\" SECTION
@@ -106,7 +106,17 @@ for this document. Rename the template file:
.Ss Development Tools
While writing, make sure that your manual is correctly structured:
.Pp
-.Dl % mandoc \-Tlint \-Wall name.1
+.Dl % mandoc \-Tlint \-Wall \-fstrict name.1
+.Pp
+The quick-fix feature of
+.Xr vim 1
+is useful for checking over many manuals:
+.Bd -literal -offset indent
+% mandoc \-Wall \-fstrict \-Tlint \-fign-errors \e
+ `find /usr/src \-name \e*\e.[1-9]` 2>&1 | \e
+ sed 's!^mandoc: !!' > /tmp/mandoc.errs
+% vim -q /tmp/mandoc.errs
+.Ed
.Pp
You may spell-check your work as follows:
.Pp
@@ -125,7 +135,7 @@ or
to version-control your work. If you wish the last check-in to effect
your document's date, use the following RCS tag for the date macro:
.Pp
-.Dl \&.Dd $Mdocdate: July 20 2009 $
+.Dl \&.Dd $Mdocdate: July 27 2009 $
.\" SUBSECTION
.Ss Viewing
mdoc documents may be paged to your terminal with