new noexpand_translations shopt option

doc/bash.1

@@ -5,12 +5,12 @@
 .\"	Case Western Reserve University
 .\"	chet.ramey@case.edu
 .\"
-.\"	Last Change: Fri Aug  6 14:30:46 EDT 2021
+.\"	Last Change: Tue Aug 10 11:06:20 EDT 2021
 .\"
 .\" bash_builtins, strip all but Built-Ins section
 .if \n(zZ=1 .ig zZ
 .if \n(zY=1 .ig zY
-.TH BASH 1 "2021 August 6" "GNU Bash 5.1"
+.TH BASH 1 "2021 August 10" "GNU Bash 5.1"
 .\"
 .\" There's some problem with having a `@'
 .\" in a tagged paragraph with the BSD man macros.
@@ -1221,10 +1221,19 @@ The \fIgettext\fP infrastructure performs the lookup and
 translation, using the \fBLC_MESSAGES\fP, \fBTEXTDOMAINDIR\fP,
 and \fBTEXTDOMAIN\fP shell variables.
 If the current locale is \fBC\fP or \fBPOSIX\fP,
-or if there are no translations available,
+if there are no translations available,
+or if the string is not translated,
 the dollar sign is ignored.
-This is a form of double quoting, so the string remains double-quoted,
-whether or not it is translated and replaced.
+This is a form of double quoting, so the string remains double-quoted
+by default, whether or not it is translated and replaced.
+If the \fBnoexpand_translation\fP option is enabled
+using the \fBshopt\fP builtin,
+translated strings are single-quoted instead of double-quoted.
+See the description of
+.B shopt
+below under
+.SM
+.BR SHELL BUILTIN COMMANDS .
 .SH PARAMETERS
 A
 .I parameter
@@ -10362,6 +10371,13 @@ while executing \fBcase\fP or \fB[[\fP conditional commands,
 when performing pattern substitution word expansions,
 or when filtering possible completions as part of programmable completion.
 .TP 8
+.B noexpand_translation
+If set,
+.B bash
+encloses the translated results of $"..." quoting in single quotes
+instead of double quotes.
+If the string is not translated, this has no effect.
+.TP 8
 .B nullglob
 If set,
 .B bash