Module Name: src
Committed By: uwe
Date: Tue Mar 13 20:48:00 UTC 2018
Modified Files:
src/bin/sh: sh.1
Log Message:
Fix horrendous markup abuse in the here-document example.
Consistently spell "here-document" in full.
To generate a diff of this commit:
cvs rdiff -u -r1.183 -r1.184 src/bin/sh/sh.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/bin/sh/sh.1
diff -u src/bin/sh/sh.1:1.183 src/bin/sh/sh.1:1.184
--- src/bin/sh/sh.1:1.183 Tue Mar 13 20:40:52 2018
+++ src/bin/sh/sh.1 Tue Mar 13 20:48:00 2018
@@ -1,4 +1,4 @@
-.\" $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.
.\"
@@ -900,20 +900,19 @@ for reading and writing on standard inpu
.Pp
The following redirection is often called a
.Dq here-document .
-.Bl -item -offset indent
-.It
-.Li [n]<< delimiter
-.Dl here-doc-text ...
-.Li delimiter
-.El
+.Bd -literal -offset indent
+[n]<< delimiter
+\&... here-doc-text ...
+delimiter
+.Ed
.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
@@ -940,7 +939,8 @@ then leading tabs in all lines in the he
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
