summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@cvs.openbsd.org>2010-07-15 20:04:36 +0000
committerIngo Schwarze <schwarze@cvs.openbsd.org>2010-07-15 20:04:36 +0000
commitba114b670e004b0cf3d3c8ba6c6b8a7067cc685f (patch)
treed9257d6f450a4d5234ab30d8b83cd72d7e39fc75
parent18d35aed3de76de0dd8e4704caada1978642070f (diff)
When the first argument or arguments of a macro are opening delimiters
(parentheses and/or square brackets), both modern groff and mandoc first output those leading delimiters as plain text, then start the macro scope after these opening delimiters. This is similar to printing trailing punctuation and trailing closing delimiters on a macro line outside and after the macro scope. For example, ".Sq ( text )" is "(`text')", not "`(text)'". Thus, we now need to quote leading opening delimiters when we want them inside the macro scope. These are the cases in src/bin. "makes sense" jmc@
-rw-r--r--bin/csh/csh.118
-rw-r--r--bin/ksh/ksh.114
-rw-r--r--bin/ksh/sh.112
3 files changed, 22 insertions, 22 deletions
diff --git a/bin/csh/csh.1 b/bin/csh/csh.1
index 079470dc668..28495a509c1 100644
--- a/bin/csh/csh.1
+++ b/bin/csh/csh.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: csh.1,v 1.63 2010/01/10 10:53:33 jmc Exp $
+.\" $OpenBSD: csh.1,v 1.64 2010/07/15 20:04:35 schwarze Exp $
.\" $NetBSD: csh.1,v 1.10 1995/03/21 09:02:35 cgd Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
@@ -30,7 +30,7 @@
.\"
.\" @(#)csh.1 8.2 (Berkeley) 1/21/94
.\"
-.Dd $Mdocdate: January 10 2010 $
+.Dd $Mdocdate: July 15 2010 $
.Dt CSH 1
.Os
.Sh NAME
@@ -214,7 +214,7 @@ The characters
.Ql \&; ,
.Ql < ,
.Ql > ,
-.Ql ( ,
+.Ql \&( ,
and
.Ql \&)
form separate words.
@@ -277,7 +277,7 @@ waiting for it to terminate by following it with a
.Ql & .
.Pp
Any of the above may be placed in
-.Ql (
+.Ql \&(
.Ql \&)
to form a simple command (that
may be a component of a pipeline, for example).
@@ -576,7 +576,7 @@ character is passed unchanged when it is followed by a blank,
tab, newline,
.Ql =
or
-.Ql ( .
+.Ql \&( .
(History substitutions also occur when an input line begins with
.Ql ^ .
This special abbreviation will be described later.)
@@ -1105,7 +1105,7 @@ only part of a word, even if the command outputs a complete line.
If a word contains any of the characters
.Ql * ,
.Ql \&? ,
-.Ql [ ,
+.Ql \&[ ,
or
.Ql { ,
or begins with the character
@@ -1122,7 +1122,7 @@ Only the metacharacters
.Ql * ,
.Ql \&? ,
and
-.Ql [
+.Ql \&[
imply pattern matching,
the characters
.Ql ~
@@ -1431,7 +1431,7 @@ are syntactically significant to the parser
.Ql | ,
.Ql < ,
.Ql > ,
-.Ql ( ,
+.Ql \&( ,
and
.Ql \&)
.Pc ,
@@ -2323,7 +2323,7 @@ or
.Ql |
then at least
this part of the expression must be placed within
-.Ql (
+.Ql \&(
.Ql \&) .
The third form assigns the value of
.Ar expr
diff --git a/bin/ksh/ksh.1 b/bin/ksh/ksh.1
index 0df0b61b94d..3b852493779 100644
--- a/bin/ksh/ksh.1
+++ b/bin/ksh/ksh.1
@@ -1,8 +1,8 @@
-.\" $OpenBSD: ksh.1,v 1.135 2010/07/12 16:26:45 jmc Exp $
+.\" $OpenBSD: ksh.1,v 1.136 2010/07/15 20:04:35 schwarze Exp $
.\"
.\" Public Domain
.\"
-.Dd $Mdocdate: July 12 2010 $
+.Dd $Mdocdate: July 15 2010 $
.Dt KSH 1
.Os
.Sh NAME
@@ -211,7 +211,7 @@ characters (space, tab, and newline) or meta-characters
.Ql \*(Gt ,
.Ql \*(Ba ,
.Ql \&; ,
-.Ql ( ,
+.Ql \&( ,
.Ql \&) ,
and
.Ql &
@@ -274,7 +274,7 @@ shell and must be quoted if they are to represent themselves:
.Ql * ,
.Ql \&? ,
and
-.Ql [ .
+.Ql \&[ .
The first three of these are the above mentioned quoting characters (see
.Sx Quoting
below);
@@ -307,7 +307,7 @@ and finally,
.Ql * ,
.Ql \&? ,
and
-.Ql [
+.Ql \&[
are used in file name generation (see
.Sx File name patterns
below).
@@ -496,7 +496,7 @@ and
.Ql }
are reserved words, not meta-characters.
.It Xo case Ar word No in
-.Oo Op (
+.Oo Op \&(
.Ar \ pattern
.Op \*(Ba Ar pattern
.No ... No )
@@ -5157,7 +5157,7 @@ or follows one of the characters
.Ql \&; ,
.Ql | ,
.Ql & ,
-.Ql ( ,
+.Ql \&( ,
or
.Ql \&) ,
and does not contain a slash
diff --git a/bin/ksh/sh.1 b/bin/ksh/sh.1
index c14bad901e8..8632519361d 100644
--- a/bin/ksh/sh.1
+++ b/bin/ksh/sh.1
@@ -1,8 +1,8 @@
-.\" $OpenBSD: sh.1,v 1.86 2010/07/12 16:26:45 jmc Exp $
+.\" $OpenBSD: sh.1,v 1.87 2010/07/15 20:04:35 schwarze Exp $
.\"
.\" Public Domain
.\"
-.Dd $Mdocdate: July 12 2010 $
+.Dd $Mdocdate: July 15 2010 $
.Dt SH 1
.Os
.Sh NAME
@@ -182,7 +182,7 @@ characters (space, tab, and newline) or meta-characters
.Ql \*(Gt ,
.Ql \*(Ba ,
.Ql \&; ,
-.Ql ( ,
+.Ql \&( ,
.Ql \&) ,
and
.Ql &
@@ -239,7 +239,7 @@ shell and must be quoted if they are to represent themselves:
.Ql * ,
.Ql \&? ,
and
-.Ql [ .
+.Ql \&[ .
The first three of these are the above mentioned quoting characters (see
.Sx Quoting
below);
@@ -264,7 +264,7 @@ and finally,
.Ql * ,
.Ql \&? ,
and
-.Ql [
+.Ql \&[
are used in file name generation (see
.Sx File name patterns
below).
@@ -447,7 +447,7 @@ and
.Ql }
are reserved words, not meta-characters.
.It Xo case Ar word No in
-.Oo Op (
+.Oo Op \&(
.Ar \ pattern
.Op \*(Ba Ar pattern
.No ... No )