Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Best way to disable installation of man pages #16234

Closed
p5pRT opened this issue Nov 9, 2017 · 7 comments
Closed

Best way to disable installation of man pages #16234

p5pRT opened this issue Nov 9, 2017 · 7 comments

Comments

@p5pRT
Copy link

p5pRT commented Nov 9, 2017

Migrated from rt.perl.org#132420 (status was 'resolved')

Searchable as RT132420$

@p5pRT
Copy link
Author

p5pRT commented Nov 9, 2017

From @atoomic

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​:
p5h/perl5demo#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' [ p5h/perl5demo#21 or atoomic/installdocs-man ]

thanks
nicolas

@p5pRT
Copy link
Author

p5pRT commented Nov 10, 2017

From @khwilliamson

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-archive.perl.org/perl5/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​:
p5h/perl5demo#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' [ p5h/perl5demo#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

@p5pRT
Copy link
Author

p5pRT commented Nov 10, 2017

The RT System itself - Status changed from 'new' to 'open'

@p5pRT
Copy link
Author

p5pRT commented Nov 10, 2017

From @jkeenan

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-archive.perl.org/perl5/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​:
p5h/perl5demo#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' [
p5h/perl5demo#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.

@p5pRT
Copy link
Author

p5pRT commented Nov 10, 2017

From @atoomic

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-archive.perl.org/perl5/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​:
p5h/perl5demo#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' [
p5h/perl5demo#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.

@p5pRT
Copy link
Author

p5pRT commented Nov 13, 2017

From @atoomic

Tux provided a nice commit to solve that issue via a36b903
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​:

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-archive.perl.org/perl5/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​:
p5h/perl5demo#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' [
p5h/perl5demo#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.

@p5pRT
Copy link
Author

p5pRT commented Nov 13, 2017

@atoomic - Status changed from 'open' to 'resolved'

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant