svn commit: r360340 - head/www/llgal

[Adam Weinberger]

On 2 Jul, 2014, at 23:11, Vanilla I. Shu <vanilla at FreeBSD.org> wrote:

> URL: http://svnweb.freebsd.org/changeset/ports/360340
> QAT: https://qat.redports.org/buildarchive/r360340/
> 
> ==============================================================================
> --- head/www/llgal/Makefile	Thu Jul  3 02:57:13 2014	(r360339)
> +++ head/www/llgal/Makefile	Thu Jul  3 03:11:21 2014	(r360340)
> @@ -40,13 +39,13 @@ post-configure:
> 	${PERL5} -pi -e 's/ doc_(perl|site|\$$\(INSTALLDIRS\))_install//' ${WRKSRC}/lib/Makefile
> 
> post-install:
> -	${INSTALL_DATA} ${WRKSRC}/llgal.1 ${MAN1PREFIX}/man/man1
> -	${INSTALL_DATA} ${WRKSRC}/llgalrc.5 ${MAN5PREFIX}/man/man5
> -.if !defined(NOPORTDOCS)
> -	@${MKDIR} ${DOCSDIR}
> -	${INSTALL_DATA} ${WRKSRC}/doc/*.html ${DOCSDIR}
> -	${INSTALL_DATA} ${WRKSRC}/doc/llgalrc ${DOCSDIR}
> -	@(cd ${WRKSRC}/doc && ${COPYTREE_SHARE} examples ${DOCSDIR})
> +	${INSTALL_DATA} ${WRKSRC}/llgal.1 ${STAGEDIR}${MAN1PREFIX}/man/man1
> +	${INSTALL_DATA} ${WRKSRC}/llgalrc.5 ${STAGEDIR}${MAN5PREFIX}/man/man5
> +.if ${PORT_OPTIONS:MDOCS}
> +	@${MKDIR} ${STAGEDIR}${DOCSDIR}
> +	${INSTALL_DATA} ${WRKSRC}/doc/*.html ${STAGEDIR}${DOCSDIR}
> +	${INSTALL_DATA} ${WRKSRC}/doc/llgalrc ${STAGEDIR}${DOCSDIR}
> +	@(cd ${WRKSRC}/doc && ${COPYTREE_SHARE} examples ${STAGEDIR}${DOCSDIR})
> .endif

You know, if we are really going to do a giant stage-all-the-things party, we should probably improve the scattered documentation of how to stage properly. There are plenty of changes that have taken place that are not documented anywhere, or are documented unclearly. I submit to you three FAQ’s that will probably help lots of people, two of which are based on changes that never got noted anywhere, not even in /usr/ports/CHANGES:

Q: How do I package empty directories?
A: Just list them in pkg-plist. “@dirrm an/empty/directory”

Q: How do I handle files outside of $PREFIX?
A: Just list them in pkg-plist. “/var/some/filename”

Q: When should I use “.if ${PORT_OPTIONS:MDOCS}” during do-install/post-install?
A: No.

# Adam


-- 
Adam Weinberger
adamw at adamw.org
http://www.adamw.org