[PATCH] doc: suggest a few more workarounds

[Eric Blake]

* doc/autoconf.texi (Limitations of Usual Tools) <tr>: Mention
that 'redundant' brackets can work around Solaris bug.
(File Descriptors): Mention that {} works as well as () for
silencing file-not-found warnings.
* THANKS: Update.
Suggested by Pádraig Brady.

Signed-off-by: Eric Blake <address@hidden>
---
 ChangeLog         |   10 ++++++++++
 THANKS            |    1 +
 doc/autoconf.texi |   11 +++++++----
 3 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 78590f1..94f6992 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2010-10-05  Eric Blake  <address@hidden>
+
+       doc: suggest a few more workarounds
+       * doc/autoconf.texi (Limitations of Usual Tools) <tr>: Mention
+       that 'redundant' brackets can work around Solaris bug.
+       (File Descriptors): Mention that {} works as well as () for
+       silencing file-not-found warnings.
+       * THANKS: Update.
+       Suggested by Pádraig Brady.
+
 2010-09-24  Ralf Wildenhues  <address@hidden>

        tests: normalize trailing spaces in gcc -E -dD output.
diff --git a/THANKS b/THANKS
index ed871a8..9c6b89b 100644
--- a/THANKS
+++ b/THANKS
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 66d8a21..645059a 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -15033,12 +15033,12 @@ File Descriptors
 On the other hand, some shells, such as Solaris or FreeBSD
 @command{/bin/sh}, warn about missing programs before performing
 redirections.  Therefore, to silently check whether a program exists, it
-is necessary to perform redirections on a subshell:
-
+is necessary to perform redirections on a subshell or brace group:
 @example
 $ @kbd{/bin/sh -c 'nosuch 2>/dev/null'}
 nosuch: not found
 $ @kbd{/bin/sh -c '(nosuch) 2>/dev/null'}
+$ @kbd{/bin/sh -c '@{ nosuch; @} 2>/dev/null'}
 $ @kbd{bash -c 'nosuch 2>/dev/null'}
 @end example

@@ -19032,13 +19032,16 @@ Limitations of Usual Tools
 moonlight
 @end example

-Not all versions of @command{tr} recognize ranges of characters: at
+Not all versions of @command{tr} recognize direct ranges of characters: at
 least Solaris @command{/usr/bin/tr} still fails to do so.  But you can
-use @command{/usr/xpg4/bin/tr} instead.
+use @command{/usr/xpg4/bin/tr} instead, or add brackets (which in Posix
+transliterate to themselves).

 @example
 $ @kbd{echo "Hazy Fantazy" | LC_ALL=C /usr/bin/tr a-z A-Z}
 HAZy FAntAZy
+$ @kbd{echo "Hazy Fantazy" | LC_ALL=C /usr/bin/tr '[a-z]' '[A-Z]'}
+HAZY FANTAZY
 $ @kbd{echo "Hazy Fantazy" | LC_ALL=C /usr/xpg4/bin/tr a-z A-Z}
 HAZY FANTAZY
 @end example
-- 
1.7.2.3