Skip Menu |
Report information
Id: 132420
Status: resolved
Priority: 0/
Queue: perl5

Owner: Nobody
Requestors: atoomic [at] cpan.org
Cc:
AdminCc:

Operating System: (no value)
PatchStatus: (no value)
Severity: low
Type: unknown
Perl Version: (no value)
Fixed In: (no value)



Subject: Best way to disable installation of man pages
Download (untitled) / with headers
text/plain 1.2k
We have multiple 'man*dir' Configure options, among them - installman1dir - installsiteman1dir - installvendorman1dir - man1dir - man1direxp - ... but it's unclear from Porting/Glossary which flag (if there is one) can be used to disable installation of man pages. From my understanding, we can set 'prefix path' (inside destdir) and file extension, but I cannot find a way to disable installation of man pages. Following @Tux recommendation I tried setting man1dir="none", but the Config value saved is then the empty string... which result later to use '$destdir/' as the destination to install man pages... I came with something, probably over complex, which adds an extra Configure option to disable installation of man and HTML page: https://github.com/p5h/perl5demo/pull/21 or branch atoomic/installdocs-man in the upstream git repo. I'm not sure it's a good idea to try to give a special meaning to one of the existing "man" variables which are intended to be used as a path and not as a flag... Questions: - what is the recommended way to disable installation of man pages? - if there is none, would you consider the addition of 'installdocs' [ https://github.com/p5h/perl5demo/pull/21 or atoomic/installdocs-man ] thanks nicolas
Subject: Re: [perl #132420] Best way to disable installation of man pages
Date: Thu, 9 Nov 2017 17:35:40 -0700
From: Karl Williamson <public [...] khwilliamson.com>
To: perl5-porters [...] perl.org
Download (untitled) / with headers
text/plain 1.6k
On 11/09/2017 04:48 PM, Nicolas R. (via RT) wrote: Show quoted text
> # New Ticket Created by Nicolas R. > # Please include the string: [perl #132420] > # in the subject line of all future correspondence about this issue. > # <URL: https://rt.perl.org/Ticket/Display.html?id=132420 > > > > We have multiple 'man*dir' Configure options, among them > > - installman1dir > - installsiteman1dir > - installvendorman1dir > - man1dir > - man1direxp > - ... > > but it's unclear from Porting/Glossary which flag (if there is one) can be used to disable installation of man pages.
>>From my understanding, we can set 'prefix path' (inside destdir) and file extension, but I cannot find a way to disable installation of man pages.
> > Following @Tux recommendation I tried setting man1dir="none", but the Config value saved is then the empty string... > which result later to use '$destdir/' as the destination to install man pages... > > I came with something, probably over complex, which adds an extra Configure option to disable installation of man and HTML page: > https://github.com/p5h/perl5demo/pull/21 or branch atoomic/installdocs-man in the upstream git repo. > > I'm not sure it's a good idea to try to give a special meaning to one of the existing "man" variables which are intended to be used as a path and not as a flag... > > Questions: > - what is the recommended way to disable installation of man pages? > - if there is none, would you consider the addition of 'installdocs' [ https://github.com/p5h/perl5demo/pull/21 or atoomic/installdocs-man ] > > thanks > nicolas > >
I figured this way out some time ago and use it: Pass to Configure: -Dman1dir=none -Dman3dir=none
From: James E Keenan <jkeenan [...] pobox.com>
To: perl5-porters [...] perl.org
Subject: Re: [perl #132420] Best way to disable installation of man pages
Date: Thu, 9 Nov 2017 22:33:52 -0500
Download (untitled) / with headers
text/plain 1.8k
On 11/09/2017 07:35 PM, Karl Williamson wrote: Show quoted text
> On 11/09/2017 04:48 PM, Nicolas R. (via RT) wrote:
>> # New Ticket Created by  Nicolas R. >> # Please include the string:  [perl #132420] >> # in the subject line of all future correspondence about this issue. >> # <URL: https://rt.perl.org/Ticket/Display.html?id=132420 > >> >> >> We have multiple 'man*dir' Configure options, among them >> >> - installman1dir >> - installsiteman1dir >> - installvendorman1dir >> - man1dir >> - man1direxp >> - ... >> >> but it's unclear from Porting/Glossary which flag (if there is one) >> can be used to disable installation of man pages.
>>> From my understanding, we can set 'prefix path' (inside destdir) and >>> file extension, but I cannot find a way to disable installation of >>> man pages.
>> >> Following @Tux recommendation I tried setting man1dir="none", but the >> Config value saved is then the empty string... >> which result later to use '$destdir/' as the destination to install >> man pages... >> >> I came with something, probably over complex, which adds an extra >> Configure option to disable installation of man and HTML page: >> https://github.com/p5h/perl5demo/pull/21 or branch >> atoomic/installdocs-man in the upstream git repo. >> >> I'm not sure it's a good idea to try to give a special meaning to one >> of the existing "man" variables which are intended to be used as a >> path and not as a flag... >> >> Questions: >> - what is the recommended way to disable installation of man pages? >> - if there is none, would you consider the addition of 'installdocs' [ >> https://github.com/p5h/perl5demo/pull/21 or atoomic/installdocs-man ] >> >> thanks >> nicolas >> >>
> > I figured this way out some time ago and use it: > Pass to Configure: > -Dman1dir=none -Dman3dir=none
I concur. I use that in my "install_blead_for_testing" scripts, which trace their ancestry in part to khw.
Download (untitled) / with headers
text/plain 2.5k
I'm also using these two flags "-Dman1dir=none -Dman3dir=none" but this is an incomplete solution from my point of view, as hundreds of 'man pages' are still built... during make install and left in place... I would like to have none of them built, or for example, this would require some extra tweak to the rpm spec file I'm using to clear them... whereas I do not even need to generate them at all... The patch I've provided simply disable the makefile target to build & install them when '-Dinstalldocs=0' is set. On Thu, 09 Nov 2017 19:34:02 -0800, jkeenan@pobox.com wrote: Show quoted text
> On 11/09/2017 07:35 PM, Karl Williamson wrote:
> > On 11/09/2017 04:48 PM, Nicolas R. (via RT) wrote:
> >> # New Ticket Created by  Nicolas R. > >> # Please include the string:  [perl #132420] > >> # in the subject line of all future correspondence about this issue. > >> # <URL: https://rt.perl.org/Ticket/Display.html?id=132420 > > >> > >> > >> We have multiple 'man*dir' Configure options, among them > >> > >> - installman1dir > >> - installsiteman1dir > >> - installvendorman1dir > >> - man1dir > >> - man1direxp > >> - ... > >> > >> but it's unclear from Porting/Glossary which flag (if there is one) > >> can be used to disable installation of man pages.
> >>> From my understanding, we can set 'prefix path' (inside destdir) and > >>> file extension, but I cannot find a way to disable installation of > >>> man pages.
> >> > >> Following @Tux recommendation I tried setting man1dir="none", but the > >> Config value saved is then the empty string... > >> which result later to use '$destdir/' as the destination to install > >> man pages... > >> > >> I came with something, probably over complex, which adds an extra > >> Configure option to disable installation of man and HTML page: > >> https://github.com/p5h/perl5demo/pull/21 or branch > >> atoomic/installdocs-man in the upstream git repo. > >> > >> I'm not sure it's a good idea to try to give a special meaning to one > >> of the existing "man" variables which are intended to be used as a > >> path and not as a flag... > >> > >> Questions: > >> - what is the recommended way to disable installation of man pages? > >> - if there is none, would you consider the addition of 'installdocs' [ > >> https://github.com/p5h/perl5demo/pull/21 or atoomic/installdocs-man ] > >> > >> thanks > >> nicolas > >> > >>
> > > > I figured this way out some time ago and use it: > > Pass to Configure: > > -Dman1dir=none -Dman3dir=none
> > I concur. I use that in my "install_blead_for_testing" scripts, which > trace their ancestry in part to khw.
Download (untitled) / with headers
text/plain 2.9k
Tux provided a nice commit to solve that issue via a36b9036e25c58d568c35f764ff2830a9fc4b2f8 using '-Dman1dir=none -Dman3dir=none' will now disable man page installation & compilation closing this ticket On Fri, 10 Nov 2017 07:38:39 -0800, atoomic@cpan.org wrote: Show quoted text
> I'm also using these two flags "-Dman1dir=none -Dman3dir=none" but > this is an incomplete solution from my point of view, > as hundreds of 'man pages' are still built... during make install and > left in place... > > I would like to have none of them built, or for example, this would > require some extra tweak to the rpm spec file I'm using to clear > them... whereas I do not even need to generate them at all... > > The patch I've provided simply disable the makefile target to build & > install them when '-Dinstalldocs=0' is set. > > On Thu, 09 Nov 2017 19:34:02 -0800, jkeenan@pobox.com wrote:
> > On 11/09/2017 07:35 PM, Karl Williamson wrote:
> > > On 11/09/2017 04:48 PM, Nicolas R. (via RT) wrote:
> > >> # New Ticket Created by  Nicolas R. > > >> # Please include the string:  [perl #132420] > > >> # in the subject line of all future correspondence about this > > >> issue. > > >> # <URL: https://rt.perl.org/Ticket/Display.html?id=132420 > > > >> > > >> > > >> We have multiple 'man*dir' Configure options, among them > > >> > > >> - installman1dir > > >> - installsiteman1dir > > >> - installvendorman1dir > > >> - man1dir > > >> - man1direxp > > >> - ... > > >> > > >> but it's unclear from Porting/Glossary which flag (if there is > > >> one) > > >> can be used to disable installation of man pages.
> > >>> From my understanding, we can set 'prefix path' (inside destdir) > > >>> and > > >>> file extension, but I cannot find a way to disable installation > > >>> of > > >>> man pages.
> > >> > > >> Following @Tux recommendation I tried setting man1dir="none", but > > >> the > > >> Config value saved is then the empty string... > > >> which result later to use '$destdir/' as the destination to > > >> install > > >> man pages... > > >> > > >> I came with something, probably over complex, which adds an extra > > >> Configure option to disable installation of man and HTML page: > > >> https://github.com/p5h/perl5demo/pull/21 or branch > > >> atoomic/installdocs-man in the upstream git repo. > > >> > > >> I'm not sure it's a good idea to try to give a special meaning to > > >> one > > >> of the existing "man" variables which are intended to be used as a > > >> path and not as a flag... > > >> > > >> Questions: > > >> - what is the recommended way to disable installation of man > > >> pages? > > >> - if there is none, would you consider the addition of > > >> 'installdocs' [ > > >> https://github.com/p5h/perl5demo/pull/21 or atoomic/installdocs- > > >> man ] > > >> > > >> thanks > > >> nicolas > > >> > > >>
> > > > > > I figured this way out some time ago and use it: > > > Pass to Configure: > > > -Dman1dir=none -Dman3dir=none
> > > > I concur. I use that in my "install_blead_for_testing" scripts, > > which > > trace their ancestry in part to khw.


This service is sponsored and maintained by Best Practical Solutions and runs on Perl.org infrastructure.

For issues related to this RT instance (aka "perlbug"), please contact perlbug-admin at perl.org