9718 update mandoc to 1.14.4

*** 1,9 ****
! .\"     $Id: mdoc.7,v 1.269 2017/07/20 16:24:53 schwarze Exp $
  .\"
  .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
! .\" Copyright (c) 2010, 2011, 2013-2017 Ingo Schwarze <schwarze@openbsd.org>
  .\"
  .\" Permission to use, copy, modify, and distribute this software for any
  .\" purpose with or without fee is hereby granted, provided that the above
  .\" copyright notice and this permission notice appear in all copies.
  .\"
--- 1,9 ----
! .\"     $Id: mdoc.7,v 1.271 2018/07/28 18:34:15 schwarze Exp $
  .\"
  .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
! .\" Copyright (c) 2010, 2011, 2013-2018 Ingo Schwarze <schwarze@openbsd.org>
  .\"
  .\" Permission to use, copy, modify, and distribute this software for any
  .\" purpose with or without fee is hereby granted, provided that the above
  .\" copyright notice and this permission notice appear in all copies.
  .\"
*** 15,27 ****
  .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  .\"
  .\"
  .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
! .\" Copyright 2015 Nexenta Systems, Inc.  All rights reserved.
  .\"
! .Dd $Mdocdate: July 20 2017 $
  .Dt MDOC 5
  .Os
  .Sh NAME
  .Nm mdoc
  .Nd semantic markup language for formatting manual pages
--- 15,27 ----
  .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  .\"
  .\"
  .\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
! .\" Copyright 2018 Nexenta Systems, Inc.
  .\"
! .Dd $Mdocdate: July 28 2018 $
  .Dt MDOC 5
  .Os
  .Sh NAME
  .Nm mdoc
  .Nd semantic markup language for formatting manual pages
*** 797,834 ****
  .Dl \&.An -nosplit
  .Dl \&.An Kristaps Dzonsons \&Aq \&Mt kristaps@bsd.lv
  .Ss \&Ao
  Begin a block enclosed by angle brackets.
  Does not have any head arguments.
! .Pp
! Examples:
! .Dl \&.Fl -key= \&Ns \&Ao \&Ar val \&Ac
! .Pp
! See also
! .Sx \&Aq .
  .Ss \&Ap
  Inserts an apostrophe without any surrounding whitespace.
  This is generally used as a grammatical device when referring to the verb
  form of a function.
  .Pp
  Examples:
  .Dl \&.Fn execve \&Ap d
  .Ss \&Aq
  Encloses its arguments in angle brackets.
  .Pp
! Examples:
! .Dl \&.Fl -key= \&Ns \&Aq \&Ar val
  .Pp
! .Em Remarks :
! this macro is often abused for rendering URIs, which should instead use
  .Sx \&Lk
  or
! .Sx \&Mt ,
! or to note pre-processor
! .Dq Li #include
! statements, which should use
! .Sx \&In .
  .Pp
  See also
  .Sx \&Ao .
  .Ss \&Ar
  Command arguments.
--- 797,858 ----
  .Dl \&.An -nosplit
  .Dl \&.An Kristaps Dzonsons \&Aq \&Mt kristaps@bsd.lv
  .Ss \&Ao
  Begin a block enclosed by angle brackets.
  Does not have any head arguments.
! This macro is almost never useful.
! See
! .Sx \&Aq
! for more details.
  .Ss \&Ap
  Inserts an apostrophe without any surrounding whitespace.
  This is generally used as a grammatical device when referring to the verb
  form of a function.
  .Pp
  Examples:
  .Dl \&.Fn execve \&Ap d
  .Ss \&Aq
  Encloses its arguments in angle brackets.
+ The only important use case is for email addresses.
+ See
+ .Sx \&Mt
+ for an example.
  .Pp
! Occasionally, it is used for names of characters and keys, for example:
! .Bd -literal -offset indent
! Press the
! \&.Aq escape
! key to ...
! .Ed
  .Pp
! For URIs, use
  .Sx \&Lk
+ instead, and
+ .Sx \&In
+ for
+ .Dq #include
+ directives.
+ Never wrap
+ .Sx \&Ar
+ in
+ .Sx \&Aq .
+ .Pp
+ Since
+ .Sx \&Aq
+ usually renders with non-ASCII characters in non-ASCII output modes,
+ do not use it where the ASCII characters
+ .Sq <
+ and
+ .Sq >
+ are required as syntax elements.
+ Instead, use these characters directly in such cases, combining them
+ with the macros
+ .Sx \&Pf ,
+ .Sx \&Ns ,
  or
! .Sx \&Eo
! as needed.
  .Pp
  See also
  .Sx \&Ao .
  .Ss \&Ar
  Command arguments.
*** 1333,1343 ****
  .Pp
  The
  .Ar month
  is the full English month name, the
  .Ar day
! is an optionally zero-padded numeral, and the
  .Ar year
  is the full four-digit year.
  .Pp
  Other arguments are not portable; the
  .Xr mandoc 1
--- 1357,1367 ----
  .Pp
  The
  .Ar month
  is the full English month name, the
  .Ar day
! is an integer number, and the
  .Ar year
  is the full four-digit year.
  .Pp
  Other arguments are not portable; the
  .Xr mandoc 1
*** 1363,1374 ****
  If no date string is given, the current date is used.
  .El
  .Pp
  Examples:
  .Dl \&.Dd $\&Mdocdate$
! .Dl \&.Dd $\&Mdocdate: July 21 2007$
! .Dl \&.Dd July 21, 2007
  .Pp
  See also
  .Sx \&Dt
  and
  .Sx \&Os .
--- 1387,1398 ----
  If no date string is given, the current date is used.
  .El
  .Pp
  Examples:
  .Dl \&.Dd $\&Mdocdate$
! .Dl \&.Dd $\&Mdocdate: July 2 2018$
! .Dl \&.Dd July 2, 2018
  .Pp
  See also
  .Sx \&Dt
  and
  .Sx \&Os .