[gentoo-commits] proj/devmanual:master commit in: tools-reference/echo/

[gentoo-commits] proj/devmanual:master commit in: tools-reference/echo/

[Ulrich Müller]

commit:     0edced44cbbbb3bac79448fbf8b1620ecc2b39df
Author:     Sebastian Engel <sighunter <AT> gmx <DOT> de>
AuthorDate: Mon Aug 12 21:29:44 2024 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Aug 23 15:16:31 2024 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=0edced44

tools-reference/echo: Format the word variable as inline code

The devmanual commonly uses <c> to format variables in text passages as code
to make them more distinguishable from the rest of the text and that's why
it should be done here too.

Signed-off-by: Sebastian Engel <sighunter <AT> gmx.de>
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 tools-reference/echo/text.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tools-reference/echo/text.xml b/tools-reference/echo/text.xml
index 9bce77c..dba3452 100644
--- a/tools-reference/echo/text.xml
+++ b/tools-reference/echo/text.xml
@@ -47,7 +47,7 @@ As of &gt;=bash-2.05b, the so-called "here strings" have been
 introduced. Using "here strings", you can pass contents of an
 environment variable to the standard input of an application, using
 <c>&lt;&lt;&lt;word</c> redirection: what actually happens is
-that <c>bash</c> expands word and passes the result to the standard
+that <c>bash</c> expands <c>word</c> and passes the result to the standard
 input.
 </p>
 

[gentoo-commits] proj/devmanual:master commit in: tools-reference/echo/

[Ulrich Müller]

commit:     9a7164477f77f5346e32d6073932018bdae70961
Author:     Sebastian Engel <sighunter <AT> gmx <DOT> de>
AuthorDate: Mon Aug 12 20:35:40 2024 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Aug 23 15:16:25 2024 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=9a716447

tools-reference/echo: Improve wording in abuse chapter

"should be used as less as possible" is not a correct expression,
use "should be avoided" instead.

Signed-off-by: Sebastian Engel <sighunter <AT> gmx.de>
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 tools-reference/echo/text.xml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/tools-reference/echo/text.xml b/tools-reference/echo/text.xml
index f72d833..9bce77c 100644
--- a/tools-reference/echo/text.xml
+++ b/tools-reference/echo/text.xml
@@ -29,12 +29,12 @@ the same as the former, but they won't print the trailing newline
 
 <p>
 All usage of the form <c>echo ${somevar} | grep substring</c> just to
-check if the content of the <c>${somevar}</c> variable
-contains <c>substring</c>, or more often, <c>echo ${somevar} |
-command</c>, is deprecated and should be (and in most cases, can be)
-used as less as possible: doing so involves for no reason an
-additional shell session and a pipe. The "here strings" section
-describes the preferred way of dealing with such cases.
+check if the content of the <c>${somevar}</c> variable contains
+<c>substring</c>, or more often, <c>echo ${somevar} | command</c>,
+is deprecated and should be (and in most cases, can be) avoided:
+doing so involves for no reason an additional shell session and a pipe.
+The "here strings" section describes the preferred way
+of dealing with such cases.
 </p>
 </body>
 </section>

[gentoo-commits] proj/devmanual:master commit in: tools-reference/echo/

[Ulrich Müller]

commit:     60b9d214f4454aea8451cc7fdf49035e707da7d9
Author:     Sebastian Engel <sighunter <AT> gmx <DOT> de>
AuthorDate: Thu Aug 29 14:21:00 2024 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sat Aug 31 16:40:52 2024 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=60b9d214

tools-reference/echo: Remove bash version history

Those bash "here strings" were introduced 22 years ago and stating the version
they were implemented does not serve any purpose any more.

Signed-off-by: Sebastian Engel <sighunter <AT> gmx.de>
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 tools-reference/echo/text.xml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/tools-reference/echo/text.xml b/tools-reference/echo/text.xml
index dba3452..404d319 100644
--- a/tools-reference/echo/text.xml
+++ b/tools-reference/echo/text.xml
@@ -43,8 +43,7 @@ of dealing with such cases.
 <title>Here strings</title>
 <body>
 <p>
-As of &gt;=bash-2.05b, the so-called "here strings" have been
-introduced. Using "here strings", you can pass contents of an
+Using "here strings", you can pass contents of an
 environment variable to the standard input of an application, using
 <c>&lt;&lt;&lt;word</c> redirection: what actually happens is
 that <c>bash</c> expands <c>word</c> and passes the result to the standard