[llvm-commits] CVS: llvm/docs/CommandGuide/gccas.pod

[Reid Spencer]

Changes in directory llvm/docs/CommandGuide:

gccas.pod updated: 1.6 -> 1.7
---
Log message:

For PR1152: http://llvm.org/PR1152 :
Update documentation to reflect that this isn't a full-blown executable
any more.


---
Diffs of the changes:  (+15 -15)

 gccas.pod |   30 +++++++++++++++---------------
 1 files changed, 15 insertions(+), 15 deletions(-)


Index: llvm/docs/CommandGuide/gccas.pod
diff -u llvm/docs/CommandGuide/gccas.pod:1.6 llvm/docs/CommandGuide/gccas.pod:1.7
--- llvm/docs/CommandGuide/gccas.pod:1.6	Tue Nov 21 16:53:12 2006
+++ llvm/docs/CommandGuide/gccas.pod	Fri Feb  2 18:44:47 2007
@@ -2,7 +2,7 @@
 
 =head1 NAME
 
-gccas - optimizing LLVM assembler
+gccas - convenience script to run B<llvm-as> and B<opt>
 
 =head1 SYNOPSIS
 
@@ -10,19 +10,19 @@
 
 =head1 DESCRIPTION
 
-The B<gccas> utility takes an LLVM assembly file generated by the
-L<llvmgcc|llvmgcc> or L<llvmg++|llvmgxx> front-ends and converts
-it into an LLVM bytecode file.  It is primarily used by the GCC
-front end, and as such, attempts to mimic the interface provided
-by the default system assembler so that it can act as a "drop-in"
-replacement.
-
-B<gccas> performs a number of optimizations on the input program,
-including but not limited to: promotion of stack values to SSA
-registers; elimination of dead globals, function arguments, code,
-and types; tail-call elimination; loop-invariant code motion; global
-common-subexpression elimination; and sparse conditional constant
-propagation.
+The B<gccas> shell script passes an LLVM assembly file through the B<llvm-as> 
+and B<opt> programs to generate an optimized bytecode file. Its name is an
+historical artifact from when it was a full executable used to process LLVM 
+assembly generated by the L<llvmgcc|llvmgcc> or L<llvmg++|llvmgxx> front-ends.  
+Currently this is a shell script that simulates what the old B<gccas> executable
+once did. 
+
+B<gccas> performs a number of optimizations on the input program, including but
+not limited to: promotion of stack values to SSA registers; elimination of dead
+globals, function arguments, code, and types; tail-call elimination; 
+loop-invariant code motion; global common-subexpression elimination; and 
+sparse conditional constant propagation. It accomplishes this by using the
+B<-std-compile-opts> option to the B<opt> tool.
 
 =head1 OPTIONS
 
@@ -71,7 +71,7 @@
 
 =head1 SEE ALSO
 
-L<llvm-as|llvm-as>, L<gccld|gccld>
+L<llvm-as|llvm-as>, L<opt|opt>, L<gccld|gccld>
 
 =head1 AUTHORS