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

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 43479 in the body.
You can then email your comments to 43479 AT debbugs.gnu.org in the normal way.

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

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

From: Simon Tournier <zimon.toutoune <at> gmail.com>
To: 43479-done <at> debbugs.gnu.org
Subject: Re: bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“
Date: Thu, 02 Oct 2025 02:58:43 +0200

Hi

Old report: https://issues.guix.gnu.org/issue/43479

On Thu, 17 Sep 2020 at 23:14, zimoun <zimon.toutoune <at> gmail.com> wrote:

>   ./bootstrap
>   ./configure --localstatedir=/var/
>    make info
>
> leads to the error:
>
> Making info in po/guix

[...]

>   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

Well, since I do not intent to work on this… I have not even checked the
current behaviour and it’s 5 years old, I’m closing!

If it’s still an issue, it would be better to start a fresh issue on
Codeberg.

Cheers,
simon

Previous Next

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