 @@ -1,14 +1,14 @@
-.\"	$NetBSD: sh.1,v 1.183 2018/03/13 20:40:52 uwe Exp $
+.\"	$NetBSD: sh.1,v 1.184 2018/03/13 20:48:00 uwe Exp $
 .\" Copyright (c) 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
 .\"
 .\" This code is derived from software contributed to Berkeley by
 .\" Kenneth Almquist.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 @@ -890,67 +890,67 @@ Duplicate standard output (or
 to
 .Ar n2 .
 .It Oo Ar n Oc Ns >&-
 Close standard output (or n).
 .It Oo Ar n Oc Ns <> Ar file
 Open
 .Ar file
 for reading and writing on standard input (or
 .Ar n ) .
 .El
 .Pp
 The following redirection is often called a
 .Dq here-document .
-.Bl -item -offset indent
+.Bd -literal -offset indent
-.It
+[n]<< delimiter
-.Li [n]<< delimiter
+\&... here-doc-text ...
-.Dl here-doc-text ...
+delimiter
-.Li delimiter
+.Ed
 .El
 .Pp
 The
 .Dq here-doc-text
 starts immediately after the next unquoted newline character following
-the here-doc redirection operator.
+the here-document redirection operator.
 If there is more than one here-document redirection on the same
 line, then the text for the first (from left to right) is read
-first, and subsequent here-doc-text for later here-doc redirections
+first, and subsequent here-doc-text for later here-document redirections
 follows immediately after, until all such redirections have been
 processed.
 .Pp
 All the text on successive lines up to the delimiter,
 which must appear on a line by itself, with nothing other
 than an immediately following newline, is
 saved away and made available to the command on standard input, or file
 descriptor n if it is specified.
 If the delimiter as specified on the initial line is
 quoted, then the here-doc-text is treated literally; otherwise, the text is
 treated much like a double quoted string, except that
 .Sq \&"
 characters have no special meaning, and are not escaped by
 .Sq \&\e ,
 and is subjected to parameter expansion, command substitution, and arithmetic
 expansion as described in the
 .Sx Word Expansions
 section below.
 If the operator is
 .Dq <<\(mi
 instead of
 .Dq << ,
 then leading tabs in all lines in the here-doc-text, including before the
 end delimiter, are stripped.
 If the delimiter is not quoted, lines in here-doc-text that end with
 an unquoted \e are joined to the following line, the \e and following
-newline are simply removed while reading the here-doc, which thus guarantees
+newline are simply removed while reading the here-document,
 which thus guarantees
 that neither of those lines can be the end delimiter.
 .Pp
 It is a syntax error for the end of the input file (or string) to be
 reached before the delimiter is encountered.
 .Ss Search and Execution
 There are three types of commands: shell functions, built-in commands, and
 normal programs \(em and the command is searched for (by name) in that order.
 A command that contains a slash
 .Sq \&/
 in its name is always a normal program.
 They each are executed in a different way.
 .Pp
 When a shell function is executed, all of the shell positional parameters