[cfe-commits] r91176 - in /cfe/trunk: examples/PrintFunctionNames/PrintFunctionNames.cpp examples/PrintFunctionNames/README.txt include/clang/Frontend/ASTConsumers.h lib/Frontend/CompilerInstance.cpp utils/TestUtils/pch-test.pl www/analyzer/installation.html www/get_started.html www/hacking.html
Daniel Dunbar
daniel at zuster.org
Fri Dec 11 15:04:36 PST 2009
Author: ddunbar
Date: Fri Dec 11 17:04:35 2009
New Revision: 91176
URL: http://llvm.org/viewvc/llvm-project?rev=91176&view=rev
Log:
Update docs/comments/utils/examples to refer to clang -cc1 instead of clang-cc.
Modified:
cfe/trunk/examples/PrintFunctionNames/PrintFunctionNames.cpp
cfe/trunk/examples/PrintFunctionNames/README.txt
cfe/trunk/include/clang/Frontend/ASTConsumers.h
cfe/trunk/lib/Frontend/CompilerInstance.cpp
cfe/trunk/utils/TestUtils/pch-test.pl
cfe/trunk/www/analyzer/installation.html
cfe/trunk/www/get_started.html
cfe/trunk/www/hacking.html
Modified: cfe/trunk/examples/PrintFunctionNames/PrintFunctionNames.cpp
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/examples/PrintFunctionNames/PrintFunctionNames.cpp?rev=91176&r1=91175&r2=91176&view=diff
==============================================================================
--- cfe/trunk/examples/PrintFunctionNames/PrintFunctionNames.cpp (original)
+++ cfe/trunk/examples/PrintFunctionNames/PrintFunctionNames.cpp Fri Dec 11 17:04:35 2009
@@ -7,8 +7,8 @@
//
//===----------------------------------------------------------------------===//
//
-// Example clang-cc plugin which simply prints the names of all the top-level
-// decls in the input file.
+// Example clang plugin which simply prints the names of all the top-level decls
+// in the input file.
//
//===----------------------------------------------------------------------===//
Modified: cfe/trunk/examples/PrintFunctionNames/README.txt
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/examples/PrintFunctionNames/README.txt?rev=91176&r1=91175&r2=91176&view=diff
==============================================================================
--- cfe/trunk/examples/PrintFunctionNames/README.txt (original)
+++ cfe/trunk/examples/PrintFunctionNames/README.txt Fri Dec 11 17:04:35 2009
@@ -1,4 +1,4 @@
-This is a simple example demonstrating how to use clang-cc's facility for
+This is a simple example demonstrating how to use clang's facility for
providing AST consumers using a plugin.
You will probably need to build clang so that it exports all symbols (disable
@@ -6,5 +6,5 @@
Once the plugin is built, you can run it using:
--
-$ clang-cc -load path/to/PrintFunctionNames.so -plugin=print-fns some-input-file.c
+$ clang -cc1 -load path/to/PrintFunctionNames.so -plugin=print-fns some-input-file.c
--
Modified: cfe/trunk/include/clang/Frontend/ASTConsumers.h
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/include/clang/Frontend/ASTConsumers.h?rev=91176&r1=91175&r2=91176&view=diff
==============================================================================
--- cfe/trunk/include/clang/Frontend/ASTConsumers.h (original)
+++ cfe/trunk/include/clang/Frontend/ASTConsumers.h Fri Dec 11 17:04:35 2009
@@ -94,9 +94,9 @@
bool SyntaxHighlight = true,
bool HighlightMacros = true);
-// PCH generator: generates a precompiled header file; this file can be
-// used later with the PCHReader (clang-cc option -include-pch)
-// to speed up compile times.
+// PCH generator: generates a precompiled header file; this file can be used
+// later with the PCHReader (clang -cc1 option -include-pch) to speed up compile
+// times.
ASTConsumer *CreatePCHGenerator(const Preprocessor &PP,
llvm::raw_ostream *OS,
const char *isysroot = 0);
Modified: cfe/trunk/lib/Frontend/CompilerInstance.cpp
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/lib/Frontend/CompilerInstance.cpp?rev=91176&r1=91175&r2=91176&view=diff
==============================================================================
--- cfe/trunk/lib/Frontend/CompilerInstance.cpp (original)
+++ cfe/trunk/lib/Frontend/CompilerInstance.cpp Fri Dec 11 17:04:35 2009
@@ -95,7 +95,7 @@
return;
}
- (*OS) << "clang-cc command line arguments: ";
+ (*OS) << "clang -cc1 command line arguments: ";
for (unsigned i = 0; i != argc; ++i)
(*OS) << argv[i] << ' ';
(*OS) << '\n';
Modified: cfe/trunk/utils/TestUtils/pch-test.pl
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/utils/TestUtils/pch-test.pl?rev=91176&r1=91175&r2=91176&view=diff
==============================================================================
--- cfe/trunk/utils/TestUtils/pch-test.pl (original)
+++ cfe/trunk/utils/TestUtils/pch-test.pl Fri Dec 11 17:04:35 2009
@@ -1,7 +1,7 @@
#!/usr/bin/perl -w
# This tiny little script, which should be run from the clang
-# directory (with clang-cc in your patch), tries to take each
+# directory (with clang in your patch), tries to take each
# compilable Clang test and build a PCH file from that test, then read
# and dump the contents of the PCH file just created.
use POSIX;
@@ -17,12 +17,12 @@
@files = `ls test/*/*.$suffix`;
foreach $file (@files) {
chomp($file);
- my $code = system("clang-cc -fsyntax-only -x $language $file > /dev/null 2>&1");
+ my $code = system("clang- -fsyntax-only -x $language $file > /dev/null 2>&1");
if ($code == 0) {
print(".");
- $code = system("clang-cc -emit-pch -x $language -o $file.pch $file > /dev/null 2>&1");
+ $code = system("clang -cc1 -emit-pch -x $language -o $file.pch $file > /dev/null 2>&1");
if ($code == 0) {
- $code = system("clang-cc -include-pch $file.pch -x $language -ast-dump /dev/null > /dev/null 2>&1");
+ $code = system("clang -cc1 -include-pch $file.pch -x $language -ast-dump /dev/null > /dev/null 2>&1");
if ($code == 0) {
$passed++;
} elsif (($code & 0xFF) == SIGINT) {
Modified: cfe/trunk/www/analyzer/installation.html
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/www/analyzer/installation.html?rev=91176&r1=91175&r2=91176&view=diff
==============================================================================
--- cfe/trunk/www/analyzer/installation.html (original)
+++ cfe/trunk/www/analyzer/installation.html Fri Dec 11 17:04:35 2009
@@ -87,13 +87,13 @@
<ul>
-<li>The locations of the <tt>clang-cc</tt> and <tt>clang</tt> binaries.
+<li>The location of the <tt>clang</tt> binary.
<p>For example, if you built a <em>Debug</em> build of LLVM/Clang, the
-resultant binaries will be in $(OBJDIR)/Debug (where <tt>$(OBJDIR)</tt>
-is often the same as the root source directory). You can also do
-<tt>make install</tt> to install the LLVM/Clang libaries and binaries to
-the installation directory of your choice (specified when you run
+resultant<tt>clang</tt> binary will be in $(OBJDIR)/Debug
+(where <tt>$(OBJDIR)</tt> is often the same as the root source directory). You
+can also do <tt>make install</tt> to install the LLVM/Clang libaries and
+binaries to the installation directory of your choice (specified when you run
<tt>configure</tt>).</p></li>
<li>The locations of the <tt>scan-build</tt> and <tt>scan-view</tt>
Modified: cfe/trunk/www/get_started.html
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/www/get_started.html?rev=91176&r1=91175&r2=91176&view=diff
==============================================================================
--- cfe/trunk/www/get_started.html (original)
+++ cfe/trunk/www/get_started.html Fri Dec 11 17:04:35 2009
@@ -73,22 +73,12 @@
</ul>
<li>Try it out (assuming you add llvm/Debug/bin to your path):</li>
<ul>
- <li><tt>clang-cc --help</tt></li>
- <li><tt>clang-cc file.c -fsyntax-only</tt> (check for correctness)</li>
- <li><tt>clang-cc file.c -ast-dump</tt> (internal debug dump of ast)</li>
- <li><tt>clang-cc file.c -ast-view</tt> (<a
- href="http://llvm.org/docs/ProgrammersManual.html#ViewGraph">set up graphviz
- and rebuild llvm first</a>)</li>
- <li><tt>clang-cc file.c -emit-llvm</tt> (print out unoptimized llvm code)</li>
- <li><tt>clang-cc file.c -emit-llvm -o - | llvm-as | opt -std-compile-opts |
- llvm-dis</tt> (print out optimized llvm code)</li>
- <li><tt>clang-cc file.c -emit-llvm -o - | llvm-as | opt -std-compile-opts | llc
- > file.s</tt> (output native machine code)</li>
- </ul>
- <p><em>Note</em>: Here <tt>clang-cc</tt> is the "low-level" frontend
- executable that is similar in purpose to <tt>cc1</tt>. Clang also has a <a
- href="#driver">high-level compiler driver</a> that acts as a drop-in
- replacement for <tt>gcc</tt>.
+ <li><tt>clang --help</tt></li>
+ <li><tt>clang file.c -fsyntax-only</tt> (check for correctness)</li>
+ <li><tt>clang file.c -S -emit-llvm -o -</tt> (print out unoptimized llvm code)</li>
+ <li><tt>clang file.c -S -emit-llvm -o - -O3</tt></li>
+ <li><tt>clang file.c -S -O3 -o -</tt> (output native machine code)</li>
+ </ul>
</ol>
<p>Note that the C front-end uses LLVM, but does not depend on llvm-gcc. If you
@@ -159,10 +149,8 @@
<li>Build Clang:</li>
<ul>
<li>Open LLVM.sln in Visual Studio.</li>
- <li>Build the "clang-cc" project for just the compiler front end.
- Alternatively, build the "clang" project for the compiler driver
- (note that the driver is currently broken on Windows),
- or the "ALL_BUILD" project to build everything, including tools.</li>
+ <li>Build the "clang" project for just the compiler driver and front end, or
+ the "ALL_BUILD" project to build everything, including tools.</li>
</ul>
<li>Try it out (assuming you added llvm/debug/bin to your path). (See the
running examples from above.)</li>
@@ -175,13 +163,11 @@
to the latest code base, use the <tt>svn update</tt> command in both the
llvm and llvm\tools\clang directories, as they are separate repositories.</p>
-<a name="driver"><h2>High-Level Compiler Driver (Drop-in Substitute for GCC)</h2></a>
+<a name="driver"><h2>Clang Compiler Driver (Drop-in Substitute for GCC)</h2></a>
-<p>While the <tt>clang-cc</tt> executable is a low-level frontend executable
-that can perform code generation, program analysis, and other actions, it is not
-designed to be a drop-in replacement for GCC's <tt>cc</tt>. For this purpose,
-use the high-level driver, aptly named <tt>clang</tt>. Here are some
-examples of how to use the high-level driver:
+<p>The <tt>clang</tt> tool is the compiler driver and front-end, which is
+designed to be a drop-in replacement for the <tt>gcc</tt> command. Here are
+some examples of how to use the high-level driver:
</p>
<pre class="code">
@@ -201,12 +187,6 @@
<h2>Examples of using Clang</h2>
-<p>The high-level driver <tt>clang</tt> is designed to understand most of GCC's
-options, and the lower-level <tt>clang-cc</tt> executable also directly takes
-many of GCC's options. You can see which options <tt>clang-cc</tt> accepts with
-'<tt>clang-cc --help</tt>'. Here are a few examples of using <tt>clang</tt> and
-<tt>clang-cc</tt>:</p>
-
<!-- Thanks to
http://shiflett.org/blog/2006/oct/formatting-and-highlighting-php-code-listings
Site suggested using pre in CSS, but doesn't work in IE, so went for the <pre>
@@ -251,8 +231,13 @@
<h3>Pretty printing from the AST:</h3>
+<p>Note, the <tt>-cc1</tt> argument indicates the the compiler front-end, and
+not the driver, should be run. The compiler front-end has several additional
+Clang specific features which are not exposed through the GCC compatible driver
+interface.</p>
+
<pre class="code">
-$ <b>clang-cc ~/t.c -ast-print</b>
+$ <b>clang -cc1 ~/t.c -ast-print</b>
typedef float V __attribute__(( vector_size(16) ));
V foo(V a, V b) {
return a + b * a;
@@ -263,25 +248,21 @@
<h3>Code generation with LLVM:</h3>
<pre class="code">
-$ <b>clang-cc ~/t.c -emit-llvm -o - | llvm-as | opt -std-compile-opts | llvm-dis</b>
+$ <b>clang ~/t.c -S -emit-llvm -o -</b>
define <4 x float> @foo(<4 x float> %a, <4 x float> %b) {
entry:
%mul = mul <4 x float> %b, %a
%add = add <4 x float> %mul, %a
ret <4 x float> %add
}
-$ <b>clang-cc ~/t.c -emit-llvm -o - | llvm-as | opt -std-compile-opts | llc -march=ppc32 -mcpu=g5</b>
-..
-_foo:
- vmaddfp v2, v3, v2, v2
- blr
-$ <b>clang-cc ~/t.c -emit-llvm -o - | llvm-as | opt -std-compile-opts | llc -march=x86 -mcpu=yonah</b>
-..
+$ <b>clang -fomit-frame-pointer -O3 -S -o - t.c</b> <i># On x86_64</i>
+...
_foo:
- mulps %xmm0, %xmm1
- addps %xmm0, %xmm1
- movaps %xmm1, %xmm0
- ret
+Leh_func_begin1:
+ mulps %xmm0, %xmm1
+ addps %xmm1, %xmm0
+ ret
+Leh_func_end1:
</pre>
</div>
Modified: cfe/trunk/www/hacking.html
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/www/hacking.html?rev=91176&r1=91175&r2=91176&view=diff
==============================================================================
--- cfe/trunk/www/hacking.html (original)
+++ cfe/trunk/www/hacking.html Fri Dec 11 17:04:35 2009
@@ -176,7 +176,6 @@
correct this. Therefore your output might look something like this:</p>
<tt><pre>lit.py: lit.cfg:152: note: using clang: 'C:/Tools/llvm/bin/Debug\\clang.EXE'
-lit.py: lit.cfg:157: note: using clang-cc: 'C:/Tools/llvm/bin/Debug/clang-cc.exe'
-- Testing: 1723 tests, 2 threads --
FAIL: Clang::(test path) (659 of 1723)
******************** TEST 'Clang::(test path)' FAILED ********************
More information about the cfe-commits
mailing list