[llvm-commits] CVS: llvm/www/docs/CommandGuide/llvmas.html llvmdis.html

[John Criswell]

Changes in directory llvm/www/docs/CommandGuide:

llvmas.html updated: 1.3 -> 1.4
llvmdis.html updated: 1.3 -> 1.4

---
Log message:

Added information about how llvm-as and llvm-dis select the input and output
filenames.
Corrected some typos in the llvm-dis documentation.



---
Diffs of the changes:

Index: llvm/www/docs/CommandGuide/llvmas.html
diff -u llvm/www/docs/CommandGuide/llvmas.html:1.3 llvm/www/docs/CommandGuide/llvmas.html:1.4
--- llvm/www/docs/CommandGuide/llvmas.html:1.3	Thu Sep 25 14:50:04 2003
+++ llvm/www/docs/CommandGuide/llvmas.html	Thu Sep 25 21:59:00 2003
@@ -20,15 +20,39 @@
 SYNOPSIS
 </h3>
 
-llvm-as [options] < filename>
+llvm-as [options] [filename]
 <h3>
 DESCRIPTION
 </h3>
 
-The llvm-as command is the LLVM assembler.  It takes a human readable LLVM
-assembly language file and translates it into LLVM bytecode.
+The llvm-as command is the LLVM assembler.  It reads a file containing human
+readable LLVM assembly language, translates it to LLVM bytecode, and writes the
+result into a file or to standard output.
+<p>
+
+If filename is omitted or is -, then llvm-as reads its input from standard
+input.
+<p>
 
-By default, llvm-as places its output into filename.bc.
+If an output file is not specified with the -o option, then llvm-as sends its
+output to a file or standard output by the following logic:
+
+<ul>
+	<li>
+	If the input is standard input, then the output is standard output.
+	<p>
+
+	<li>
+	If the input is a file that ends with .ll, then the output file is of
+	the same name, except that the suffix is changed to .bc.
+	<p>
+
+	<li>
+	If the input is a file that does not end with the .ll suffix, then the
+	output file has the same name as the input file, except that the .bc suffix
+	is appended.
+	<p>
+</ul>
 
 <h3>
 OPTIONS
@@ -49,7 +73,8 @@
 
 	<li> -o <filename>
 	<br>
-	Specify the output filename.
+	Specify the output filename.  If filename is -, then llvm-as sends its
+	output to standard output.
 	<p>
 
 	<li> -stats


Index: llvm/www/docs/CommandGuide/llvmdis.html
diff -u llvm/www/docs/CommandGuide/llvmdis.html:1.3 llvm/www/docs/CommandGuide/llvmdis.html:1.4
--- llvm/www/docs/CommandGuide/llvmdis.html:1.3	Thu Sep 25 14:50:04 2003
+++ llvm/www/docs/CommandGuide/llvmdis.html	Thu Sep 25 21:59:00 2003
@@ -20,16 +20,39 @@
 SYNOPSIS
 </h3>
 
-llvm-dis [options] < filename>
+llvm-dis [options] [filename]
 <h3>
 DESCRIPTION
 </h3>
 
 The llvm-dis command is the LLVM disassembler.  It takes an LLVM bytecode file
-and converts it into one of several human readable formats.
+and converts it into LLVM assembly language or C source code with equivalent
+functionality.
+<p>
+
+If filename is omitted, llvm-dis reads its input from standard input.
+<p>
+
+The default output file for llvm-dis is determined by the following logic:
+<ul>
+	<li>
+	If the input is standard input or the file -, then the output is standard
+	output.
+	<p>
+
+	<li>
+	If the input filename ends in .bc, then the output filename will be
+	identical, except that the .bc suffix will be replaced by the .ll or .c
+	suffix (for LLVM assembly language and C code, respectively).
+	<p>
+
+	<li>
+	If the input filename does not end in .bc, then the output filename will be
+	identical to the input filename, except that the .ll or .c suffix will be
+	appended to the filename (for LLVM assembly language and C code,
+	respectively).
+</ul>
 
-By default, llvm-dis places its output in filename.ll, removing the .bc suffix
-if it exists.
 <h3>
 OPTIONS
 </h3>
@@ -60,12 +83,13 @@
 
 	<li> -o <filename>
 	<br>
-	Specify the output filename.
+	Specify the output filename.  If filename is -, then the output is sent to
+	standard output.
 	<p>
 
-	<li> -time-pdisses
+	<li> -time-passes
 	<br>
-	Record the amount of time needed for each pdiss and print it to standard
+	Record the amount of time needed for each pass and print it to standard
 	error.
 	<p>
 </ul>
@@ -80,7 +104,7 @@
 <h3>
 SEE ALSO
 </h3>
-llvm-dis
+llvm-as
 
 <HR>
 <a href="http://llvm.cs.uiuc.edu">LLVM Team</a>