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

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

--82I3+IH0IqGh5yIs
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?

Many thanks-
Chess

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

--82I3+IH0IqGh5yIs
Content-Type: application/pgp-signature
Content-Disposition: inline

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

iD8DBQFHD3ycKzd9mAx1WMMRAuWaAKCBxorNZMuSNl98OQ7zsaE+BDPS2QCcCmw3
VaLjwHY+uWfpqZ0b/4ReRMc=
=UXU6
-----END PGP SIGNATURE-----

--82I3+IH0IqGh5yIs--



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