From owner-freebsd-ports Wed Dec 20 09:07:38 1995 Return-Path: owner-ports Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id JAA01746 for ports-outgoing; Wed, 20 Dec 1995 09:07:38 -0800 (PST) Received: from chemserv.umd.edu (chemserv.umd.edu [129.2.64.40]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id JAA01721 for ; Wed, 20 Dec 1995 09:07:33 -0800 (PST) Received: from mocha.eng.umd.edu (mocha.eng.umd.edu [129.2.98.16]) by chemserv.umd.edu (8.7.3/8.7) with ESMTP id LAA17275; Wed, 20 Dec 1995 11:53:30 -0500 (EST) Received: (chuckr@localhost) by mocha.eng.umd.edu (8.7.3/8.6.4) id LAA04040; Wed, 20 Dec 1995 11:53:29 -0500 (EST) Date: Wed, 20 Dec 1995 11:53:28 -0500 (EST) From: Chuck Robey X-Sender: chuckr@mocha.eng.umd.edu To: Satoshi Asami cc: thomas@ghpc8.ihf.rwth-aachen.de, FreeBSD-ports@freebsd.org Subject: Re: a kvetch and a proposal In-Reply-To: <199512201242.EAA03491@silvia.HIP.Berkeley.EDU> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-ports@freebsd.org Precedence: bulk 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!: