From owner-freebsd-ports-bugs@FreeBSD.ORG Wed Jun 23 15:00:46 2004 Return-Path: Delivered-To: freebsd-ports-bugs@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6353816A4CF for ; Wed, 23 Jun 2004 15:00:46 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 55E4A43D31 for ; Wed, 23 Jun 2004 15:00:46 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) i5NF0jOV050118 for ; Wed, 23 Jun 2004 15:00:45 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i5NF0j7J050117; Wed, 23 Jun 2004 15:00:45 GMT (envelope-from gnats) Date: Wed, 23 Jun 2004 15:00:45 GMT Message-Id: <200406231500.i5NF0j7J050117@freefall.freebsd.org> To: freebsd-ports-bugs@FreeBSD.org From: Fernan Aguero Subject: Re: ports/68241: portlint suggest the use of undocumented macros X-BeenThere: freebsd-ports-bugs@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Fernan Aguero List-Id: Ports bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 23 Jun 2004 15:00:46 -0000 The following reply was made to PR ports/68241; it has been noted by GNATS. From: Fernan Aguero To: Dag-Erling =?iso-8859-1?Q?Sm=F8rgrav?= Cc: FreeBSD-gnats-submit@FreeBSD.org, freebsd-doc@FreeBSD.org, marcus@FreeBSD.org Subject: Re: ports/68241: portlint suggest the use of undocumented macros Date: Wed, 23 Jun 2004 11:48:48 -0300 +----[ Dag-Erling Smørgrav (23.Jun.2004 11:32): | | Fernan Aguero writes: | > Upon running portlint -a I get messages like the following: | > WARN: /home/fernan/.../pkg-plist [21]: consider using DOCSDIR macro | > WARN: /home/fernan/.../pkg-plist: %%PORTDOCS%%@dirrm %%DOCSDIR%% is missing | > | > The use of these macros is not documented in the Porter's | > Handbook, nor on the portlint(1) man page. | | http://www.freebsd.org/doc/en/books/porters-handbook/dads-documentation.html | | DES | -- | Dag-Erling Smørgrav - des@des.no | +----] Oh I see. The problem is that I was expecting to find something like this here: http://www.freebsd.org/doc/en/books/porters-handbook/porting-plist.html There is a mention here to PLIST_SUB and how setting VAR=VALUE pairs would make %%VAR%% be substituted with VALUE in the pkg-plist. But it seems that DOCSDIR should not be used like this. That was what confused me from the examples I saw: no one set PLIST_SUB+= DOCSDIR=${DOCSDIR} So, IMO, the problem is that there is a link in 'dads-documentation.html' pointing to 'porting-plist.html' ("See more on pkg-plist substitution __here__"). But not the other way around. Perhaps it could be helpful to have a link added in 'dads-documentation.html'? Maybe before starting to talk about when this substitution takes place ("This substitution (as well as addition ..."), as an addition to the previous paragraph?. Thanks for the pointer, and sorry for the noise. Fernan -- F e r n a n A g u e r o http://genoma.unsam.edu.ar/~fernan