Excise references to the now defunct "analyze" tool. Merge descriptions
where appropriate.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@29931 91177308-0d34-0410-b5e6-96231b3b80d8
diff --git a/docs/CommandGuide/analyze.pod b/docs/CommandGuide/analyze.pod
deleted file mode 100644
index d5eff7a..0000000
--- a/docs/CommandGuide/analyze.pod
+++ /dev/null
@@ -1,75 +0,0 @@
-=pod
-
-=head1 NAME
-
-analyze - LLVM program analyzer
-
-=head1 SYNOPSIS
-
-B<analyze> [I<options>] [I<filename>]
-
-=head1 DESCRIPTION
-
-The B<analyze> command performs various analysis of LLVM assembly
-code or bytecode. It will usually print the results on standard
-output, but in a few cases, it will print output to standard error
-or generate a file with the analysis output, which is usually done
-when the output is meant for another program.
-
-If filename is omitted or is I<->, B<analyze> reads its input from
-standard input. It first attempts to interpret its input as LLVM
-bytecode. If it encounters an error, it then attempts to parse the
-input as LLVM assembly language.
-
-=head1 OPTIONS
-
-=over
-
-=item B<-help>
-
-Print a summary of command line options.
-
-=item B<-q>
-
-Quiet mode. With this option, analysis pass names are not printed.
-
-=item B<-load> I<plugin>
-
-Load the specified dynamic object with name I<plugin>. This file
-should contain additional analysis passes that register themselves
-with the B<analyze> program after being loaded.
-
-After being loaded, additional command line options are made
-available for running the passes made available by I<plugin>. Use
-B<analyze -load> I<plugin> B<-help> to see the new list of available
-analysis passes.
-
-=item B<-profile-info-file> I<filename>
-
-Specify the name of the file loaded by the -profile-loader option.
-
-=item B<-stats>
-
-Print statistics.
-
-=item B<-time-passes>
-
-Record the amount of time needed for each pass and print it to standard
-error.
-
-=back
-
-=head1 EXIT STATUS
-
-If B<analyze> succeeds, it will exit with 0. Otherwise, if an error
-occurs, it will exit with a non-zero value.
-
-=head1 SEE ALSO
-
-L<opt|opt>
-
-=head1 AUTHORS
-
-Maintained by the LLVM Team (L<http://llvm.org>).
-
-=cut
diff --git a/docs/CommandGuide/bugpoint.pod b/docs/CommandGuide/bugpoint.pod
index e9a8e87..56f8395 100644
--- a/docs/CommandGuide/bugpoint.pod
+++ b/docs/CommandGuide/bugpoint.pod
@@ -114,7 +114,7 @@
=head1 SEE ALSO
-L<opt|opt>, L<analyze|analyze>
+L<opt|opt>
=head1 AUTHOR
diff --git a/docs/CommandGuide/index.html b/docs/CommandGuide/index.html
index 22fd85a..349da74 100644
--- a/docs/CommandGuide/index.html
+++ b/docs/CommandGuide/index.html
@@ -51,9 +51,6 @@
<li><a href="html/llvm-link.html"><b>llvm-link</b></a> -
link several bytecode files into one</li>
-<li><a href="html/analyze.html"><b>analyze</b></a> -
- run LLVM analyses on a bytecode file and print the results</li>
-
<li><a href="html/llvm-ar.html"><b>llvm-ar</b></a> -
archive bytecode files</li>
diff --git a/docs/CommandGuide/opt.pod b/docs/CommandGuide/opt.pod
index 6c149b6..4134bfe 100644
--- a/docs/CommandGuide/opt.pod
+++ b/docs/CommandGuide/opt.pod
@@ -10,17 +10,25 @@
=head1 DESCRIPTION
-The B<opt> command is the modular LLVM optimizer. It takes LLVM
-bytecode as input, runs the specified optimizations on it, and then
-outputs the optimized LLVM bytecode.
+The B<opt> command is the modular LLVM optimizer and analyzer. It takes LLVM
+bytecode as input, runs the specified optimizations or analyses on it, and then
+outputs the optimized LLVM bytecode or the analysis results. The function of
+B<opt> depends on whether the B<-analyze> option is given.
-The optimizations available via B<opt> depend upon what libraries
-were linked into it as well as any additional libraries that have
-been loaded with the B<-load> option. Use the B<-help> option to
-determine what optimizations you can use.
+When B<-analyze> is specified, B<opt> performs various analyses of LLVM
+bytecode. It will usually print the results on standard output, but in a few
+cases, it will print output to standard error or generate a file with the
+analysis output, which is usually done when the output is meant for another
+program.
-If no filename is specified on the command line, B<opt> reads its
-input from standard input.
+While B<-analyze> is I<not> given, B<opt> attempts to produce an optimized
+bytecode file. The optimizations available via B<opt> depend upon what
+libraries were linked into it as well as any additional libraries that have
+been loaded with the B<-load> option. Use the B<-help> option to determine
+what optimizations you can use.
+
+If I<filename> is omitted from the command line or is I<->, B<opt> reads its
+input from standard input. The input must be an LLVM bytecode file.
If an output filename is not specified with the B<-o> option, B<opt>
writes its output to the standard output.
@@ -64,10 +72,10 @@
=item B<-load>=I<plugin>
-Load the dynamic object I<plugin>. This object should register new
-optimization passes. Once loaded, the object will add new command line
-options to enable various optimizations. To see the new complete list
-of optimizations, use the B<-help> and B<-load> options together:
+Load the dynamic object I<plugin>. This object should register new optimization
+or analysis passes. Once loaded, the object will add new command line options to
+enable various optimizations or analyses. To see the new complete list of
+optimizations, use the B<-help> and B<-load> options together. For example:
=over
@@ -86,10 +94,6 @@
If B<opt> succeeds, it will exit with 0. Otherwise, if an error
occurs, it will exit with a non-zero value.
-=head1 SEE ALSO
-
-L<analyze|analyze>
-
=head1 AUTHORS
Maintained by the LLVM Team (L<http://llvm.org>).