Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 12 Oct 2007 10:06:05 -0400
From:      Chess Griffin <chess@chessgriffin.com>
To:        freebsd-ports@freebsd.org
Subject:   NOPORTDOCS and man/info pages
Message-ID:  <20071012140605.GC56248@localhost>

next in thread | raw e-mail | index | archive | help

--JWEK1jqKZ6MHAcjA
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Hello-
I am working on some small cleanup patches to a couple port Makefiles
and had a few questions on how to handle man/info pages. =20

I have come across a couple Makefiles that have something like this in
post-install:

=2Eif defined(NOPORTDOCS)
=2E..
=2Eelse
MAN1=3D	portname.1
INFO=3D	portname
=2Eendif

It's my understanding after reading 5.9, 5.10, and 5.14.4 of the
Porter's Handbook that the man and info page variables should be
listed in the first part of the Makefile, before the .include
<bsd.port.pre.mk> or .include <bsd.port.mk> for example.  It also
states in 5.14.4 that "Note:  NOPORTDOCS only controls additional
documentation installed in DOCSDIR.  It does not apply to standard man
page and info pages."  This statement seems to indicate that the above
snippet would still install the man/info pages even if NOPORTDOCS was
set.   =20
=20
I have also seen where the manpage and info page are then also listed
in pkg-plist, which I gather should not be the case according to 5.9
of the Porter's Handbook.

So, my questions are:

Is the above handling of the man and info pages correct?  It seems the
answer is no, but just thought I would check.

How does one choose not to install man and info pages if NOPORTDOCS
does not apply to them?  I seem to recall that there is a
NO_INSTALL_MANPAGES knob but am not sure if that's the answer or if there
is a NO_INSTALL_INFOPAGES.=20
=20
Is is correct procedure to never include man and info pages in the
pkg-plist like Porter's Handbook states?

Am I way out in left field here?  :-)

Many thanks-
Chess

--=20
Chess Griffin
GPG Public Key:  0x0C7558C3
http://www.chessgriffin.com

--JWEK1jqKZ6MHAcjA
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (FreeBSD)

iD8DBQFHD39NKzd9mAx1WMMRAje7AJ9uw6kVDhEuDVb2OsAXDwi3i3hcrACeNh8E
fURHpcI0WlwpvLRQH4I07xc=
=zbXj
-----END PGP SIGNATURE-----

--JWEK1jqKZ6MHAcjA--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20071012140605.GC56248>