This is how other build systems (e.g. autotools) see the variable, and
cmake's own GNUInstallDirs defines the same. It more clearly describes
what this setting does vs. the ambiguous "sharedir".
This fixes a compilation problem on Debian Squeeze where cmake (2.8.2) seems
to not work well with dependencies across different directories
(/doc and /doc/xx).
CMake was displaying some warnings about a space in argument used for
asciidoc command:
-a date=`date "+%F"`
Warning displayed:
CMake Warning (dev) in doc/en/CMakeLists.txt:
Syntax Warning in cmake code at
/path/to/doc/en/CMakeLists.txt:41:82
Argument not separated from preceding token by whitespace.
This warning is for project developers. Use -Wno-dev to suppress it.