[PATCH] Document new LLVM CMake interface and emit warning when using llvm_map_components_to_libraries

[Brad King]

On 07/28/2014 08:15 AM, Dan Liew wrote:
> http://llvm.org/docs/Projects.html
> 
> I think the "Embedding LLVM in your project" documentation on using
> LLVM libraries via CMake belongs in here instead. Do you agree?

No.  IIUC that document is for creating projects that may build as
part of LLVM.  The document you've been modifying is about using LLVM
libraries externally in an application that builds separately.

> I was also thinking of mentioning in the docs that libraries come out
> of  llvm_map_components_to_libnames() are imported targets so their
> properties can be read.
> 
> I've not heard anything from Takumi so I might just go ahead and
> 
> - merge these (once the docs are rewritten) into trunk and release_35
> - Add a note to the LLVM 3.5 release notes that
> llvm_map_components_to_libraries is deprecated and
> llvm_map_components_to_libnames
>   should be used instead.

That all sounds good to me.

Thanks,
-Brad