GNU bug report logs - #43479
Generated files ’doc/os-conf-*.texi’ and “make“

Previous Next

To reply to this bug, email your comments to 43479 AT debbugs.gnu.org.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: zimoun <zimon.toutoune <at> gmail.com>
To: bug-guix <at> gnu.org
Subject: Generated files ’doc/os-conf-*.texi’ and “make“
Date: Thu, 17 Sep 2020 23:14:06 +0200

Dear,

The steps:

  ./bootstrap
  ./configure --localstatedir=/var/
   make info

leads to the error:

--8<---------------cut here---------------start------------->8---
Making info in po/guix
make[1]: Entering directory '/home/simon/src/guix/wk/redoc/po/guix'
make[1]: Nothing to be done for 'info'.
make[1]: Leaving directory '/home/simon/src/guix/wk/redoc/po/guix'
Making info in po/packages
make[1]: Entering directory '/home/simon/src/guix/wk/redoc/po/packages'
make[1]: Nothing to be done for 'info'.
make[1]: Leaving directory '/home/simon/src/guix/wk/redoc/po/packages'
make[1]: Entering directory '/home/simon/src/guix/wk/redoc'
make[2]: Entering directory '/home/simon/src/guix/wk/redoc'
make[2]: Leaving directory '/home/simon/src/guix/wk/redoc'
Updating ./doc/version.texi
  MAKEINFO doc/guix.info
./doc/guix.texi:11838: @include: could not find os-config-bare-bones.texi
./doc/guix.texi:11979: @include: could not find os-config-desktop.texi
./doc/guix.texi:11986: @include: could not find os-config-lightweight-desktop.texi
make[1]: *** [Makefile:4146: doc/guix.info] Error 1
make[1]: Leaving directory '/home/simon/src/guix/wk/redoc'
make: *** [Makefile:5115: info-recursive] Error 1
--8<---------------cut here---------------end--------------->8---

because the 3 .texi files have to be generated first; with another
rule.  It seems expected that ‘make info’ builds the manual.

Furthermore, ‘make distclean’ does not remove these files.

Well, I have tried to give a look to the configuration files of ‘make’
but it is a bit obscure to me.


This behaviour, is it expected?  Or do I miss a ’make’ rule?

All the best,
simon

Message #8 received at 43479 <at> debbugs.gnu.org (full text, mbox):

From: Ludovic Courtès <ludo <at> gnu.org>
To: zimoun <zimon.toutoune <at> gmail.com>
Cc: 43479 <at> debbugs.gnu.org
Subject: Re: bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“
Date: Fri, 18 Sep 2020 14:15:05 +0200

Hi,

zimoun <zimon.toutoune <at> gmail.com> skribis:

> The steps:
>
>   ./bootstrap
>   ./configure --localstatedir=/var/
>    make info
>
> leads to the error:
>
> Making info in po/guix
> make[1]: Entering directory '/home/simon/src/guix/wk/redoc/po/guix'
> make[1]: Nothing to be done for 'info'.
> make[1]: Leaving directory '/home/simon/src/guix/wk/redoc/po/guix'
> Making info in po/packages
> make[1]: Entering directory '/home/simon/src/guix/wk/redoc/po/packages'
> make[1]: Nothing to be done for 'info'.
> make[1]: Leaving directory '/home/simon/src/guix/wk/redoc/po/packages'
> make[1]: Entering directory '/home/simon/src/guix/wk/redoc'
> make[2]: Entering directory '/home/simon/src/guix/wk/redoc'
> make[2]: Leaving directory '/home/simon/src/guix/wk/redoc'
> Updating ./doc/version.texi
>   MAKEINFO doc/guix.info
> ./doc/guix.texi:11838: @include: could not find os-config-bare-bones.texi
> ./doc/guix.texi:11979: @include: could not find os-config-desktop.texi
> ./doc/guix.texi:11986: @include: could not find os-config-lightweight-desktop.texi
> make[1]: *** [Makefile:4146: doc/guix.info] Error 1
> make[1]: Leaving directory '/home/simon/src/guix/wk/redoc'
> make: *** [Makefile:5115: info-recursive] Error 1
>
> because the 3 .texi files have to be generated first; with another
> rule.  It seems expected that ‘make info’ builds the manual.

Yeah, it’s complicated; concretely, you have to run ‘make’.

> Furthermore, ‘make distclean’ does not remove these files.

It’s on purpose: those files are part of the distribution (they’re in
the tarball ‘make dist’ creates).

The reason seems to be that:

--8<---------------cut here---------------start------------->8---
# Bundle this file so that makeinfo finds it in out-of-source-tree builds.
BUILT_SOURCES        += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
EXTRA_DIST           += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
MAINTAINERCLEANFILES  = $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
--8<---------------cut here---------------end--------------->8---

Ludo’.

Message #11 received at 43479 <at> debbugs.gnu.org (full text, mbox):

From: zimoun <zimon.toutoune <at> gmail.com>
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: 43479 <at> debbugs.gnu.org
Subject: Re: bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“
Date: Fri, 18 Sep 2020 22:18:51 +0200

On Fri, 18 Sep 2020 at 14:15, Ludovic Courtès <ludo <at> gnu.org> wrote:

> > because the 3 .texi files have to be generated first; with another
> > rule.  It seems expected that ‘make info’ builds the manual.
>
> Yeah, it’s complicated; concretely, you have to run ‘make’.

Well, I am doing for such case: make RET C-c C-c C-c Because the files
are generated at the very beginning.


> > Furthermore, ‘make distclean’ does not remove these files.
>
> It’s on purpose: those files are part of the distribution (they’re in
> the tarball ‘make dist’ creates).

Hum?  Ok.


> The reason seems to be that:
>
> --8<---------------cut here---------------start------------->8---
> # Bundle this file so that makeinfo finds it in out-of-source-tree builds.
> BUILT_SOURCES        += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
> EXTRA_DIST           += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
> MAINTAINERCLEANFILES  = $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
> --8<---------------cut here---------------end--------------->8---

Yah, I have tried to tweak a lot of stuff and it has always failed.
Simon's relationship with configure and Makefile.am: is complicated.
:-)
Well, since these files are only a hard copy of files in
gnu/system/examples/, does it make sense to simply symlink them and
remove the rule?

Cheers,
simon

Message #14 received at 43479 <at> debbugs.gnu.org (full text, mbox):

From: Ludovic Courtès <ludo <at> gnu.org>
To: zimoun <zimon.toutoune <at> gmail.com>
Cc: 43479 <at> debbugs.gnu.org
Subject: Re: bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“
Date: Sat, 19 Sep 2020 11:35:02 +0200

zimoun <zimon.toutoune <at> gmail.com> skribis:

>> The reason seems to be that:
>>
>> --8<---------------cut here---------------start------------->8---
>> # Bundle this file so that makeinfo finds it in out-of-source-tree builds.
>> BUILT_SOURCES        += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
>> EXTRA_DIST           += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
>> MAINTAINERCLEANFILES  = $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
>> --8<---------------cut here---------------end--------------->8---
>
> Yah, I have tried to tweak a lot of stuff and it has always failed.
> Simon's relationship with configure and Makefile.am: is complicated.
> :-)
> Well, since these files are only a hard copy of files in
> gnu/system/examples/, does it make sense to simply symlink them and
> remove the rule?

You can try, but the comment above about out-of-source-tree builds
suggests it won’t work.  :-)

(That’s because .info is treated specially; namely, Info files are part
of the distribution, so they are always built in the source tree.)

Ludo’.

Message #17 received at 43479 <at> debbugs.gnu.org (full text, mbox):

From: zimoun <zimon.toutoune <at> gmail.com>
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: 43479 <at> debbugs.gnu.org
Subject: Re: bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“
Date: Fri, 25 Sep 2020 15:43:10 +0200

Hi,

On Sat, 19 Sep 2020 at 11:35, Ludovic Courtès <ludo <at> gnu.org> wrote:
> zimoun <zimon.toutoune <at> gmail.com> skribis:
>
>>> The reason seems to be that:
>>>
>>> --8<---------------cut here---------------start------------->8---
>>> # Bundle this file so that makeinfo finds it in out-of-source-tree builds.
>>> BUILT_SOURCES        += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
>>> EXTRA_DIST           += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
>>> MAINTAINERCLEANFILES  = $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
>>> --8<---------------cut here---------------end--------------->8---
>>
>> Yah, I have tried to tweak a lot of stuff and it has always failed.
>> Simon's relationship with configure and Makefile.am: is complicated.
>> :-)
>> Well, since these files are only a hard copy of files in
>> gnu/system/examples/, does it make sense to simply symlink them and
>> remove the rule?
>
> You can try, but the comment above about out-of-source-tree builds
> suggests it won’t work.  :-)

Symbolic links do not work. :-)
Hard links fix my problem, but I am not sure that what we want.

> (That’s because .info is treated specially; namely, Info files are part
> of the distribution, so they are always built in the source tree.)

One easy fix is to add a copy in ‘./bootstrap’.  Yes, it is
unsatisfactory because a modification of
gnu/system/examples/<whatever>.tmpl will not regenerate the correct file
in doc/; note it is already the case now –if I understand correctly.


Cheers,
simon

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.