[CMake] Current documentation and module standards

[Brandon Van Every]

On 7/25/07, Hendrik Sattler <post at hendrik-sattler.de> wrote:
> Hi,
>
> Reading through the updated
> http://www.cmake.org/HTML/Documentation.html, there are several
> problems:
> 1.
> UsePkgConfig is not marked deprecated. One may get the idea that both
> FindPkgConfig and UsePkgConfig are needed.

Please file that in the bug tracker http://cmake.org/Bug as a "Content" bug.

> 6.
> For FIND_PACKAGE, major.minor is undocumented.

Ditto.

> http://www.cmake.org/HTML/WritingCMakeLists.html:
> - It states inclusion with "INCLUDE
> (${CMAKE_ROOT}/Modules/FindTCL.cmake)" instead of using "FIND_PACKAGE
> ( TCL )".
> - The second last line on that page suggests usage of SUBDIRS although
> the documentation says to use ADD_SUBDIRECTORY instead.

Ditto.

> http://www.cmake.org/HTML/RunningCMake.html:
> - That first screenshot is really old. It should be updated. The text
> above that should be updated, too, as there are currently much more
> generators available.

Ditto.  And similarly for any other missing documentation you notice.

Cheers,
Brandon Van Every