man pages not automatically built

[Ergosys]

Using the 1.2.3 source branch (0c939b57d3d3) with an out-of-source build on Mint LMDE, the man page build is not integrated into cmake, leading to an install error:

$> su -c 'make install' root
   [snip]
running /sbin/ldconfig 2>&1
CMake Error at man/cmake_install.cmake:36 (FILE):
  file INSTALL cannot find
  "/home/work/extern/mosquitto/man/mosquitto_passwd.1".
Call Stack (most recent call first):
  cmake_install.cmake:49 (INCLUDE)
make: *** [install] Error 1

It was necessary to run make in the "man" directory of the source tree in order to clear up the error.
In addition, it was necessary to install the package "docbook-xsl" in order to manually build the manpages, this doesn't seem to be listed anywhere as a dependency.
Ideally, the man page generation should be part of the cmake build, and also work for out-of-source builds.

[Roger Light (roger.light)]

Thanks for the report. The cmake build files only exist for building on Windows and Mac, on Linux the bog standard make files give better results, particularly for the client libraries. That's very unlikely to change in the future.

docbook-xsl isn't listed as a dependency anywhere because the man pages are always built as part of a release, so the problem you see isn't apparent for most people. It's not something that could be easily fixed either unfortunately, because the package has different names on different platforms and installs the required files to different locations. Building man pages is basically limited to debian based systems.

I can see that it would benefit from some more documentation to make this all a bit clearer.

[Ergosys (ergosys)]

Sorry about the noise then. The "compiling" section on the website is
completely blank, but I noticed the CMakelist.txt and went ahead with it.
 I assumed this is the way the package was built for all systems, that has
been my experience with other packages that use cmake.

On Thu, Nov 14, 2013 at 1:45 PM, Roger Light <email address hidden> wrote:

> Thanks for the report. The cmake build files only exist for building on
> Windows and Mac, on Linux the bog standard make files give better
> results, particularly for the client libraries. That's very unlikely to
> change in the future.
>
> docbook-xsl isn't listed as a dependency anywhere because the man pages
> are always built as part of a release, so the problem you see isn't
> apparent for most people. It's not something that could be easily fixed
> either unfortunately, because the package has different names on
> different platforms and installs the required files to different
> locations. Building man pages is basically limited to debian based
> systems.
>
> I can see that it would benefit from some more documentation to make
> this all a bit clearer.
>
> --
> You received this bug notification because you are subscribed to the bug
> report.
> https://bugs.launchpad.net/bugs/1251386
>
> Title:
> man pages not automatically built
>
> To manage notifications about this bug go to:
> https://bugs.launchpad.net/mosquitto/+bug/1251386/+subscriptions
>

[Roger Light (roger.light)]

That's ok, it's good to hear what needs improving.