docs: Canonicalize URLs.
[oota-llvm.git] / docs / CommandGuide / llvmgxx.pod
index 0f23844d195444e19de8c53c7ba375f419704312..1ea3d4967006aa1c0b2974c71adf8effef3b1203 100644 (file)
@@ -11,15 +11,12 @@ B<llvm-g++> [I<options>] I<filename>
 =head1 DESCRIPTION
 
 The B<llvm-g++> command is the LLVM C++ front end.  It is a modified
-version of g++ that takes C++ programs and compiles them into LLVM
-bytecode or assembly language, depending upon the options.
+version of g++ that compiles C++/ObjC++ programs into native code, 
+LLVM bitcode or assembly language, depending upon the options.
 
-Unless the B<-S> option is specified, B<llvm-g++> will use the
-L<gccas|gccas> program to perform some optimizations and create an
-LLVM bytecode file. Unless the B<-c> option is specified, B<llvm-g++>
-will also use the L<gccld|gccld> program to perform further
-optimizations and link the resulting bytecode file(s) with support
-libraries to create an executable program.
+By default, B<llvm-g++> compiles to native objects just like GCC does. If the
+B<-emit-llvm> option is given then it will generate LLVM bitcode files instead.
+If B<-S> (assembly) is also given, then it will generate LLVM assembly. 
 
 Being derived from the GNU Compiler Collection, B<llvm-g++> has many
 of g++'s features and accepts most of g++'s options.  It handles a
@@ -35,14 +32,14 @@ Print a summary of command line options.
 
 =item B<-S>
 
-Do not generate an LLVM bytecode file.  Rather, compile the source
+Do not generate an LLVM bitcode file.  Rather, compile the source
 file into an LLVM assembly language file.
 
 =item B<-c>
 
 Do not generate a linked executable.  Rather, compile the source
-file into an LLVM bytecode file.  This bytecode file can then be
-linked with other bytecode files later on to generate a full LLVM
+file into an LLVM bitcode file.  This bitcode file can then be
+linked with other bitcode files later on to generate a full LLVM
 executable.
 
 =item B<-o> I<filename>
@@ -62,11 +59,12 @@ repeated.
 =item B<-l>I<name>
 
 Link in the library libI<name>.[bc | a | so].  This library should
-be a bytecode library.
+be a bitcode library.
 
-=item B<-Wl,>I<option>
+=item B<-emit-llvm>
 
-Pass I<option> to the linker (usually gccld).
+Make the output be LLVM bitcode (or assembly) instead of native object (or
+assembly).
 
 =back
 
@@ -77,11 +75,11 @@ occurs, it will exit with a non-zero value.
 
 =head1 SEE ALSO
 
-L<llvm-gcc>, L<gccas>, L<gccld>
+L<llvm-gcc|llvmgcc>
 
 =head1 AUTHORS
 
-Maintained by the LLVM Team (L<http://llvm.cs.uiuc.edu>).
+Maintained by the LLVM Team (L<http://llvm.org/>).
 
 =cut