drew
/
acadia-newlib
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

* pathnames.sgml: Clarify '@' processing.

This commit is contained in:
Christopher Faylor 2013-02-13 17:57:19 +00:00
parent 6cb2bb7166
commit 729c92aaa7
2 changed files with 9 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
winsup/doc/ChangeLog
View File

@ -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> 2013-01-23 Christopher Faylor <me.cygwin2012@cgf.cx>
* faq-programming.xml: Remove reference to "make check". * faq-programming.xml: Remove reference to "make check".

10
winsup/doc/pathnames.sgml
View File

@ -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> <sect2 id="pathnames-at"><title>The @pathnames</title>
<para>To circumvent the limitations on shell line length in the native <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 starting with "@" in a special way. If a file
<filename>pathname</filename> exists, the argument <filename>pathname</filename> exists, the argument
<filename>@pathname</filename> expands recursively to the content of <filename>@pathname</filename> expands recursively to the content of
<filename>pathname</filename>. Double quotes can be used inside the <filename>pathname</filename>. Double quotes can be used inside the
file to delimit strings containing blank space. file to delimit strings containing blank space.
In the following example compare the behaviors of the bash built-in In the following example compare the behaviors
<command>echo</command> and of the program <command>/bin/echo</command>.</para> <command>/bin/echo</command> when run from bash and from the Windows command prompt.</para>
<example id="pathnames-at-ex"><title> Using @pathname</title> <example id="pathnames-at-ex"><title> Using @pathname</title>
<screen> <screen>
<prompt>bash$</prompt> <userinput>echo 'This is "a long" line' > mylist</userinput> <prompt>bash$</prompt> <userinput>@/bin/echo 'This is "a long" line' > mylist</userinput>
<prompt>bash$</prompt> <userinput>echo @mylist</userinput> <prompt>bash$</prompt> <userinput>/bin/echo @mylist</userinput>
@mylist @mylist
<prompt>bash$</prompt> <userinput>cmd</userinput> <prompt>bash$</prompt> <userinput>cmd</userinput>
<prompt>c:\&gt;</prompt> <userinput>c:\cygwin\bin\echo @mylist</userinput> <prompt>c:\&gt;</prompt> <userinput>c:\cygwin\bin\echo @mylist</userinput>