=================================================================== RCS file: /cvs/mandoc/Attic/manuals.7,v retrieving revision 1.17 retrieving revision 1.18 diff -u -p -r1.17 -r1.18 --- mandoc/Attic/manuals.7 2009/07/20 13:45:11 1.17 +++ mandoc/Attic/manuals.7 2009/07/27 13:10:08 1.18 @@ -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 .\" @@ -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,8 +106,18 @@ 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 .Dl % deroff name.1 | spell @@ -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