How to use echo

[Ralf Wildenhues]

OK to apply (HEAD, branch-2-0)?

(I do realize that my notation is kind of inconsistent -- should I write
  printf %s\\n
instead?)

Regards,
Ralf

Index: HACKING
===================================================================
RCS file: /cvsroot/libtool/libtool/HACKING,v
retrieving revision 1.12
diff -u -r1.12 HACKING
--- HACKING     1 Feb 2005 07:34:33 -0000       1.12
+++ HACKING     25 Mar 2005 09:28:02 -0000
@@ -226,7 +226,23 @@
   functions should begin indented by 4 spaces.
 
 
-8. Abstraction layers in libltdl
+8. Editing `.m4' Files
+======================
+
+* Be careful with both `echo' and `$ECHO'.  As the latter may be one of
+    echo
+    print -r
+    printf %s\n
+    $CONFIG_SHELL $0 --fallback-echo
+  it may not have more than one argument, its value may not be eval'ed
+  and the argument may not start with a `-'.  As a rule of thumb, use
+    echo ..            for literal (constant) strings without leading
+                       hyphen and no backslashes within,
+    $ECHO ".."         for strings without leading hyphen,
+    $ECHO ".." | $Xsed otherwise.
+
+
+9. Abstraction layers in libltdl
 ================================
 
 * The libltdl API uses a layered approach to differentiate internal and
@@ -310,7 +326,7 @@
        lt__private.h
 
 
-9. Release Procedure
+10. Release Procedure
 ====================
 
 * If you are a libtool maintainer, but have not yet registered your
@@ -397,7 +413,7 @@
 
 
 
-10. Alpha release note template
+11. Alpha release note template
 ===============================
 
 To: address@hidden, address@hidden
@@ -470,7 +486,7 @@
 
 
 
-11. Full release note template
+12. Full release note template
 ==============================
 
 To: address@hidden