ports/68241: portlint suggest the use of undocumented macros

[Fernan Aguero]

>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 at 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 at .
	
	
>How-To-Repeat:
	
	
>Fix:

	


>Release-Note:
>Audit-Trail:
>Unformatted: