Date: Wed, 20 Dec 1995 11:53:28 -0500 (EST) From: Chuck Robey <chuckr@glue.umd.edu> To: Satoshi Asami <asami@cs.berkeley.edu> Cc: thomas@ghpc8.ihf.rwth-aachen.de, FreeBSD-ports@freebsd.org Subject: Re: a kvetch and a proposal Message-ID: <Pine.SUN.3.91.951220114449.3104A-100000@mocha.eng.umd.edu> In-Reply-To: <199512201242.EAA03491@silvia.HIP.Berkeley.EDU>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 20 Dec 1995, Satoshi Asami wrote:
> * Most of the ports could add a post-install target which copies over
> * documentation to PORTDOCSDIR?=$PREFIX/share/doc/$PKGNAME, depending
> * on a make.conf variable like $NOPORTDOCS. This should be off by
> * default, like $NOMANCOMPRESS.
>
> I'd prefer not to have the PKGNAME in there, just the base name ("xv"
> and such) should be fine. We overwrite everthing from the old port,
> not much need to do differently for docs only.
>
> * Unfortunately you can't do this via bsd.port.mk, because different
> * ports have different conventions for keeping their docs, so it
> * complicates a lot of Makefiles and maintainers with many ports will
> * hate you for proposing it :-).
>
> It *is* possible to do it from bsd.port.mk, we can just make it a
> variable that holds a list of files (relative to ${WRKSRC}), as Chuck
> suggested originally.
>
> But I don't see much point in cluttering bsd.port.mk for this, it can
> be handled how compressing manpages or stripping binaries is handled
> now, i.e., in post-install targets.
>
> * I'd vote for it, though it will take a while until the ports
> * are updated.
>
> All we need to do is to agree with the variable name (NOPORTDOCS
> seems reasonable) and I'll put it in the handbook.
>
> By the way, there are some things that *need* to be installed like xv
> licenses, and these should not be conditionalized. On the other hand,
> the postscript manual of xv probably goes to the ".if
> !defined(NOPORTDOCS)" portion.
This is getting long, but I don't want to trim context yet. A couple
more suggestions: I would like PORTDOCSDIR not to be dependent on
$PREFIX, because $PREFIX defaults to switching from /usr/local to
/usr/X11R6, and this seems to be unnecessary fracturing for docs.
Leaving PORTDOCSDIR independent wouldn't make it any harder for someone
to set it anywhere they like, but it would make for one destination, not
two. Second point, I agree on the PKGNAME thing, but what else would you
use, DISTNAME?
Once I see the changes show up in the makefile, I will send in changes on
various makefiles to implement this. I tried hacking bsd.port.mk myself,
but what a nightmare that file is!
>
> Satoshi
>
============================================================================
Chuck Robey chuckr@eng.umd.edu -- I run FreeBSD on n3lxx and Journey2
---------------------------------------------------------------------------
The Dilbert Zone is Dilbert's new WWW home! The area
features never-before-seen original sketches of Dilbert, a photo tour
of Scott Adams' studio, Dilbert Trivia and memorabilia, high
school photos and much more!:
<URL:http://www.unitedmedia.com/comics/dilbert/>;
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.SUN.3.91.951220114449.3104A-100000>