[cmake-developers] organizing "concept" documentation (was: RST and documentation)

[Stephen Kelly]

Brad King wrote:
>> * cmake_minumum_required/policies
> 
> This can go in the introduction of the cmake-policies.7 manual page
> and be linked from the cmake_minumum_required command.

Done, but can be expanded more I suppose.

>> * project/languages
>> * cross-compiling/toolchain files etc.
> 
> How about a "cmake-toolchains.7" manual for these two?

Sounds good to me.

>> * find_package/Find modules/Config modules
>> * imported and other pseudo/special targets, and exporting them
> 
> Create a "cmake-packages.7" manual that covers these.  

Ok. I think I'll put the exporting targets section in the below manual 
though.

>> * build targets, various library types, target properties like PIC etc
>> * usage requirements
> 
> I think these all belong in a dedicated manual but I can't think of
> a good name off the top of my head right now.

* cmake-targets.7
* cmake-buildsystem.7  <-- My preference.
* cmake-listsfiles.7
* cmake-outputs.7

Thanks,

Steve.