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>, _______________________________________________ llvm-commits mailing list llvm-commits@cs.uiuc.edu http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits
