[Octave-bug-tracker] [bug #47817] mxe-octave: error while building documentation of dev Octave

[Rik]

Follow-up Comment #2, bug #47817 (project octave):

The problem is that DOCSTRINGS contains documentation for the file
gnuplot_binary.m while DOCSTRINGS-t does not.  This, in turn, is caused by the
fact that the source directory only contains gnuplot_binary.in.  A makefile
action turns the .in file into a .m file but the location of the file is now
in the build directory.

It would seem that this rule in scripts/module.mk needs to be modified.


$(srcdir)/scripts/DOCSTRINGS: $(FCN_FILES) $(GEN_FCN_FILES) |
scripts/$(octave-dirstamp)
        $(AM_V_GEN)rm -f scripts/DOCSTRINGS-t && \
        $(PERL) $(srcdir)/scripts/mkdoc.pl "$(srcdir)" $(FCN_FILES) --
$(GEN_FCN_FILES) > scripts/DOCSTRINGS-t && \
        $(SHELL) $(srcdir)/build-aux/move-if-change scripts/DOCSTRINGS-t $@


The variable GEN_FCN_FILES currently expands to the single file
"scripts/plot/util/gnuplot_binary.m".  It needs to expand to
"$(builddir)/scripts/plot/util/gnuplot_binary.m".  Or the mkdoc.pl script
needs to be modified to take srcdir and builddir arguments.

At any rate, these three changesets look like they might be the proximate
cause of this problem.


changeset:   21673:9631aac4b635
user:        Mike Miller <address@hidden>
date:        Tue May 03 15:11:51 2016 -0700
summary:     build: avoid writing to srcdir unless DOCSTRINGS contents change
(bug #47832)

changeset:   21664:22e7b6ad93b6
user:        John W. Eaton <address@hidden>
date:        Mon May 02 18:26:50 2016 -0400
summary:     * run-octave.in: Look for DOCSTRINGS file in source tree.

changeset:   21653:09c086133228
user:        John W. Eaton <address@hidden>
date:        Thu Apr 28 16:44:38 2016 -0400
summary:     simplify rules for building DOCSTRING files (bug #47745)


I'm adding Mike and jwe to the CC list for this report.



    _______________________________________________________

Reply to this item at:

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

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