diff --git a/docs/CommandGuide/llvmc.pod b/docs/CommandGuide/llvmc.pod index 491e1ff7f45..f72101f3e84 100644 --- a/docs/CommandGuide/llvmc.pod +++ b/docs/CommandGuide/llvmc.pod @@ -2,7 +2,7 @@ =head1 NAME -llvmc - The LLVM Compiler Driver +llvmc - The LLVM Compiler Driver (experimental) =head1 SYNOPSIS @@ -12,8 +12,8 @@ B [I] [I...] B 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 tool, it is very similar. B has the -following goals: +those familiar with FSF's B tool, it is very similar. Please note that +B is considered an experimental tool. B has the following goals: =over @@ -395,6 +395,31 @@ will be taken. If one of the compilation tools returns a non-zero status, pending actions will be discarded and B will return the same result code as the failing compilation tool. +=head1 DEFICIENCIES + +B is considered an experimental LLVM tool because it has these +deficiencies: + +=over + +=item Insufficient support for native linking + +Because B doesn't handle native linking, neither can B + +=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 for further details. + +=item Does not handle target specific configurations + +This is one of the major deficiencies, also addressed in +L + +=back + =head1 SEE ALSO L, L, L, L,