From owner-freebsd-ports@FreeBSD.ORG  Fri Dec  2 03:30:59 2011
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
Delivered-To: ports@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 7D439106564A;
	Fri,  2 Dec 2011 03:30:59 +0000 (UTC)
	(envelope-from linimon@lonesome.com)
Received: from mail.soaustin.net (pancho.soaustin.net [76.74.250.40])
	by mx1.freebsd.org (Postfix) with ESMTP id 290FD8FC13;
	Fri,  2 Dec 2011 03:30:58 +0000 (UTC)
Received: by mail.soaustin.net (Postfix, from userid 502)
	id BF05A5615B; Thu,  1 Dec 2011 21:30:58 -0600 (CST)
Date: Thu, 1 Dec 2011 21:30:58 -0600
From: Mark Linimon <linimon@lonesome.com>
To: ports@FreeBSD.org
Message-ID: <20111202033058.GA25481@lonesome.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.5.20 (2009-06-14)
Cc: linimon@FreeBSD.org
Subject: CFR: add an example of manually fetching distfiles to Porter's
 Handbook
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.5
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: Fri, 02 Dec 2011 03:30:59 -0000

A few people are getting "creative" again on ways to express this common
need.  AFAIK the following is the best way to do it.  What do people think?

mcl

Index: book.sgml
===================================================================
RCS file: /home/FreeBSD/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.1119
diff -u -r1.1119 book.sgml
--- book.sgml	4 Nov 2011 14:28:43 -0000	1.1119
+++ book.sgml	1 Dec 2011 22:26:38 -0000
@@ -4698,6 +4698,19 @@
 	  <filename>/usr/ports/LEGAL</filename> for every listed distribution
 	  file, describing exactly what the restriction entails.</para>
       </sect2>
+
+      <sect2>
+	<title>Examples</title>
+
+	<para>The preferred way to state "the distfiles for this port must be
+	  fetched manually" is as follows:<programlisting>
+.if !exists(${DISTDIR}/${DISTNAME}${EXTRACT_SUFX})
+IGNORE=         "may not be redistributed because of licensing reasons. Please visit <replaceable>some-website</replaceable> to accept their license and download ${DISTFILES} into ${DISTDIR}"
+.endif</programlisting></para>
+
+	<para>This both informs the user, and sets the proper metadata on
+	  the user's machine for use by automated programs.</para>
+      </sect2>
     </sect1>
 
     <sect1 id="building">

mcl