* Perform Kemper notectomy. * Break lines in the same places to ease diffing. * Align verb tenses. --- doc/bash.1 | 11 ++++++----- doc/bashref.texi | 40 ++++++++++++++++++++++++++-------------- 2 files changed, 32 insertions(+), 19 deletions(-)
diff --git a/doc/bash.1 b/doc/bash.1 index 6c864eab..863a8ded 100644 --- a/doc/bash.1 +++ b/doc/bash.1 @@ -2279,7 +2279,8 @@ .SS "Shell Variables" is not used to search for the resultant filename. .TP .B BASH_XTRACEFD -If set to an integer corresponding to a valid file descriptor, \fBbash\fP +If set to an integer corresponding to a valid file descriptor, +\fBbash\fP will write the trace output generated when .Q "set \-x" is enabled to that file descriptor, @@ -2293,12 +2294,12 @@ .SS "Shell Variables" .B BASH_XTRACEFD or assigning it the empty string causes the trace output to be sent to the standard error. -Note that setting +Setting .SM .B BASH_XTRACEFD -to 2 (the standard error file -descriptor) and then unsetting it will result in the standard error -being closed. +to 2 +(the standard error file descriptor) +and then unsetting it results in the standard error being closed. .TP .B CDPATH The search path for the diff --git a/doc/bashref.texi b/doc/bashref.texi index f171e329..9450cb72 100644 --- a/doc/bashref.texi +++ b/doc/bashref.texi @@ -6813,19 +6813,25 @@ @node Top Bash (e.g., 5.2.37(3)-release). @item BASH_XTRACEFD -If set to an integer corresponding to a valid file descriptor, Bash -will write the trace output generated when @samp{set -x} +If set to an integer corresponding to a valid file descriptor, +Bash will write the trace output generated when +@samp{set -x} is enabled to that file descriptor instead of the standard error. This allows tracing output to be separated from diagnostic and error messages. -The file descriptor is closed when @code{BASH_XTRACEFD} is unset or assigned -a new value. -Unsetting @code{BASH_XTRACEFD} or assigning it the empty string causes the +The file descriptor is closed when +@code{BASH_XTRACEFD} +is unset or assigned a new value. +Unsetting +@code{BASH_XTRACEFD} +or assigning it the empty string causes the trace output to be sent to the standard error. -Note that setting @code{BASH_XTRACEFD} to 2 (the standard error file -descriptor) and then unsetting it will result in the standard error -being closed. +Setting +@code{BASH_XTRACEFD} +to 2 +(the standard error file descriptor) +and then unsetting it results in the standard error being closed. @item CHILD_MAX Set the number of exited child status values for the shell to remember. @@ -7799,19 +7805,25 @@ @node Top @subsubheading Invoked by remote shell daemon -Bash attempts to determine when it is being run with its standard input +Bash +attempts to determine when it is being run with its standard input connected to a network connection, as when executed by the historical and rarely-seen remote shell daemon, usually @code{rshd}, or the secure shell daemon @code{sshd}. -If Bash +If +Bash determines it is being run non-interactively in this fashion, -it reads and executes commands from @file{~/.bashrc}, if that -file exists and is readable. +it reads and executes commands from +@file{~/.bashrc}, +if that file exists and is readable. It will not do this if invoked as @code{sh}. -The @option{--norc} option will inhibit this behavior, and the +The +@option{--norc} +option will inhibit this behavior, and the @option{--rcfile} option will make Bash use a different file instead of -@file{~/.bashrc}, but neither +@file{~/.bashrc}, +but neither @code{rshd} nor @code{sshd} generally invoke the shell with those options or allow them to be specified. -- 2.30.2
signature.asc
Description: PGP signature