X-Git-Url: https://git.cameronkatri.com/mandoc.git/blobdiff_plain/98ab5e407b0421f31fd38030d72fcf59c98a2f05..d5be9ce161a224472554ef4e69c35d03cb6e0e2d:/mdoc.7?ds=sidebyside diff --git a/mdoc.7 b/mdoc.7 index f712d450..5bd8aa10 100644 --- a/mdoc.7 +++ b/mdoc.7 @@ -1,4 +1,4 @@ -.\" $Id: mdoc.7,v 1.186 2011/04/17 11:57:07 schwarze Exp $ +.\" $Id: mdoc.7,v 1.188 2011/05/26 09:26:16 kristaps Exp $ .\" .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons .\" Copyright (c) 2010 Ingo Schwarze @@ -15,7 +15,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: April 17 2011 $ +.Dd $Mdocdate: May 26 2011 $ .Dt MDOC 7 .Os .Sh NAME @@ -97,8 +97,6 @@ Within a macro line, the following terms are reserved: .Pq reserved-word vertical bar .El .Pp -Use of reserved terms is described in -.Sx MACRO SYNTAX . For general use in macro lines, these can be escaped with a non-breaking space .Pq Sq \e& . @@ -298,19 +296,20 @@ sections, although this varies between manual sections. .Pp The following is a well-formed skeleton .Nm -file: +file for a utility +.Qq progname : .Bd -literal -offset indent \&.Dd $\&Mdocdate$ -\&.Dt mdoc 7 +\&.Dt PROGNAME section \&.Os \&.Sh NAME -\&.Nm foo +\&.Nm progname \&.Nd a description goes here \&.\e\*q .Sh LIBRARY \&.\e\*q For sections 2, 3, & 9 only. \&.\e\*q Not used in OpenBSD. \&.Sh SYNOPSIS -\&.Nm foo +\&.Nm progname \&.Op Fl options \&.Ar \&.Sh DESCRIPTION