diff options
| author | Christopher Faylor <me@cgf.cx> | 2013-02-13 21:57:19 +0400 |
|---|---|---|
| committer | Christopher Faylor <me@cgf.cx> | 2013-02-13 21:57:19 +0400 |
| commit | 729c92aaa76aa01a3406d2f0c297ae0ef6f5ce7f (patch) | |
| tree | c084f0ed483c04b413886538b574d7e0a01d5cfd /winsup | |
| parent | 6cb2bb7166b5b80f1bc8792757da942e2225d5f7 (diff) | |
* pathnames.sgml: Clarify '@' processing.
Diffstat (limited to 'winsup')
| -rw-r--r-- | winsup/doc/ChangeLog | 4 | ||||
| -rw-r--r-- | 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:\></prompt> <userinput>c:\cygwin\bin\echo @mylist</userinput> |