[llvm-commits] CVS: llvm/docs/TestingGuide.html

[Reid Spencer]

Changes in directory llvm/docs:

TestingGuide.html updated: 1.41 -> 1.42
---
Log message:

Add some info about the pipelines and redirection.


---
Diffs of the changes:  (+19 -1)

 TestingGuide.html |   20 +++++++++++++++++++-
 1 files changed, 19 insertions(+), 1 deletion(-)


Index: llvm/docs/TestingGuide.html
diff -u llvm/docs/TestingGuide.html:1.41 llvm/docs/TestingGuide.html:1.42
--- llvm/docs/TestingGuide.html:1.41	Sat Apr 14 16:46:15 2007
+++ llvm/docs/TestingGuide.html	Sat Apr 14 18:27:06 2007
@@ -323,6 +323,24 @@
   any process in the pipeline fails, the entire line (and test case) fails too.
   </p>
 
+  <p>As with a Unix shell, the RUN: lines permit pipelines and I/O redirection
+  to be used. However, the usage is slightly different than for Bash. To check
+  what's legal, see the documentation for the 
+  <a href="http://www.tcl.tk/man/tcl8.5/TclCmd/exec.htm#M2">Tcl exec</a>
+  command and the 
+  <a href="http://www.tcl.tk/man/tcl8.5/tutorial/Tcl26.html">tutorial</a>. 
+  The major differences are:</p>
+  <ul>
+    <li>You can't do <tt>2>&1</tt>. That will cause Tcl to write to a
+    file named <tt>&1</tt>. Usually this is done to get stderr to go through
+    a pipe. You can do that in tcl with <tt>|&</tt> so replace this idiom:
+    <tt>... 2>&1 | grep</tt> with <tt>... |& grep</tt></li>
+    <li>You can only redirect to a file, not to another descriptor and not from
+    a here document.</li>
+    <li>tcl supports redirecting to open files with the @ syntax but you
+    shouldn't use that here.</li>
+  </ul>
+
   <p> Below is an example of legal RUN lines in a <tt>.ll</tt> file:</p>
   <pre>
   ; RUN: llvm-as < %s | llvm-dis > %t1
@@ -756,7 +774,7 @@
 
   John T. Criswell, Reid Spencer, and Tanya Lattner<br>
   <a href="http://llvm.org">The LLVM Compiler Infrastructure</a><br/>
-  Last modified: $Date: 2007/04/14 21:46:15 $
+  Last modified: $Date: 2007/04/14 23:27:06 $
 </address>
 </body>
 </html>