From 729c92aaa76aa01a3406d2f0c297ae0ef6f5ce7f Mon Sep 17 00:00:00 2001
From: Christopher Faylor <me@cgf.cx>
Date: Wed, 13 Feb 2013 17:57:19 +0000
Subject: [PATCH] * pathnames.sgml: Clarify '@' processing.

---
 winsup/doc/ChangeLog      |  4 ++++
 winsup/doc/pathnames.sgml | 10 +++++-----
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index a0d967da8..2839ad9d8 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,7 @@
+2013-02-13  Christopher Faylor  <me.cygwin2013@cgf.cx>
+
+	* pathnames.sgml: Clarify '@' processing.
+
 2013-01-23  Christopher Faylor  <me.cygwin2012@cgf.cx>
 
 	* faq-programming.xml: Remove reference to "make check".
diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml
index 5860ebb0b..77f47a259 100644
--- a/winsup/doc/pathnames.sgml
+++ b/winsup/doc/pathnames.sgml
@@ -987,19 +987,19 @@ If a registry key contains a subkey and a value with the same name
 
 <sect2 id="pathnames-at"><title>The @pathnames</title> 
 <para>To circumvent the limitations on shell line length in the native
-Windows command shells, Cygwin programs expand their arguments
+Windows command shells, Cygwin programs, when invoked by non-Cygwin processes, expand their arguments
 starting with "@" in a special way.  If a file
 <filename>pathname</filename> exists, the argument
 <filename>@pathname</filename> expands recursively to the content of
 <filename>pathname</filename>. Double quotes can be used inside the
 file to delimit strings containing blank space. 
-In the following example compare the behaviors of the bash built-in
-<command>echo</command> and of the program <command>/bin/echo</command>.</para>
+In the following example compare the behaviors
+<command>/bin/echo</command> when run from bash and from the Windows command prompt.</para>
 
 <example id="pathnames-at-ex"><title> Using @pathname</title>
 <screen>
-<prompt>bash$</prompt> <userinput>echo  'This   is   "a     long"  line' > mylist</userinput>
-<prompt>bash$</prompt> <userinput>echo @mylist</userinput>
+<prompt>bash$</prompt> <userinput>@/bin/echo  'This   is   "a     long"  line' > mylist</userinput>
+<prompt>bash$</prompt> <userinput>/bin/echo @mylist</userinput>
 @mylist
 <prompt>bash$</prompt> <userinput>cmd</userinput>
 <prompt>c:\&gt;</prompt> <userinput>c:\cygwin\bin\echo @mylist</userinput>