In manpages, don't escape apostrophes as \'; it's rarely what you want.

Most of these are correct just as '. A few benefit from Ql or \(aq.
But if in doubt, just use '.

1 files changed, 29 insertions, 23 deletions

diff --git a/bin/csh/csh.1 b/bin/csh/csh.1
index 79df89a7ba2..e1af22e543c 100644
--- a/bin/csh/csh.1
+++ b/bin/csh/csh.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: csh.1,v 1.80 2018/11/10 19:40:43 daniel Exp $
+.\"	$OpenBSD: csh.1,v 1.81 2019/06/02 06:53:11 bentley 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: November 10 2018 $
+.Dd $Mdocdate: June 2 2019 $
 .Dt CSH 1
 .Os
 .Sh NAME
@@ -231,15 +231,15 @@ A newline preceded by a
 is equivalent to a blank.
 .Pp
 Strings enclosed in matched pairs of quotations,
-.Ql ' ,
-.Ql ` ,
+.Ql \(aq ,
+.Ql \` ,
 or
 .Ql \&" ,
 form parts of a word; metacharacters in these strings, including blanks
 and tabs, do not form separate words.
 These quotations have semantics to be described later.
 Within pairs of
-.Ql '
+.Ql \(aq
 or
 .Ql \&"
 characters, a newline preceded by a
@@ -255,8 +255,8 @@ input line.
 This special meaning is prevented when preceded by
 .Ql \e
 and in quotations using
-.Ql ` ,
-.Ql ' ,
+.Ql \` ,
+.Ql \(aq ,
 and
 .Ql \&" .
 .Ss Commands
@@ -807,15 +807,15 @@ while
 .Ic !la
 would look for a command starting with
 .Dq la .
-.Ss Quotations with \' and \&"
+.Ss Quotations with \(aq and \&"
 The quotation of strings by
-.Ql '
+.Ql \(aq
 and
 .Ql \&"
 can be used
 to prevent all or some of the remaining substitutions.
 Strings enclosed in
-.Ql '
+.Ql \(aq
 are prevented from any further interpretation.
 Strings enclosed in
 .Ql \&"
@@ -827,7 +827,7 @@ only in one special case (see
 below) does a
 .Ql \&"
 quoted string yield parts of more than one word;
-.Ql '
+.Ql \(aq
 quoted strings never do.
 .Ss Alias substitution
 The shell maintains a list of aliases that can be established, displayed
@@ -920,13 +920,17 @@ This expansion can be prevented by preceding the
 with a
 .Ql \e
 except
-within double quotes (`"'), where it
+within double quotes
+.Pq Ql \&" ,
+where it
 .Em always
-occurs, and within single quotes (`''), where it
+occurs, and within single quotes
+.Pq Ql \(aq ,
+where it
 .Em never
 occurs.
 Strings quoted by backticks
-.Pq ` `
+.Pq \` \`
 are interpreted later (see
 .Sx Command substitution
 below), so
@@ -1089,11 +1093,13 @@ after input-output redirection is performed, and in a child
 of the main shell.
 .Ss Command substitution
 Command substitution is shown by a command enclosed in
-.Ql ` .
+.Ql \` .
 The output from such a command is normally broken into separate words
 at blanks, tabs, and newlines, with null words being discarded;
 this text then replaces the original string.
-Within double quotes (`"'), only newlines force new words;
+Within double quotes
+.Pq Ql \&" ,
+only newlines force new words;
 blanks and tabs are preserved.
 .Pp
 In any case, the single final newline does not force a new word.
@@ -1254,9 +1260,9 @@ before any substitutions are done on the input line.
 Unless a quoting
 .Ql \e ,
 .Ql \&" ,
-.Ql '
+.Ql \(aq
 or
-.Ql `
+.Ql \`
 appears in
 .Ar word ,
 variable and command substitution is performed on the intervening lines,
@@ -1266,7 +1272,7 @@ to quote
 .Ql $ ,
 .Ql \e
 and
-.Ql ` .
+.Ql \` .
 Commands that are substituted have all blanks, tabs, and newlines
 preserved, except for the final newline which is dropped.
 The resultant text is placed in an anonymous temporary file that
@@ -1697,7 +1703,7 @@ Execution continues after the specified line.
 .It Ic hashstat
 Print a statistics line showing how effective the internal hash
 table has been at locating commands (and avoiding
-.Ic exec Ns \'s ) .
+.Ic exec Ns 's ) .
 An
 .Ic exec
 is attempted for each component of the
@@ -1953,7 +1959,7 @@ ignored.
 All processes detached with
 .Ql &
 are effectively
-.Ic nohup Ns \'ed .
+.Ic nohup Ns 'ed .
 .Pp
 .It Ic notify
 .It Ic notify % Ns Ar job ...
@@ -1997,7 +2003,7 @@ Pops the directory stack, returning to the new top directory.
 With an argument
 .Dq + Ns Ar n
 discards the
-.Ar n Ns \'th
+.Ar n Ns 'th
 entry in the stack.
 The members of the directory stack are numbered from the top starting at 0.
 .Pp
@@ -2020,7 +2026,7 @@ onto the directory stack.
 With a numeric argument,
 .Ic pushd
 rotates the
-.Ar n Ns \'th
+.Ar n Ns 'th
 argument of the directory
 stack around to be the top element and changes to it.
 The members