From: Pádraig Brady <P@draigBrady.com>
Date: Fri, 28 Oct 2022 13:40:28 +0000 (+0100)
Subject: doc: printf: make "java" encoding example more standard
X-Git-Tag: v9.2~119
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=994c83e2e3675a67b21fac36fc24395da3e09476;p=thirdparty%2Fcoreutils.git

doc: printf: make "java" encoding example more standard

Note using iconv(1) rather than recode(1) is not appropriate
for this example, as the required functionality is only
available on libiconv's iconv implementation, which is
not installed on most systems.

* doc/coreutils.texi (printf invocation): Use env rather than
/usr/local/bin for the printf command.  Escape '%' so more robust.
Also use a locale that exists on modern systems.
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 0662e4e33f..d82c86709a 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -13255,10 +13255,10 @@ is how to convert a piece of text into a shell script which will output
 this text in a locale-independent way:
 
 @example
-$ LC_CTYPE=zh_CN.big5 /usr/local/bin/printf \
+$ LC_CTYPE=zh_TW.big5 env printf \
     '\u4e2d\u6587\n' > sample.txt
 $ recode BIG5..JAVA < sample.txt \
-    | sed -e "s|^|/usr/local/bin/printf '|" -e "s|$|\\\\n'|" \
+    | sed -e "s|^|env printf '|" -e "s|%|%%|g" -e "s|$|\\\\n'|" \
     > sample.sh
 @end example