bug#25976: man page version is outdated in Guix 0.12.0 tarball

bug#25976: man page version is outdated in Guix 0.12.0 tarball

[Alex Vong]

[-- Attachment #1: Type: text/plain, Size: 303 bytes --]

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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 832 bytes --]

bug#25976: man page version is outdated in Guix 0.12.0 tarball

[Mathieu Lirzin]

Hi Alex,

Alex Vong <alexvong1995@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

bug#25976: man page version is outdated in Guix 0.12.0 tarball

[Ludovic Courtès]

Hi,

Mathieu Lirzin <mthl@gnu.org> skribis:

> Alex Vong <alexvong1995@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’.

bug#25976: man page version is outdated in Guix 0.12.0 tarball

[Mathieu Lirzin]

ludo@gnu.org (Ludovic Courtès) writes:

> Hi,
>
> Mathieu Lirzin <mthl@gnu.org> skribis:
>
>> Alex Vong <alexvong1995@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

bug#25976: man page version is outdated in Guix 0.12.0 tarball

[Ludovic Courtès]

Mathieu Lirzin <mthl@gnu.org> skribis:

> ludo@gnu.org (Ludovic Courtès) writes:
>
>> Hi,
>>
>> Mathieu Lirzin <mthl@gnu.org> skribis:
>>
>>> Alex Vong <alexvong1995@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’.

bug#25976: man page version is outdated in Guix 0.12.0 tarball

[Ludovic Courtès]

ludo@gnu.org (Ludovic Courtès) skribis:

> Mathieu Lirzin <mthl@gnu.org> skribis:
>
>> ludo@gnu.org (Ludovic Courtès) writes:
>>
>>> Hi,
>>>
>>> Mathieu Lirzin <mthl@gnu.org> skribis:
>>>
>>>> Alex Vong <alexvong1995@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’.

bug#25976: man page version is outdated in Guix 0.12.0 tarball

[Ricardo Wurmus]

Ludovic Courtès <ludo@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