From: Eric Blake <ebb9@byu.net>
Date: Thu, 22 Mar 2007 20:46:54 +0000 (+0100)
Subject: * coreutils.texi (md5sum invocation): Document escapes in output
X-Git-Tag: COREUTILS-6_9~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=826ff082dbe051d3a7a35e36afb110c64b4132e6;p=thirdparty%2Fcoreutils.git

* coreutils.texi (md5sum invocation): Document escapes in output
format.  Reported by Armijn Hemel.
---

diff --git a/doc/ChangeLog b/doc/ChangeLog
index c4171b8f4a..38b5f9dfdc 100644
--- 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 7a4cc2db06..588147f532 100644
--- 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}.