From owner-freebsd-ports@FreeBSD.ORG  Thu Jun 12 12:36:56 2003
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
Delivered-To: freebsd-ports@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 617B237B404
	for <ports@freebsd.org>; Thu, 12 Jun 2003 12:36:56 -0700 (PDT)
Received: from haggis.it.ca (haggis.it.ca [216.126.86.9])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 5E88543FCB
	for <ports@freebsd.org>; Thu, 12 Jun 2003 12:36:55 -0700 (PDT)
	(envelope-from paul@haggis.it.ca)
Received: from haggis.it.ca (paul@localhost [127.0.0.1])
	by haggis.it.ca (8.12.9/8.12.9) with ESMTP id h5CJaMVD073727;
	Thu, 12 Jun 2003 15:36:23 -0400 (EDT)
	(envelope-from paul@haggis.it.ca)
Received: (from paul@localhost)
	by haggis.it.ca (8.12.9/8.12.6/Submit) id h5CJaMEf073725;
	Thu, 12 Jun 2003 15:36:22 -0400 (EDT)
	(envelope-from paul)
Date: Thu, 12 Jun 2003 15:36:22 -0400
From: Paul Chvostek <paul+fbsd@it.ca>
To: Clement Laforet <sheepkiller@cultdeadsheep.org>
Message-ID: <20030612193622.GA68410@mail.it.ca>
References: <20030612185429.GA17904@mail.it.ca>
	<20030612212009.46193029.sheepkiller@cultdeadsheep.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20030612212009.46193029.sheepkiller@cultdeadsheep.org>
User-Agent: Mutt/1.4.1i
cc: ports@freebsd.org
Subject: Re: changes to the original source...
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 12 Jun 2003 19:36:56 -0000

On Thu, Jun 12, 2003 at 09:20:09PM +0200, Clement Laforet wrote:
> 
> > Also, if the application's man page fails to include gobs of useful
> > information and examples that are available via www, what's the best way
> > to grab content for inclusion in $PREFIX/share/doc/$PKGNAME ?  Should
> > I just punt with fetch, or is there another preferred way to grab
> > additional files to add to $DOCSDIR?
...
> DISTFILES=      ${PORTNAME}-${PORTVERSION}${EXTRACT_SUFX}
> .if !defined(NOPORTDOCS)
> DISTFILES+=     foo-doc.tar.gz
> .endif

Perhaps I should have been more specific.  The default DISTNAME works
fine for source tarball, but the extra documentation is from a URL that
reside outside the directory specified by $MASTER_SITES, i.e. the source
is at http://somehost/${PORTNAME}/${PORTNAME}.${PORTVERSION}.tar.gz but
the extra documentation is at http://somehost/${PORTNAME}.html.  Should
I shrink MASTER_SITES to "http://somehost/" and make DISTFILES include a
directory for what needs it?  That seems wrong....

It's actually looking as if post-extract: would be the best place for a
fetch (it's the first target after $WRKSRC is created).  But if there's
a "right" way to include the file in DISTFILES, I'll do that instead.

> do-install:
> .if !defined(NOPORTDOCS)
> 	@${MKDIR} ${DOCSDIR}
> 	@${INSTALL_DATA} <your file(s)> ${DOCSDIR}
> .endif

Well, yeah, but I was being brief.  ;)

-- 
  Paul Chvostek                                             <paul@it.ca>
  Operations / Abuse / Whatever
  it.canada, hosting and development                   http://www.it.ca/