From owner-freebsd-ports-bugs@FreeBSD.ORG Wed Jun 23 14:01:18 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 5F7D216A4D3 for ; Wed, 23 Jun 2004 14:01:18 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3AF1843D66 for ; Wed, 23 Jun 2004 14:01:18 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) i5NE0f5l041865 for ; Wed, 23 Jun 2004 14:00:41 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i5NE0f5m041864; Wed, 23 Jun 2004 14:00:41 GMT (envelope-from gnats) Resent-Date: Wed, 23 Jun 2004 14:00:41 GMT Resent-Message-Id: <200406231400.i5NE0f5m041864@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-ports-bugs@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Fernan Aguero Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9224B16A549; Wed, 23 Jun 2004 13:50:44 +0000 (GMT) Received: from smtp.unsam.edu.ar (smtp.unsam.edu.ar [170.210.48.3]) by mx1.FreeBSD.org (Postfix) with ESMTP id E1C7543D39; Wed, 23 Jun 2004 13:50:42 +0000 (GMT) (envelope-from fernan@pi.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 i5NDmnX8070545; Wed, 23 Jun 2004 10:48:49 -0300 (ART) (envelope-from fernan@pi.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 i5NDjRlk016551; Wed, 23 Jun 2004 10:45:27 -0300 (ART) (envelope-from fernan@pi.iib.unsam.edu.ar) Received: (from fernan@localhost) by pi.iib.unsam.edu.ar (8.12.11/8.12.11/Submit) id i5NDjQXA016550; Wed, 23 Jun 2004 10:45:26 -0300 (ART) (envelope-from fernan) Message-Id: <200406231345.i5NDjQXA016550@pi.iib.unsam.edu.ar> Date: Wed, 23 Jun 2004 10:45:26 -0300 (ART) From: Fernan Aguero To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 cc: freebsd-doc@FreeBSD.org cc: marcus@FreeBSD.org Subject: 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 14:01:18 -0000 >Number: 68241 >Category: ports >Synopsis: portlint suggest the use of undocumented macros >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-ports-bugs >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Jun 23 14:00:40 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Fernan Aguero >Release: FreeBSD 4.10-RELEASE i386 >Organization: IIB-UNSAM >Environment: FreeBSD pi.iib.unsam.edu.ar 4.10-RELEASE FreeBSD 4.10-RELEASE #0: Wed May 26 12:56:43 ART 2004 fernan@pi.iib.unsam.edu.ar:/usr/obj/usr/src/sys/PI i386 >Description: 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. A Google search only gets me example cases where it is used, but no explanation of where are this macros defined. The only described expansions documented in pkg_create(1) (the place where the packing list format is documented) are %F, %D, %B, and %f. I'm sending copies to the portlint maintainer (also one of its authors), and to docs@. >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: