[gnuastro-devel] [bug #48124] make clean will remove the man pages when srcdir is builddir

[Mohammad Akhlaghi]

URL:
  <http://savannah.gnu.org/bugs/?48124>

                 Summary: make clean will remove the man pages when srcdir is
builddir
                 Project: GNU Astronomy Utilities
            Submitted by: makhlaghi
            Submitted on: Sat 04 Jun 2016 08:32:11 PM JST
                Category: All Gnuastro
                Severity: 4 - Important
              Item Group: Documentation
                  Status: In Progress
                 Privacy: Public
             Assigned to: makhlaghi
             Open/Closed: Open
         Discussion Lock: Any

    _______________________________________________________

Details:

If Gnuastro is built within the source directory (the most common installation
method), then if the user runs `make clean' (not uncommon), the man-page of
all the utilities is going to be removed. If they don't have help2man (which
is only listed as a dependency of bootstrapping), then the man pages are not
going to be built and thus installed on the system. 

The reason the man pages are removed with `make clean' is that we wanted to be
able to run "make -jN" (N>1) on N threads. To do that successfully it was
necessary to explicitly tell Make that the man pages depend on the executable
so the manpage would not be made before the executable. However as explained
in the Errors with distclean
<https://www.gnu.org/software/automake/manual/html_node/Errors-with-distclean.html>
section of the Automake manual, this would cause problems with `make
distclean' (used in `make distcheck'). 

I am now working on a solution for this problem by building all the utility
man pages in the `doc/' directory which is built after all the other
subdirectories thus allowing us to be sure that the executables are already
built.




    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?48124>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/