NOPORTDOCS and man/info pages

Chess Griffin chess at chessgriffin.com
Fri Oct 12 07:06:10 PDT 2007


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.  

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

.if defined(NOPORTDOCS)
...
.else
MAN1=	portname.1
INFO=	portname
.endif

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.    
 
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. 
 
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

-- 
Chess Griffin
GPG Public Key:  0x0C7558C3
http://www.chessgriffin.com
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/freebsd-ports/attachments/20071012/4ba2bf93/attachment.pgp


More information about the freebsd-ports mailing list