[llvm-commits] CVS: llvm/docs/CommandGuide/llvmc.pod
Reid Spencer
reid at x10sys.com
Thu Jan 4 09:55:26 PST 2007
Changes in directory llvm/docs/CommandGuide:
llvmc.pod updated: 1.12 -> 1.13
---
Log message:
Document this tool as experimental and list its deficiencies.
---
Diffs of the changes: (+28 -3)
llvmc.pod | 31 ++++++++++++++++++++++++++++---
1 files changed, 28 insertions(+), 3 deletions(-)
Index: llvm/docs/CommandGuide/llvmc.pod
diff -u llvm/docs/CommandGuide/llvmc.pod:1.12 llvm/docs/CommandGuide/llvmc.pod:1.13
--- llvm/docs/CommandGuide/llvmc.pod:1.12 Thu Apr 20 09:17:47 2006
+++ llvm/docs/CommandGuide/llvmc.pod Thu Jan 4 11:55:11 2007
@@ -2,7 +2,7 @@
=head1 NAME
-llvmc - The LLVM Compiler Driver
+llvmc - The LLVM Compiler Driver (experimental)
=head1 SYNOPSIS
@@ -12,8 +12,8 @@
B<llvmc> is a configurable driver for invoking other LLVM (and non-LLVM) tools
in order to compile, optimize and link software for multiple languages. For
-those familiar with FSF's B<gcc> tool, it is very similar. B<llvmc> has the
-following goals:
+those familiar with FSF's B<gcc> tool, it is very similar. Please note that
+B<llvmc> is considered an experimental tool. B<llvmc> has the following goals:
=over
@@ -395,6 +395,31 @@
status, pending actions will be discarded and B<llvmc> will return the
same result code as the failing compilation tool.
+=head1 DEFICIENCIES
+
+B<llvmc> is considered an experimental LLVM tool because it has these
+deficiencies:
+
+=over
+
+=item Insufficient support for native linking
+
+Because B<llvm-ld> doesn't handle native linking, neither can B<llvmc>
+
+=item Poor configuration support
+
+The support for configuring new languages, etc. is weak. There are many
+command line configurations that cannot be achieved with the current
+support. Furthermore the grammar is cumbersome for configuration files.
+Please see L<http://llvm.org/PR686> for further details.
+
+=item Does not handle target specific configurations
+
+This is one of the major deficiencies, also addressed in
+L<http://llvm.org/PR686>
+
+=back
+
=head1 SEE ALSO
L<gccas|gccas>, L<gccld|gccld>, L<llvm-as|llvm-as>, L<llvm-dis|llvm-dis>,
More information about the llvm-commits
mailing list