The .Nd macro is intended to provide "a one line description", so avoid

multiple lines of input, in particular, don't use macros below .Nd;
such bad style can confuse various apropos(1) tools.  All deleted
macros reappear later in the text, anyway, except for .Tn, which i'm
deleting outright.
Found while scanning the tree for good and bad practices in preparation
for my EuroBSD2015 mdoc(7) tutorial on Oct 1 in Stockholm.

5 files changed, 18 insertions, 28 deletions

diff --git a/usr.bin/at/atq.1 b/usr.bin/at/atq.1
index 9118f43f4e6..23214da370d 100644
--- a/usr.bin/at/atq.1
+++ b/usr.bin/at/atq.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: atq.1,v 1.6 2011/03/20 22:12:59 millert Exp $
+.\"	$OpenBSD: atq.1,v 1.7 2015/09/09 21:23:30 schwarze Exp $
 .\"
 .\" Copyright (c) 1985, 1990, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,14 +29,12 @@
 .\"
 .\"     @(#)atq.1	8.1 (Berkeley) 6/6/93
 .\"
-.Dd $Mdocdate: March 20 2011 $
+.Dd $Mdocdate: September 9 2015 $
 .Dt ATQ 1
 .Os
 .Sh NAME
 .Nm atq
-.Nd display the
-.Xr at 1
-job queue
+.Nd display the at(1) job queue
 .Sh SYNOPSIS
 .Nm atq
 .Op Fl cnv
diff --git a/usr.bin/at/atrm.1 b/usr.bin/at/atrm.1
index 7ba1abf4be3..c4389bfd4f1 100644
--- a/usr.bin/at/atrm.1
+++ b/usr.bin/at/atrm.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: atrm.1,v 1.7 2007/05/31 19:20:07 jmc Exp $
+.\"	$OpenBSD: atrm.1,v 1.8 2015/09/09 21:23:30 schwarze Exp $
 .\"
 .\" Copyright (c) 1985, 1990, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,13 +29,12 @@
 .\"
 .\"     @(#)atrm.1	8.1 (Berkeley) 6/6/93
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: September 9 2015 $
 .Dt ATRM 1
 .Os
 .Sh NAME
 .Nm atrm
-.Nd remove jobs spooled by
-.Xr at 1
+.Nd remove jobs spooled by at(1)
 .Sh SYNOPSIS
 .Nm atrm
 .Op Fl afi
diff --git a/usr.bin/ipcrm/ipcrm.1 b/usr.bin/ipcrm/ipcrm.1
index 4f9389f1e83..ff0fcee6255 100644
--- a/usr.bin/ipcrm/ipcrm.1
+++ b/usr.bin/ipcrm/ipcrm.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ipcrm.1,v 1.16 2014/03/22 08:02:03 jmc Exp $
+.\" $OpenBSD: ipcrm.1,v 1.17 2015/09/09 21:23:31 schwarze Exp $
 .\"
 .\" Copyright (c) 1994 Adam Glass
 .\" All rights reserved.
@@ -24,12 +24,12 @@
 .\" SUCH DAMAGE.
 .\"
 .\""
-.Dd $Mdocdate: March 22 2014 $
+.Dd $Mdocdate: September 9 2015 $
 .Dt IPCRM 1
 .Os
 .Sh NAME
 .Nm ipcrm
-.Nd remove the specified message queues, semaphore sets, and shared
+.Nd remove the specified message queues, semaphore sets, and shared \
 memory segments
 .Sh SYNOPSIS
 .Nm ipcrm
diff --git a/usr.bin/sendbug/sendbug.1 b/usr.bin/sendbug/sendbug.1
index 569f91f4435..8f4a3ef4b71 100644
--- a/usr.bin/sendbug/sendbug.1
+++ b/usr.bin/sendbug/sendbug.1
@@ -1,15 +1,14 @@
-.\" $OpenBSD: sendbug.1,v 1.24 2014/03/23 22:58:18 bcallah Exp $
+.\" $OpenBSD: sendbug.1,v 1.25 2015/09/09 21:23:31 schwarze Exp $
 .\"
 .\" Written by Raymond Lai <ray@cyth.net>.
 .\" Public domain.
 .\"
-.Dd $Mdocdate: March 23 2014 $
+.Dd $Mdocdate: September 9 2015 $
 .Dt SENDBUG 1
 .Os
 .Sh NAME
 .Nm sendbug
-.Nd report a bug in
-.Ox
+.Nd report a bug in OpenBSD
 .Sh SYNOPSIS
 .Nm
 .Op Fl DEPV
diff --git a/usr.bin/yacc/yacc.1 b/usr.bin/yacc/yacc.1
index 58768d6daea..dfb8e6606b6 100644
--- a/usr.bin/yacc/yacc.1
+++ b/usr.bin/yacc/yacc.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: yacc.1,v 1.30 2014/06/04 06:55:50 jmc Exp $
+.\"	$OpenBSD: yacc.1,v 1.31 2015/09/09 21:23:31 schwarze Exp $
 .\"
 .\" Copyright (c) 1989, 1990 The Regents of the University of California.
 .\" All rights reserved.
@@ -32,14 +32,12 @@
 .\"
 .\"	from: @(#)yacc.1	5.7 (Berkeley) 7/30/91
 .\"
-.Dd $Mdocdate: June 4 2014 $
+.Dd $Mdocdate: September 9 2015 $
 .Dt YACC 1
 .Os
 .Sh NAME
 .Nm yacc
-.Nd an
-.Tn LALR(1)
-parser generator
+.Nd an LALR(1) parser generator
 .Sh SYNOPSIS
 .Nm yacc
 .Op Fl dlrtv
@@ -51,11 +49,8 @@ parser generator
 .Nm
 reads the grammar specification in
 .Ar file
-and generates an
-.Tn LR(1)
-parser for it.
-The parsers consist of a set of
-.Tn LALR(1)
+and generates an LR(1) parser for it.
+The parsers consist of a set of LALR(1)
 parsing tables and a driver routine
 written in the C programming language.
 .Nm
@@ -176,8 +171,7 @@ is defined and non-zero.
 .Sh DIAGNOSTICS
 If there are rules that are never reduced, the number of such rules is
 written to the standard error.
-If there are any
-.Tn LALR(1)
+If there are any LALR(1)
 conflicts, the number of conflicts is also written
 to the standard error.
 .Sh SEE ALSO