feedback from Hans

*** 14,24 ****
  .\"
  .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
  .\" Copyright 2012 Nexenta Systems, Inc. All rights reserved.
  .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
  .\"
! .Dd Jul 13, 2014
  .Dt MANDOC 1
  .Os
  .Sh NAME
  .Nm mandoc
  .Nd format and display UNIX manuals
--- 14,24 ----
  .\"
  .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
  .\" Copyright 2012 Nexenta Systems, Inc. All rights reserved.
  .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
  .\"
! .Dd Jul 16, 2014
  .Dt MANDOC 1
  .Os
  .Sh NAME
  .Nm mandoc
  .Nd format and display UNIX manuals
*** 457,481 ****
  .Fl W Ns Cm warning .
  .Sh EXAMPLES
  To page manuals to the terminal:
  .Pp
  .Dl $ mandoc \-Wall,stop mandoc.1 2\*(Gt&1 | less
! .Dl $ mandoc mandoc.1 mdoc.3 mdoc.7 | less
  .Pp
  To produce HTML manuals with
  .Ar style.css
  as the style-sheet:
  .Pp
! .Dl $ mandoc \-Thtml -Ostyle=style.css mdoc.7 \*(Gt mdoc.7.html
  .Pp
  To check over a large set of manuals:
  .Pp
  .Dl $ mandoc \-Tlint `find /usr/src -name \e*\e.[1-9]`
  .Pp
  To produce a series of PostScript manuals for A4 paper:
  .Pp
! .Dl $ mandoc \-Tps \-Opaper=a4 mdoc.7 man.7 \*(Gt manuals.ps
  .Pp
  Convert a modern
  .Xr mdoc 5
  manual to the older
  .Xr man 5
--- 457,481 ----
  .Fl W Ns Cm warning .
  .Sh EXAMPLES
  To page manuals to the terminal:
  .Pp
  .Dl $ mandoc \-Wall,stop mandoc.1 2\*(Gt&1 | less
! .Dl $ mandoc mandoc.1 mdoc.5 | less
  .Pp
  To produce HTML manuals with
  .Ar style.css
  as the style-sheet:
  .Pp
! .Dl $ mandoc \-Thtml -Ostyle=style.css mdoc.5 \*(Gt mdoc.5.html
  .Pp
  To check over a large set of manuals:
  .Pp
  .Dl $ mandoc \-Tlint `find /usr/src -name \e*\e.[1-9]`
  .Pp
  To produce a series of PostScript manuals for A4 paper:
  .Pp
! .Dl $ mandoc \-Tps \-Opaper=a4 mdoc.5 man.5 \*(Gt manuals.ps
  .Pp
  Convert a modern
  .Xr mdoc 5
  manual to the older
  .Xr man 5
*** 629,640 ****
  lists render similarly.
  .El
  .Sh INTERFACE STABILITY
  The
  .Nm 
! utility is Committed, but the details of specific output formats other than
! ASCII are Uncommitted.
  .Sh SEE ALSO
  .Xr eqn 5 ,
  .Xr man 5 ,
  .Xr mandoc_char 5 ,
  .Xr mdoc 5 ,
--- 629,642 ----
  lists render similarly.
  .El
  .Sh INTERFACE STABILITY
  The
  .Nm 
! utility is
! .Nm Committed ,
! but the details of specific output formats other than ASCII are
! .Nm Uncommitted .
  .Sh SEE ALSO
  .Xr eqn 5 ,
  .Xr man 5 ,
  .Xr mandoc_char 5 ,
  .Xr mdoc 5 ,