]> git.cameronkatri.com Git - mandoc.git/blobdiff - manuals.7
Fixed up some documentation in man.7: only documenting man.7 macros, not related...
[mandoc.git] / manuals.7
index fa0b5aff92eef36972a0e823a6cd60e3b23c4bb2..47b0b78d439d47c484870102a1aa0b244df4746f 100644 (file)
--- 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.19 2009/07/27 19:43:02 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,16 @@ 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
+  ./path/to/manuals/* 2>&1 > /tmp/mandoc.errs
+% vim -q /tmp/mandoc.errs
+.Ed
 .Pp
 You may spell-check your work as follows:
 .Pp
@@ -125,7 +134,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