* coreutils.texi (md5sum invocation): Document escapes in output

format.  Reported by Armijn Hemel.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index c4171b8f4ac6d80a7f0da76aaaf5a1c8aead41b5..38b5f9dfdc3bd5739aaa9608e2b9140bc0a2f1d3 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2007-03-21  Eric Blake  <ebb9@byu.net>
+
+       * coreutils.texi (md5sum invocation): Document escapes in output
+       format.  Reported by Armijn Hemel.
+
 2007-03-15  Paul Eggert  <eggert@cs.ucla.edu>
 
        Fix manual in response to bug reports by Dan Jacobson.

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 7a4cc2db0655935545f712024385ba104cbf44a5..588147f53215cc6c46a3ed9f1ba64807730861c9 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -3203,6 +3203,10 @@ md5sum [@var{option}]@dots{} [@var{file}]@dots{}
 
 For each @var{file}, @samp{md5sum} outputs the MD5 checksum, a flag
 indicating a binary or text input file, and the file name.
+If @var{file} contains a backslash or newline, the
+line is started with a backslash, and each problematic character in
+the file name is escaped with a backslash, making the output
+unambiguous even in the presence of arbitrary file names.
 If @var{file} is omitted or specified as @samp{-}, standard input is read.
 
 The program accepts the following options.  Also see @ref{Common options}.