bug-bash
[Top][All Lists]
Advanced

[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

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]