[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 04/25] doc/bash.1, doc/bashref.texi: Align wording.
From: |
G. Branden Robinson |
Subject: |
[PATCH 04/25] doc/bash.1, doc/bashref.texi: Align wording. |
Date: |
Thu, 21 Nov 2024 22:19:28 -0600 |
* 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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH 04/25] doc/bash.1, doc/bashref.texi: Align wording.,
G. Branden Robinson <=