From 9b081c6696c4db36e1a01c476175c852aa2a4816 Mon Sep 17 00:00:00 2001
From: Chris Lattner <sabre@nondot.org>
Date: Wed, 6 May 2009 17:22:08 +0000
Subject: [PATCH] More content.

git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@71088 91177308-0d34-0410-b5e6-96231b3b80d8
---
 docs/tools/clang.pod | 105 +++++++++++++++++++++++++++++++++----------
 1 file changed, 82 insertions(+), 23 deletions(-)

diff --git a/docs/tools/clang.pod b/docs/tools/clang.pod
index 7c1c873b49..3461674bef 100644
--- a/docs/tools/clang.pod
+++ b/docs/tools/clang.pod
@@ -54,13 +54,13 @@ This stage translates an AST into low-level intermediate code or machine code
 the generated code and handling target-specfic code generation.  The output of
 this stage is typically called a ".s" file.
 
-=item B<Assembly>
+=item B<Assembler>
 
 This stage runs the target assembler to translate the output of the compiler
 into a target object file.  The output of this stage is typically called a ".o"
 file.
 
-=item B<Linking>
+=item B<Linker>
 
 This stage runs the target linker to merge multiple object files into an
 executable or dynamic library.  The output of this stage is typically called an
@@ -69,56 +69,68 @@ executable or dynamic library.  The output of this stage is typically called an
 =back
 
 The Clang compiler supports a large number of options to control each of these
-stages.
+stages.  In addition to compilation of code, Clang also supports other tools.
 
-=head1 OPTIONS
+B<Clang Static Analyzer>
 
+The Clang Static Analyzer is a tool that scans source code to try to find bugs
+though code analysis.  This tool uses many parts of Clang and is built into the
+same driver.
 
-=head2 Stage Selection Options
 
-=over
+=head1 OPTIONS
 
-=item B<--help>
+=head2 Stage Selection Options
 
-Display available options.
+=over
 
+=item B<-E>
 
-=item B<-###>
+Run the preprocessor stage.
 
-Print the commands to run for this compilation.
+=item B<-fsyntax-only>
 
+Run the preprocessor, parser and type checking stages.
 
-=item B<-E>
+=item B<-emit-llvm>
 
-Only run the preprocessor.
+Run the preprocessor, parser, type checking stages, LLVM generation and
+optimization stages.
 
 =item B<-S>
 
-Only run preprocess and compilation steps.
+Run all of the above, plus target-specific code generation, producing an
+assembly file.
 
 =item B<-c>
 
-Only run preprocess, compile, and assemble steps.
-
-=item B<-emit-llvm>
+Run all of the above, plus the assembler, generating a target ".o" object file.
 
-Use the LLVM representation for assembler and object files.
+=item B<no stage selection option>
 
+If no stage selection option is specified, all stages above are run, and the
+linker is run to combine the results into an executable or shared library.
 
+=item B<--analyze>
 
+Run the Clang Static Analyzer.
 
 =back
 
 
 
+=head2 Driver Options
 
+=over
 
+=item B<-###>
 
-=over
+Print the commands to run for this compilation.
 
-=item B<--analyze>
+=item B<--help>
+
+Display available options.
 
-Run the static analyzer.
 =item B<-ObjC++>
 
 Treat source input files as Objective-C++ inputs.
@@ -169,6 +181,7 @@ Write output to I<file>.
 
 =item B<-pipe>
 
+FIXME: WHY DOCUMENT THIS.
 Use pipes between commands, when possible.
 
 =item B<-print-file-name>=I<file>
@@ -203,19 +216,65 @@ Show commands to run and use verbose output.
 
 Treat subsequent input files as having type I<language>.
 
+
+=back
+
+
+
+
+
+=head2 Preprocessor Options
+
+=over
+
+=back
+
+
+
+
+=head2 Parser and Semantic Analysis Options
+
+=over
+
 =back
 
+
+
+=head2 Code Generation and Optimization Options
+
+=over
+
+=back
+
+
+=head2 Assembler Options
+
+=over
+
+=back
+
+
+=head2 Linker Options
+
+=over
+
+=back
+
+
 =head1 ENVIRONMENT
 
-FIXME: Fill in environment.
+No environment variables read.
 
 =head1 BUGS
 
-It is inconceivable that Clang may have a bug.
+Clang currently does not have C++ support, and this manual page is incomplete.
+To report bugs, please visit L<http://llvm.org/bugs/>.  Most bug reports should
+include preprocessed source files (use the B<-E> option) along with information
+to reproduce.
 
 =head1 SEE ALSO
 
-FIXME: See also?
+as(1), ld(1)
 
 =head1 AUTHOR
 
-- 
2.40.0