[PATCH 17/18] doc/bash.1: migrate to strings for troublesome characters

[G. Branden Robinson]

Diff of rendering (DWB):

-                 sonal initialization file /.bashrc if the shell is
+                 sonal initialization file ~/.bashrc if the shell is

-                 files /.bash_profile, /.bash_login, or /.profile.  By
-                 default, bash reads these files when it is invoked as a
+                 files ~/.bash_profile, ~/.bash_login, or ~/.profile.
+                 By default, bash reads these files when it is invoked

-                 An additional binary operator, =, is available, with
+                 An additional binary operator, =~, is available, with

-                 string.  Anchor the pattern using the  and $ regular
+                 string.  Anchor the pattern using the ^ and $ regular

[many more occurrences]

Unfortunately (on DWB only)...

-                 parameter expands to a separate word.  That is, "$@" is
-                 equivalent to "$1" "$2" ...  If the double-quoted
-                 expansion occurs within a word, the expansion of the
-                 first parameter is joined with the beginning part of
-                 the original word, and the expansion of the last param-
-                 eter is joined with the last part of the original word.
-                 When there are no positional parameters, "$@" and $@
+                 parameter expands to a separate word.  That is, $@ is
+                 equivalent to $1  "$2" ...  If the double-quoted expan-
+                 sion occurs within a word, the expansion of the first
+                 parameter is joined with the beginning part of the
+                 original word, and the expansion of the last parameter
+                 is joined with the last part of the original word.
+                 When there are no positional parameters, $@ and $@

-            exceptions   to   this   are  the  expansions  of  "$@"  and
-            "${name[@]}", and, in  most  cases,  $*  and  ${name[*]}  as
-            explained above (see PARAMETERS).
+            exceptions  to this are the expansions of $@ and ${name[@]},
+            and, in most cases, $* and  ${name[*]}  as  explained  above
+            (see PARAMETERS).

However, that is addressed by the next patch in this series.
---
 doc/bash.1 | 200 ++++++++++++++++++++++++++++-------------------------
 1 file changed, 107 insertions(+), 93 deletions(-)

diff --git a/doc/bash.1 b/doc/bash.1
index 61e9b758..2ee6c119 100644
--- a/doc/bash.1
+++ b/doc/bash.1
@@ -38,6 +38,20 @@
 .\" .el \\*(]X\h|\\n()Iu+\\n()Ru\c
 .\" .}f
 .\" ..
+.
+.ie \n(.g \{\
+.ds ' \(aq
+.ds " \(dq
+.ds ^ \(ha
+.ds ~ \(ti
+.\}
+.el \{\
+.ds ' '
+.ds " ""\" two adjacent quotes and no space before this comment
+.ds ^ ^
+.ds ~ ~
+.\}
+.
 .\"
 .\" File Name macro.  This used to be `.PN', for Path Name,
 .\" but Sun doesn't seem to like that very much.
@@ -213,7 +227,7 @@ .SH OPTIONS
 Execute commands from
 .I file
 instead of the standard personal initialization file
-.I \(ti/.bashrc
+.I \*~/.bashrc
 if the shell is interactive (see
 .SM
 .B INVOCATION
@@ -231,10 +245,10 @@ .SH OPTIONS
 Do not read either the system-wide startup file
 .FN /etc/profile
 or any of the personal initialization files
-.IR \(ti/.bash_profile ,
-.IR \(ti/.bash_login ,
+.IR \*~/.bash_profile ,
+.IR \*~/.bash_login ,
 or
-.IR \(ti/.profile .
+.IR \*~/.profile .
 By default,
 .B bash
 reads these files when it is invoked as a login shell (see
@@ -244,7 +258,7 @@ .SH OPTIONS
 .TP
 .B \-\-norc
 Do not read and execute the personal initialization file
-.I \(ti/.bashrc
+.I \*~/.bashrc
 if the shell is interactive.
 This option is on by default if the shell is invoked as
 .BR sh .
@@ -343,8 +357,8 @@ .SH INVOCATION
 with the \fB\-\-login\fP option, it first reads and
 executes commands from the file \fI/etc/profile\fP, if that
 file exists.
-After reading that file, it looks for \fI\(ti/.bash_profile\fP,
-\fI\(ti/.bash_login\fP, and \fI\(ti/.profile\fP, in that order, and reads
+After reading that file, it looks for \fI\*~/.bash_profile\fP,
+\fI\*~/.bash_login\fP, and \fI\*~/.profile\fP, in that order, and reads
 and executes commands from the first one that exists and is readable.
 The
 .B \-\-noprofile
@@ -353,18 +367,18 @@ .SH INVOCATION
 When an interactive login shell exits,
 or a non-interactive login shell executes the \fBexit\fP builtin command,
 .B bash
-reads and executes commands from the file \fI\(ti/.bash_logout\fP, if it
+reads and executes commands from the file \fI\*~/.bash_logout\fP, if it
 exists.
 .PP
 When an interactive shell that is not a login shell is started,
 .B bash
-reads and executes commands from \fI\(ti/.bashrc\fP, if that file exists.
+reads and executes commands from \fI\*~/.bashrc\fP, if that file exists.
 This may be inhibited by using the
 .B \-\-norc
 option.
 The \fB\-\-rcfile\fP \fIfile\fP option will force
 .B bash
-to read and execute commands from \fIfile\fP instead of \fI\(ti/.bashrc\fP.
+to read and execute commands from \fIfile\fP instead of \fI\*~/.bashrc\fP.
 .PP
 When
 .B bash
@@ -379,7 +393,7 @@ .SH INVOCATION
 .PP
 .RS
 .EX
-if [ \-n \(dq$BASH_ENV\(dq ]; then . \(dq$BASH_ENV\(dq; fi
+if [ \-n \*"$BASH_ENV\*" ]; then . \*"$BASH_ENV\*"; fi
 .EE
 .RE
 .PP
@@ -401,7 +415,7 @@ .SH INVOCATION
 read and execute commands from
 .I /etc/profile
 and
-.IR \(ti/.profile ,
+.IR \*~/.profile ,
 in that order.
 The
 .B \-\-noprofile
@@ -452,7 +466,7 @@ .SH INVOCATION
 If
 .B bash
 determines it is being run non-interactively in this fashion,
-it reads and executes commands from \fI\(ti/.bashrc\fP,
+it reads and executes commands from \fI\*~/.bashrc\fP,
 if that file exists and is readable.
 It will not do this if invoked as \fBsh\fP.
 The
@@ -772,7 +786,7 @@ .SS Compound Commands
 Any part of the pattern may be quoted to force the quoted portion
 to be matched as a string.
 .IP
-An additional binary operator, \fB=\(ti\fP, is available, with the same
+An additional binary operator, \fB=\*~\fP, is available, with the same
 precedence as \fB==\fP and \fB!=\fP.
 When it is used, the string to the right of the operator is considered
 a POSIX extended regular expression and matched accordingly
@@ -797,7 +811,7 @@ .SS Compound Commands
 between brackets.
 .IP
 The pattern will match if it matches any part of the string.
-Anchor the pattern using the \fB\(ha\fP and \fB$\fP regular expression
+Anchor the pattern using the \fB\*^\fP and \fB$\fP regular expression
 operators to force it to match the entire string.
 The array variable
 .SM
@@ -1160,7 +1174,7 @@ .SH QUOTING
 characters:
 .BR $ ,
 .BR \` ,
-\^\fB\(dq\fP\^,
+\^\fB\*"\fP\^,
 .BR \e ,
 or
 .BR <newline> .
@@ -1183,7 +1197,7 @@ .SH QUOTING
 .B PARAMETERS
 below).
 .PP
-Character sequences of the form \fB$\fP\(aq\fIstring\fP\(aq are treated
+Character sequences of the form \fB$\fP\*'\fIstring\fP\*' are treated
 as a special variant of single quotes.
 The sequence expands to \fIstring\fP, with backslash-escaped characters
 in \fIstring\fP replaced as specified by the ANSI C standard.
@@ -1220,10 +1234,10 @@ .SH QUOTING
 .B \e\e
 backslash
 .TP
-.B \e\(aq
+.B \e\*'
 single quote
 .TP
-.B \e\(dq
+.B \e\*"
 double quote
 .TP
 .B \e?
@@ -1253,7 +1267,7 @@ .SH QUOTING
 The expanded result is single-quoted, as if the dollar sign had
 not been present.
 .PP
-A double-quoted string preceded by a dollar sign (\fB$\fP\(dq\fIstring\fP\(dq)
+A double-quoted string preceded by a dollar sign (\fB$\fP\*"\fIstring\fP\*")
 will cause the string to be translated according to the current locale.
 The \fIgettext\fP infrastructure performs the lookup and
 translation, using the \fBLC_MESSAGES\fP, \fBTEXTDOMAINDIR\fP,
@@ -1462,16 +1476,16 @@ .SS Special Parameters
 When the expansion occurs within double quotes,
 each parameter expands to a separate word.
 That is,
-.B \(dq$@\(dq
+.B \*"$@\*"
 is equivalent to
-.B \(dq$1\(dq\ \(dq$2\(dq
+.B \*"$1\*"\ \*"$2\*"
 \&.\|.\|.
 If the double-quoted expansion occurs within a word, the expansion of
 the first parameter is joined with the beginning part of the original
 word, and the expansion of the last parameter is joined with the last
 part of the original word.
 When there are no positional parameters,
-.B \(dq$@\(dq
+.B \*"$@\*"
 and
 .B $@
 expand to nothing (i.e., they are removed).
@@ -1701,7 +1715,7 @@ .SS Shell Variables
 command.
 .TP
 .B BASH_REMATCH
-An array variable whose members are assigned by the \fB=\(ti\fP binary
+An array variable whose members are assigned by the \fB=\*~\fP binary
 operator to the \fB[[\fP conditional command.
 The element with index 0 is the portion of the string
 matching the entire regular expression.
@@ -2192,7 +2206,7 @@ .SS Shell Variables
 If this parameter is set when \fBbash\fP is executing a shell script,
 its value is interpreted as a filename containing commands to
 initialize the shell, as in
-.IR \(ti/.bashrc .
+.IR \*~/.bashrc .
 The value of
 .SM
 .B BASH_ENV
@@ -2232,7 +2246,7 @@ .SS Shell Variables
 .B cd
 command.
 A sample value is
-.Q .:\(ti:/usr .
+.Q .:\*~:/usr .
 .TP
 .B CHILD_MAX
 Set the number of exited child status values for the shell to remember.
@@ -2301,7 +2315,7 @@ .SS Shell Variables
 .B FIGNORE
 is excluded from the list of matched filenames.
 A sample value is
-.Q .o:\(ti .
+.Q .o:\*~ .
 .TP
 .B FUNCNEST
 If set to a numeric value greater than 0, defines a maximum function
@@ -2382,7 +2396,7 @@ .SS Shell Variables
 .SM
 .B HISTORY
 below).
-\fBBash\fP assigns a default value of \fI\(ti/.bash_history\fP.
+\fBBash\fP assigns a default value of \fI\*~/.bash_history\fP.
 If \fBHISTFILE\fP is unset or null,
 the command history is not saved when a shell exits.
 .TP
@@ -2502,7 +2516,7 @@ .SS Shell Variables
 The filename for the
 .B readline
 startup file, overriding the default of
-.FN \(ti/.inputrc
+.FN \*~/.inputrc
 (see
 .SM
 .B READLINE
@@ -2584,7 +2598,7 @@ .SS Shell Variables
 .RS
 .PP
 .EX
-\fBMAILPATH\fP=\(aq/var/mail/bfox?\(dqYou have 
mail\(dq:\(ti/shell\-mail?\(dq$_ has mail!\(dq\(aq
+\fBMAILPATH\fP=\*'/var/mail/bfox?\*"You have mail\*":\*~/shell\-mail?\*"$_ has 
mail!\*"\*'
 .EE
 .PP
 .B Bash
@@ -2748,7 +2762,7 @@ .SS Shell Variables
 included.
 .IP
 If this variable is not set, \fBbash\fP acts as if it had the
-value \fB$\(aq\enreal\et%3lR\enuser\et%3lU\ensys\et%3lS\(aq\fP.
+value \fB$\*'\enreal\et%3lR\enuser\et%3lU\ensys\et%3lS\*'\fP.
 If the value is null, \fBbash\fP does not display any timing information.
 A trailing newline is added when the format string is displayed.
 .PD 0
@@ -2816,7 +2830,7 @@ .SS Shell Variables
 command entered, substituting one string for another in the command,
 when it appears as the first character on the line.
 The default is
-.Q \fB\(ha\fP .
+.Q \fB\*^\fP .
 The optional third character is the character which indicates that the
 remainder of the line is a comment when found as the first character of
 a word,
@@ -3039,9 +3053,9 @@ .SH EXPANSION
 can increase the number of words of the expansion; other expansions
 expand a single word to a single word.
 The only exceptions to this are the expansions of
-.B \(dq$@\(dq
+.B \*"$@\*"
 and
-.BR \(dq${\fIname\fP[@]}\(dq ,
+.BR \*"${\fIname\fP[@]}\*" ,
 and, in most cases, \fB$*\fP and \fB${\fP\fIname\fP\fB[*]}\fP
 as explained above (see
 .SM
@@ -3148,7 +3162,7 @@ .SS Brace Expansion
 below).
 .SS Tilde Expansion
 If a word begins with an unquoted tilde character (\c
-.Q \fB\(ti\fP ),
+.Q \fB\*~\fP ),
 all of the characters preceding the first unquoted slash
 (or all characters,
 if there is no unquoted slash) are considered a \fItilde-prefix\fP.
@@ -3168,13 +3182,13 @@ .SS Tilde Expansion
 associated with the specified login name.
 .PP
 If the tilde-prefix is a
-.Q \(ti+ ,
+.Q \*~+ ,
 the value of the shell variable
 .SM
 .B PWD
 replaces the tilde-prefix.
 If the tilde-prefix is a
-.Q \(ti\- ,
+.Q \*~\- ,
 the value of the shell variable
 .SM
 .BR OLDPWD ,
@@ -3583,10 +3597,10 @@ .SS Parameter Expansion
 the substitution operation is applied to each member of the
 array in turn, and the expansion is the resultant list.
 .TP
-${\fIparameter\fP\fB\(ha\fP\fIpattern\fP}
+${\fIparameter\fP\fB\*^\fP\fIpattern\fP}
 .PD 0
 .TP
-${\fIparameter\fP\fB\(ha\(ha\fP\fIpattern\fP}
+${\fIparameter\fP\fB\*^\*^\fP\fIpattern\fP}
 .TP
 ${\fIparameter\fP\fB,\fP\fIpattern\fP}
 .TP
@@ -3599,11 +3613,11 @@ .SS Parameter Expansion
 Each character in the expanded value of \fIparameter\fP is tested against
 \fIpattern\fP, and, if it matches the pattern, its case is converted.
 The pattern should not attempt to match more than one character.
-The \fB\(ha\fP operator converts lowercase letters matching \fIpattern\fP
+The \fB\*^\fP operator converts lowercase letters matching \fIpattern\fP
 to uppercase; the \fB,\fP operator converts matching uppercase letters
 to lowercase.
-The \fB\(ha\(ha\fP and \fB,,\fP expansions convert each matched character in 
the
-expanded value; the \fB\(ha\fP and \fB,\fP expansions match and convert only
+The \fB\*^\*^\fP and \fB,,\fP expansions convert each matched character in the
+expanded value; the \fB\*^\fP and \fB,\fP expansions match and convert only
 the first character in the expanded value.
 If \fIpattern\fP is omitted, it is treated like a \fB?\fP, which matches
 every character.
@@ -3651,7 +3665,7 @@ .SS Parameter Expansion
 .TP
 .B E
 The expansion is a string that is the value of \fIparameter\fP with backslash
-escape sequences expanded as with the \fB$\(aq\fP.\|.\|.\%\fB\(aq\fP
+escape sequences expanded as with the \fB$\*'\fP.\|.\|.\%\fB\*'\fP
 quoting mechanism.
 .TP
 .B P
@@ -3903,7 +3917,7 @@ .SS Word Splitting
 of
 .BR <space><tab><newline> .
 .PP
-Explicit null arguments (\^\f3\(dq\^\(dq\fP or \^\f3\(aq\^\(aq\fP\^) are 
retained
+Explicit null arguments (\^\f3\*"\^\*"\fP or \^\f3\*'\^\*'\fP\^) are retained
 and passed to commands as empty strings.
 Unquoted implicit null arguments, resulting from the expansion of
 parameters that have no values, are removed.
@@ -3913,7 +3927,7 @@ .SS Word Splitting
 When a quoted null argument appears as part of a word whose expansion is
 non-null, the null argument is removed.
 That is, the word
-.Q "\-d\(aq\^\(aq"
+.Q "\-d\*'\^\*'"
 becomes
 .Q \-d
 after word splitting and null argument removal.
@@ -4097,7 +4111,7 @@ .SS Pathname Expansion
 is a
 .B !
 or a
-.B \(ha
+.B \*^
 then any character not enclosed is matched.
 The sorting order of characters in range expressions,
 and the characters included in the range,
@@ -4227,8 +4241,8 @@ .SS Quote Removal
 After the preceding expansions, all unquoted occurrences of the
 characters
 .BR \e ,
-.BR \(aq ,
-and \^\f3\(dq\fP\^ that did not result from one of the above
+.BR \*' ,
+and \^\f3\*"\fP\^ that did not result from one of the above
 expansions are removed.
 .SH REDIRECTION
 Before a command is executed, its input and output
@@ -4875,7 +4889,7 @@ .SH "ARITHMETIC EVALUATION"
 .B ++\fIid\fP \-\-\fIid\fP
 variable pre-increment and pre-decrement
 .TP
-.B ! \(ti
+.B ! \*~
 logical and bitwise negation
 .TP
 .B **
@@ -4899,7 +4913,7 @@ .SH "ARITHMETIC EVALUATION"
 .B &
 bitwise AND
 .TP
-.B \(ha
+.B \*^
 bitwise exclusive OR
 .TP
 .B |
@@ -4914,7 +4928,7 @@ .SH "ARITHMETIC EVALUATION"
 .B \fIexpr\fP?\fIexpr\fP:\fIexpr\fP
 conditional operator
 .TP
-.B "= *= /= %= += \-= <<= >>= &= \(ha= |="
+.B "= *= /= %= += \-= <<= >>= &= \*^= |="
 assignment
 .TP
 .B \fIexpr1\fP , \fIexpr2\fP
@@ -5527,10 +5541,10 @@ .SH SIGNALS
 such as
 .SM
 .B SIGINT
-(usually generated by \fB\(haC\fP) that users commonly intend to send
+(usually generated by \fB\*^C\fP) that users commonly intend to send
 to that command.
 This happens because the shell and the command are in the
-same process group as the terminal, and \fB\(haC\fP sends
+same process group as the terminal, and \fB\*^C\fP sends
 .SM
 .B SIGINT
 to all processes in that process group.
@@ -5643,14 +5657,14 @@ .SH "JOB CONTROL"
 Typing the
 .I suspend
 character (typically
-.BR \(haZ ,
+.BR \*^Z ,
 Control-Z) while a process is running
 causes that process to be stopped and returns control to
 .BR bash .
 Typing the
 .I "delayed suspend"
 character (typically
-.BR \(haY ,
+.BR \*^Y ,
 Control-Y) causes the process to be stopped when it
 attempts to read input from the terminal, and control to
 be returned to
@@ -5662,7 +5676,7 @@ .SH "JOB CONTROL"
 command to continue it in the foreground, or
 the
 .B kill
-command to kill it.  A \fB\(haZ\fP takes effect immediately,
+command to kill it.  A \fB\*^Z\fP takes effect immediately,
 and has the additional side effect of causing pending output
 and typeahead to be discarded.
 .PP
@@ -5982,7 +5996,7 @@ .SS "Readline Initialization"
 .SM
 .B INPUTRC
 variable.  If that variable is unset, the default is
-.IR \(ti/.inputrc .
+.IR \*~/.inputrc .
 If that file  does not exist or cannot be read, the ultimate default is
 .IR /etc/inputrc .
 When a program which uses the readline library starts up, the
@@ -6049,7 +6063,7 @@ .SS "Readline Key Bindings"
 .br
 Meta-Rubout: backward-kill-word
 .br
-Control-o: \(dq> output\(dq
+Control-o: \*"> output\*"
 .RE
 .LP
 In the above example,
@@ -6066,7 +6080,7 @@ .SS "Readline Key Bindings"
 .Q "> output"
 into the line).
 .PP
-In the second form, \fB\(dqkeyseq\(dq\fP:\^\fIfunction\-name\fP or \fImacro\fP,
+In the second form, \fB\*"keyseq\*"\fP:\^\fIfunction\-name\fP or \fImacro\fP,
 .B keyseq
 differs from
 .B keyname
@@ -6079,9 +6093,9 @@ .SS "Readline Key Bindings"
 .RS
 .EX
 .nf
-\(dq\eC\-u\(dq: universal\-argument
-\(dq\eC\-x\eC\-r\(dq: re\-read\-init\-file
-\(dq\ee[11\(ti\(dq: \(dqFunction Key 1\(dq
+\*"\eC\-u\*": universal\-argument
+\*"\eC\-x\eC\-r\*": re\-read\-init\-file
+\*"\ee[11\*~\*": \*"Function Key 1\*"
 .fi
 .EE
 .RE
@@ -6094,7 +6108,7 @@ .SS "Readline Key Bindings"
 is bound to the function
 .BR re\-read\-init\-file ,
 and
-.I "ESC [ 1 1 \(ti"
+.I "ESC [ 1 1 \*~"
 is bound to insert the text
 .Q "Function Key 1" .
 .PP
@@ -6114,11 +6128,11 @@ .SS "Readline Key Bindings"
 .B \e\e
 backslash
 .TP
-.B \e\(dq
-literal \(dq
+.B \e\*"
+literal \*"
 .TP
-.B \e\(aq
-literal \(aq
+.B \e\*'
+literal \*'
 .RE
 .PD
 .PP
@@ -6166,7 +6180,7 @@ .SS "Readline Key Bindings"
 Unquoted text is assumed to be a function name.
 In the macro body, the backslash escapes described above are expanded.
 Backslash will quote any other character in the macro text,
-including \(dq and \(aq.
+including \*" and \*'.
 .PP
 .B Bash
 allows the current readline key bindings to be displayed or modified
@@ -6653,7 +6667,7 @@ .SS "Readline Conditional Constructs"
 .nf
 \fB$if\fP Bash
 # Quote the current or previous word
-\(dq\eC\-xq\(dq: \(dq\eeb\e\(dq\eef\e\(dq\(dq
+\*"\eC\-xq\*": \*"\eeb\e\*"\eef\e\*"\*"
 \fB$endif\fP
 .fi
 .EE
@@ -6910,7 +6924,7 @@ .SS Commands for Manipulating the History
 .B shell\-expand\-line (M\-C\-e)
 Expand the line by performing shell word expansions.
 This performs alias and history expansion,
-\fB$\fP\(aq\fIstring\fP\(aq and \fB$\fP\(dq\fIstring\fP\(dq quoting,
+\fB$\fP\*'\fIstring\fP\*' and \fB$\fP\*"\fIstring\fP\*" quoting,
 tilde expansion, parameter and variable expansion, arithmetic expansion,
 word splitting, and quote removal.
 See
@@ -6918,7 +6932,7 @@ .SS Commands for Manipulating the History
 .B HISTORY EXPANSION
 below for a description of history expansion.
 .TP
-.B history\-expand\-line (M\-\(ha)
+.B history\-expand\-line (M\-\*^)
 Perform history expansion on the current line.
 See
 .SM
@@ -7127,7 +7141,7 @@ .SS Completing
 .B Bash
 attempts completion treating the text as a variable (if the
 text begins with \fB$\fP), username (if the text begins with
-\fB\(ti\fP), hostname (if the text begins with \fB@\fP), or
+\fB\*~\fP), hostname (if the text begins with \fB@\fP), or
 command (including aliases and functions) in turn.  If none
 of these produces a match, filename completion is attempted.
 .TP
@@ -7172,11 +7186,11 @@ .SS Completing
 List the possible completions of the text before point,
 treating it as a filename.
 .TP
-.B complete\-username (M\-\(ti)
+.B complete\-username (M\-\*~)
 Attempt completion on the text before point, treating
 it as a username.
 .TP
-.B possible\-username\-completions (C\-x \(ti)
+.B possible\-username\-completions (C\-x \*~)
 List the possible completions of the text before point,
 treating it as a username.
 .TP
@@ -7548,7 +7562,7 @@ .SS Programmable Completion
 .nf
 _completion_loader()
 {
-  . \(dq/etc/bash_completion.d/$1.sh\(dq \c
+  . \*"/etc/bash_completion.d/$1.sh\*" \c
 .if \n(LL<80n \{\
 \e
 .br
@@ -7599,7 +7613,7 @@ .SH HISTORY
 the variable
 .SM
 .B HISTFILE
-(default \fI\(ti/.bash_history\fP).
+(default \fI\*~/.bash_history\fP).
 The file named by the value of
 .SM
 .B HISTFILE
@@ -7849,13 +7863,13 @@ .SS Event Designators
 If \fIstring\fP is missing, the string from the most recent search is used;
 it is an error if there is no previous search string.
 .TP
-.B \d\s+2\(ha\s-2\u\fIstring1\fP\d\s+2\(ha\s-2\u\fIstring2\fP\d\s+2\(ha\s-2\u
+.B \d\s+2\*^\s-2\u\fIstring1\fP\d\s+2\*^\s-2\u\fIstring2\fP\d\s+2\*^\s-2\u
 Quick substitution.  Repeat the previous command, replacing
 .I string1
 with
 .IR string2 .
 Equivalent to
-.Q 
!!:s\d\s+2\(ha\s-2\u\fIstring1\fP\d\s+2\(ha\s-2\u\fIstring2\fP\d\s+2\(ha\s-2\u
+.Q !!:s\d\s+2\*^\s-2\u\fIstring1\fP\d\s+2\*^\s-2\u\fIstring2\fP\d\s+2\*^\s-2\u
 (see \fBModifiers\fP below).
 .TP
 .B !#
@@ -7867,7 +7881,7 @@ .SS Word Designators
 .B :
 separates the event specification from the word designator.
 It may be omitted if the word designator begins with a
-.BR \(ha ,
+.BR \*^ ,
 .BR $ ,
 .BR * ,
 .BR \- ,
@@ -7886,7 +7900,7 @@ .SS Word Designators
 .I n
 The \fIn\fRth word.
 .TP
-.B \(ha
+.B \*^
 The first argument.  That is, word 1.
 .TP
 .B $
@@ -8153,7 +8167,7 @@ .SH "SHELL BUILTIN COMMANDS"
 .IR .inputrc ,
 but each binding or command must be passed as a separate argument;
 e.g.,
-\(aq\(dq\eC\-x\eC\-r\(dq: re\-read\-init\-file\(aq.
+\*'\*"\eC\-x\eC\-r\*": re\-read\-init\-file\*'.
 In the following descriptions, output available to be re-read is formatted
 as commands that would appear in a
 .B readline
@@ -9253,7 +9267,7 @@ .SH "SHELL BUILTIN COMMANDS"
 of \fIpat\fP is replaced by \fIrep\fP.
 \fICommand\fP is interpreted the same as \fIfirst\fP above.
 A useful alias to use with this is
-.Q "r=\(dqfc \-s\(dq" ,
+.Q "r=\*"fc \-s\*"" ,
 so that typing
 .Q "r cc"
 runs the last command beginning with
@@ -9888,7 +9902,7 @@ .SH "SHELL BUILTIN COMMANDS"
 .B %q
 causes \fBprintf\fP to output the corresponding
 \fIargument\fP in a format that can be reused as shell input.
-\fB%q\fP and \fB%Q\fP use the \fB$\(aq\(aq\fP quoting style if any characters
+\fB%q\fP and \fB%Q\fP use the \fB$\*'\*'\fP quoting style if any characters
 in the argument string require it, and backslash quoting otherwise.
 If the format string uses the \fIprintf\fP alternate form, these two
 formats quote the argument string using single quotes.
@@ -10942,7 +10956,7 @@ .SH "SHELL BUILTIN COMMANDS"
 \fBPathname Expansion\fP are enabled.
 .TP 8
 .B extquote
-If set, \fB$\fP\(aq\fIstring\fP\(aq and \fB$\fP\(dq\fIstring\fP\(dq quoting is
+If set, \fB$\fP\*'\fIstring\fP\*' and \fB$\fP\*"\fIstring\fP\*" quoting is
 performed within \fB${\fP\fIparameter\fP\fB}\fP expansions
 enclosed in double quotes.  This option is enabled by default.
 .TP 8
@@ -11124,7 +11138,7 @@ .SH "SHELL BUILTIN COMMANDS"
 If set,
 .B bash
 encloses the translated results of
-.BR $\(dq .\|.\|.\& \(dq
+.BR $\*" .\|.\|.\& \*"
 quoting in single quotes instead of double quotes.
 If the string is not translated, this has no effect.
 .TP 8
@@ -11915,7 +11929,7 @@ .SH "SHELL COMPATIBILITY MODE"
 .PD 0
 .RS
 .IP \(bu
-quoting the rhs of the \fB[[\fP command's regexp matching operator (=\(ti)
+quoting the rhs of the \fB[[\fP command's regexp matching operator (=\*~)
 has no special effect
 .RE
 .PD
@@ -11981,7 +11995,7 @@ .SH "SHELL COMPATIBILITY MODE"
 .IP \(bu
 the shell does not print a warning message if an attempt is made to
 use a quoted compound assignment as an argument to declare
-(e.g., declare \-a foo=\(aq(1 2)\(aq). Later versions warn that this usage is
+(e.g., declare \-a foo=\*'(1 2)\*'). Later versions warn that this usage is
 deprecated
 .IP \(bu
 word expansion errors are considered non-fatal errors that cause the
@@ -12203,7 +12217,7 @@ .SH "SEE ALSO"
 \fIPortable Operating System Interface (POSIX) Part 2: Shell and Utilities\fP, 
IEEE \(em
 http://pubs.opengroup.org/onlinepubs/9699919799/
 .TP
-http://tiswww.case.edu/\(tichet/bash/POSIX \(em a description of posix mode
+http://tiswww.case.edu/\*~chet/bash/POSIX \(em a description of posix mode
 .TP
 \fIsh\fP(1), \fIksh\fP(1), \fIcsh\fP(1)
 .TP
@@ -12220,20 +12234,20 @@ .SH FILES
 .FN /etc/profile
 The systemwide initialization file, executed for login shells
 .TP
-.FN \(ti/.bash_profile
+.FN \*~/.bash_profile
 The personal initialization file, executed for login shells
 .TP
-.FN \(ti/.bashrc
+.FN \*~/.bashrc
 The individual per-interactive-shell startup file
 .TP
-.FN \(ti/.bash_logout
+.FN \*~/.bash_logout
 The individual login shell cleanup file, executed when a login shell exits
 .TP
-.FN \(ti/.bash_history
+.FN \*~/.bash_history
 The default value of \fBHISTFILE\fP, the file in which bash saves the
 command history
 .TP
-.FN \(ti/.inputrc
+.FN \*~/.inputrc
 Individual \fIreadline\fP initialization file
 .PD
 .SH AUTHORS
-- 
2.30.2

signature.asc
Description: PGP signature