GNU bug report logs - #25976
man page version is outdated in Guix 0.12.0 tarball

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 25976 in the body.
You can then email your comments to 25976 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: Alex Vong <alexvong1995 <at> gmail.com>
To: bug-guix <at> gnu.org
Subject: man page version is outdated in Guix 0.12.0 tarball
Date: Sun, 05 Mar 2017 23:05:22 +0800

[Message part 1 (text/plain, inline)]

Hello,

The man page version in Guix 0.12.0 tarball[0] is outdated. When running

    $ man guix

the name of the man page is

    guix - manual page for guix 0.11.0

I think it was forgotten to be updated during the 0.12.0 release.

[0]: https://alpha.gnu.org/gnu/guix/guix-0.12.0.tar.gz

Cheers,
Alex

[signature.asc (application/pgp-signature, inline)]

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

From: Mathieu Lirzin <mthl <at> gnu.org>
To: Alex Vong <alexvong1995 <at> gmail.com>
Cc: 25976 <at> debbugs.gnu.org
Subject: Re: bug#25976: man page version is outdated in Guix 0.12.0 tarball
Date: Sun, 05 Mar 2017 16:47:48 +0100

Hi Alex,

Alex Vong <alexvong1995 <at> gmail.com> writes:

> The man page version in Guix 0.12.0 tarball[0] is outdated. When running
>
>     $ man guix
>
> the name of the man page is
>
>     guix - manual page for guix 0.11.0
>
> I think it was forgotten to be updated during the 0.12.0 release.
>
> [0]: https://alpha.gnu.org/gnu/guix/guix-0.12.0.tar.gz
>

I think we should add the generated man pages to the
MAINTAINERCLEANFILES Automake variable and document the release process
in a "README-release" file which should contain running 'make
maintainer-clean'.  There is one in Gnulib that could serve as a template:

  http://git.savannah.gnu.org/gitweb/?p=gnulib.git;a=blob;f=top/README-release;h=17f026a2c70de984450e2c662535d991e0d0a0b6;hb=HEAD

I would recommend not distributing it in the tarball however.

Documenting the release process will hopefully help not missing some step.

Thanks for the report.

-- 
Mathieu Lirzin
GPG: F2A3 8D7E EB2B 6640 5761  070D 0ADE E100 9460 4D37

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

From: ludo <at> gnu.org (Ludovic Courtès)
To: Mathieu Lirzin <mthl <at> gnu.org>
Cc: 25976 <at> debbugs.gnu.org, Alex Vong <alexvong1995 <at> gmail.com>
Subject: Re: bug#25976: man page version is outdated in Guix 0.12.0 tarball
Date: Mon, 06 Mar 2017 11:18:42 +0100

Hi,

Mathieu Lirzin <mthl <at> gnu.org> skribis:

> Alex Vong <alexvong1995 <at> gmail.com> writes:
>
>> The man page version in Guix 0.12.0 tarball[0] is outdated. When running
>>
>>     $ man guix
>>
>> the name of the man page is
>>
>>     guix - manual page for guix 0.11.0
>>
>> I think it was forgotten to be updated during the 0.12.0 release.
>>
>> [0]: https://alpha.gnu.org/gnu/guix/guix-0.12.0.tar.gz
>>
>
> I think we should add the generated man pages to the
> MAINTAINERCLEANFILES Automake variable and document the release process
> in a "README-release" file which should contain running 'make
> maintainer-clean'.

The process is currently documented here:

  https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/release.org

Would it work to have ‘distcheck’ depend on ‘maintainer-clean’?  That
would be even better.

Thanks,
Ludo’.

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

From: Mathieu Lirzin <mthl <at> gnu.org>
To: ludo <at> gnu.org (Ludovic Courtès)
Cc: 25976 <at> debbugs.gnu.org, Alex Vong <alexvong1995 <at> gmail.com>
Subject: Re: bug#25976: man page version is outdated in Guix 0.12.0 tarball
Date: Mon, 06 Mar 2017 11:56:52 +0100

ludo <at> gnu.org (Ludovic Courtès) writes:

> Hi,
>
> Mathieu Lirzin <mthl <at> gnu.org> skribis:
>
>> Alex Vong <alexvong1995 <at> gmail.com> writes:
>>
>>> The man page version in Guix 0.12.0 tarball[0] is outdated. When running
>>>
>>>     $ man guix
>>>
>>> the name of the man page is
>>>
>>>     guix - manual page for guix 0.11.0
>>>
>>> I think it was forgotten to be updated during the 0.12.0 release.
>>>
>>> [0]: https://alpha.gnu.org/gnu/guix/guix-0.12.0.tar.gz
>>>
>>
>> I think we should add the generated man pages to the
>> MAINTAINERCLEANFILES Automake variable and document the release process
>> in a "README-release" file which should contain running 'make
>> maintainer-clean'.
>
> The process is currently documented here:
>
>   https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/release.org

Oops I have overlooked that.

> Would it work to have ‘distcheck’ depend on ‘maintainer-clean’?  That
> would be even better.

Unfornately 'maintainer-clean' is removing the current Makefile so it
can't be used as a prerequisite.

I guess we can't do better that just adding a step for 'make
maintainer-clean' before 'make distcheck' in the release documentation.

While reading "doc/release.org" I have realized it doesn't speak about
fetching and committing the latest translations from the Translation Project.

Thanks.

-- 
Mathieu Lirzin
GPG: F2A3 8D7E EB2B 6640 5761  070D 0ADE E100 9460 4D37

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

From: ludo <at> gnu.org (Ludovic Courtès)
To: Mathieu Lirzin <mthl <at> gnu.org>
Cc: 25976 <at> debbugs.gnu.org, Alex Vong <alexvong1995 <at> gmail.com>
Subject: Re: bug#25976: man page version is outdated in Guix 0.12.0 tarball
Date: Mon, 06 Mar 2017 15:45:14 +0100

Mathieu Lirzin <mthl <at> gnu.org> skribis:

> ludo <at> gnu.org (Ludovic Courtès) writes:
>
>> Hi,
>>
>> Mathieu Lirzin <mthl <at> gnu.org> skribis:
>>
>>> Alex Vong <alexvong1995 <at> gmail.com> writes:
>>>
>>>> The man page version in Guix 0.12.0 tarball[0] is outdated. When running
>>>>
>>>>     $ man guix
>>>>
>>>> the name of the man page is
>>>>
>>>>     guix - manual page for guix 0.11.0
>>>>
>>>> I think it was forgotten to be updated during the 0.12.0 release.
>>>>
>>>> [0]: https://alpha.gnu.org/gnu/guix/guix-0.12.0.tar.gz
>>>>
>>>
>>> I think we should add the generated man pages to the
>>> MAINTAINERCLEANFILES Automake variable and document the release process
>>> in a "README-release" file which should contain running 'make
>>> maintainer-clean'.
>>
>> The process is currently documented here:
>>
>>   https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/release.org
>
> Oops I have overlooked that.
>
>> Would it work to have ‘distcheck’ depend on ‘maintainer-clean’?  That
>> would be even better.
>
> Unfornately 'maintainer-clean' is removing the current Makefile so it
> can't be used as a prerequisite.
>
> I guess we can't do better that just adding a step for 'make
> maintainer-clean' before 'make distcheck' in the release documentation.

OK, makes sense.  Could you add it?

> While reading "doc/release.org" I have realized it doesn't speak about
> fetching and committing the latest translations from the Translation Project.

We usually fetch them any time we get a translation update notification
on the mailing list, which I think is equivalent no?

Thanks,
Ludo’.

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

From: ludo <at> gnu.org (Ludovic Courtès)
To: Mathieu Lirzin <mthl <at> gnu.org>
Cc: 25976 <at> debbugs.gnu.org, Alex Vong <alexvong1995 <at> gmail.com>
Subject: Re: bug#25976: man page version is outdated in Guix 0.12.0 tarball
Date: Mon, 06 Mar 2017 22:15:29 +0100

ludo <at> gnu.org (Ludovic Courtès) skribis:

> Mathieu Lirzin <mthl <at> gnu.org> skribis:
>
>> ludo <at> gnu.org (Ludovic Courtès) writes:
>>
>>> Hi,
>>>
>>> Mathieu Lirzin <mthl <at> gnu.org> skribis:
>>>
>>>> Alex Vong <alexvong1995 <at> gmail.com> writes:
>>>>
>>>>> The man page version in Guix 0.12.0 tarball[0] is outdated. When running
>>>>>
>>>>>     $ man guix
>>>>>
>>>>> the name of the man page is
>>>>>
>>>>>     guix - manual page for guix 0.11.0
>>>>>
>>>>> I think it was forgotten to be updated during the 0.12.0 release.
>>>>>
>>>>> [0]: https://alpha.gnu.org/gnu/guix/guix-0.12.0.tar.gz
>>>>>
>>>>
>>>> I think we should add the generated man pages to the
>>>> MAINTAINERCLEANFILES Automake variable and document the release process
>>>> in a "README-release" file which should contain running 'make
>>>> maintainer-clean'.
>>>
>>> The process is currently documented here:
>>>
>>>   https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/release.org
>>
>> Oops I have overlooked that.
>>
>>> Would it work to have ‘distcheck’ depend on ‘maintainer-clean’?  That
>>> would be even better.
>>
>> Unfornately 'maintainer-clean' is removing the current Makefile so it
>> can't be used as a prerequisite.
>>
>> I guess we can't do better that just adding a step for 'make
>> maintainer-clean' before 'make distcheck' in the release documentation.
>
> OK, makes sense.  Could you add it?

Now that I think of it, could it be that Ricardo didn’t have help2man
installed when building the tarball?  Man pages get rebuilt anytime it’s
needed here.

Thanks,
Ludo’.

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

From: Ricardo Wurmus <rekado <at> elephly.net>
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: Mathieu Lirzin <mthl <at> gnu.org>, 25976 <at> debbugs.gnu.org,
 Alex Vong <alexvong1995 <at> gmail.com>
Subject: Re: bug#25976: man page version is outdated in Guix 0.12.0 tarball
Date: Tue, 07 Mar 2017 15:51:36 +0100

Ludovic Courtès <ludo <at> gnu.org> writes:

> Now that I think of it, could it be that Ricardo didn’t have help2man
> installed when building the tarball?  Man pages get rebuilt anytime it’s
> needed here.

This could have been the case.  I don’t usually have it installed.
Sorry for screwing this up!

--
Ricardo

GPG: BCA6 89B6 3655 3801 C3C6  2150 197A 5888 235F ACAC
https://elephly.net

Previous Next

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