From owner-freebsd-doc@FreeBSD.ORG Wed Jun 23 13:50:44 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 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) Date: Wed, 23 Jun 2004 10:45:26 -0300 (ART) Message-Id: <200406231345.i5NDjQXA016550@pi.iib.unsam.edu.ar> To: FreeBSD-gnats-submit@freebsd.org From: Fernan Aguero X-send-pr-version: 3.113 X-GNATS-Notify: cc: freebsd-doc@freebsd.org cc: marcus@freebsd.org Subject: portlint suggest the use of undocumented macros X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Fernan Aguero List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 23 Jun 2004 13:50:45 -0000 >Submitter-Id: current-users >Originator: Fernan Aguero >Organization: IIB-UNSAM >Confidential: no >Synopsis: portlint suggest the use of undocumented macros >Severity: non-critical >Priority: low >Category: ports >Class: doc-bug >Release: FreeBSD 4.10-RELEASE i386 >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: