unofficial mirror of bug-guix@gnu.org 
 help / color / mirror / code / Atom feed
* bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“
@ 2020-09-17 21:14 zimoun
  2020-09-18 12:15 ` Ludovic Courtès
  0 siblings, 1 reply; 5+ messages in thread
From: zimoun @ 2020-09-17 21:14 UTC (permalink / raw)
  To: 43479

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




^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“
  2020-09-17 21:14 bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“ zimoun
@ 2020-09-18 12:15 ` Ludovic Courtès
  2020-09-18 20:18   ` zimoun
  0 siblings, 1 reply; 5+ messages in thread
From: Ludovic Courtès @ 2020-09-18 12:15 UTC (permalink / raw)
  To: zimoun; +Cc: 43479

Hi,

zimoun <zimon.toutoune@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’.




^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“
  2020-09-18 12:15 ` Ludovic Courtès
@ 2020-09-18 20:18   ` zimoun
  2020-09-19  9:35     ` Ludovic Courtès
  0 siblings, 1 reply; 5+ messages in thread
From: zimoun @ 2020-09-18 20:18 UTC (permalink / raw)
  To: Ludovic Courtès; +Cc: 43479

On Fri, 18 Sep 2020 at 14:15, Ludovic Courtès <ludo@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




^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“
  2020-09-18 20:18   ` zimoun
@ 2020-09-19  9:35     ` Ludovic Courtès
  2020-09-25 13:43       ` zimoun
  0 siblings, 1 reply; 5+ messages in thread
From: Ludovic Courtès @ 2020-09-19  9:35 UTC (permalink / raw)
  To: zimoun; +Cc: 43479

zimoun <zimon.toutoune@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’.




^ permalink raw reply	[flat|nested] 5+ messages in thread

* bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“
  2020-09-19  9:35     ` Ludovic Courtès
@ 2020-09-25 13:43       ` zimoun
  0 siblings, 0 replies; 5+ messages in thread
From: zimoun @ 2020-09-25 13:43 UTC (permalink / raw)
  To: Ludovic Courtès; +Cc: 43479

Hi,

On Sat, 19 Sep 2020 at 11:35, Ludovic Courtès <ludo@gnu.org> wrote:
> zimoun <zimon.toutoune@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




^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2020-09-25 14:24 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-09-17 21:14 bug#43479: Generated files ’doc/os-conf-*.texi’ and “make“ zimoun
2020-09-18 12:15 ` Ludovic Courtès
2020-09-18 20:18   ` zimoun
2020-09-19  9:35     ` Ludovic Courtès
2020-09-25 13:43       ` zimoun

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).