From owner-freebsd-doc@FreeBSD.ORG Wed Jun 23 14:53:31 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DEC8E16A4CE; Wed, 23 Jun 2004 14:53:31 +0000 (GMT) Received: from smtp.unsam.edu.ar (smtp.unsam.edu.ar [170.210.48.3]) by mx1.FreeBSD.org (Postfix) with ESMTP id C653543D2D; Wed, 23 Jun 2004 14:53:29 +0000 (GMT) (envelope-from fernan@iib.unsam.edu.ar) Received: from pi.iib.unsam.edu.ar (pi.iib.unsam.edu.ar [192.168.10.11]) by smtp.unsam.edu.ar (8.12.6/8.12.6) with ESMTP id i5NEqFX8072532; Wed, 23 Jun 2004 11:52:16 -0300 (ART) (envelope-from fernan@iib.unsam.edu.ar) Received: from pi.iib.unsam.edu.ar (localhost.iib.unsam.edu.ar [127.0.0.1]) by pi.iib.unsam.edu.ar (8.12.11/8.12.9) with ESMTP id i5NEmnAo016750; Wed, 23 Jun 2004 11:48:50 -0300 (ART) (envelope-from fernan@iib.unsam.edu.ar) Received: (from fernan@localhost) by pi.iib.unsam.edu.ar (8.12.11/8.12.11/Submit) id i5NEmm8T016749; Wed, 23 Jun 2004 11:48:48 -0300 (ART) (envelope-from fernan@iib.unsam.edu.ar) X-Authentication-Warning: pi.iib.unsam.edu.ar: fernan set sender to fernan@iib.unsam.edu.ar using -f Date: Wed, 23 Jun 2004 11:48:48 -0300 From: Fernan Aguero To: Dag-Erling =?iso-8859-1?Q?Sm=F8rgrav?= Message-ID: <20040623144848.GG14449@iib.unsam.edu.ar> Mail-Followup-To: Fernan Aguero , Dag-Erling =?iso-8859-1?Q?Sm=F8rgrav?= , FreeBSD-gnats-submit@FreeBSD.org, freebsd-doc@FreeBSD.org, marcus@FreeBSD.org References: <200406231345.i5NDjQXA016550@pi.iib.unsam.edu.ar> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: User-Agent: Mutt/1.4.1i cc: freebsd-doc@FreeBSD.org cc: FreeBSD-gnats-submit@FreeBSD.org cc: marcus@FreeBSD.org Subject: Re: ports/68241: portlint suggest the use of undocumented macros X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 23 Jun 2004 14:53:32 -0000 +----[ 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