note package.env in bashrc docs

diff --git a/man/portage.5 b/man/portage.5
index d659871c5b421d0078940e5f0c7f2e34a672a510..3b288649193c0921bbc0e9b9b6ccefb3184b4d66 100644 (file)
--- a/man/portage.5
+++ b/man/portage.5
@@ -699,7 +699,10 @@ masters = gentoo kde
 .TP
 .BR /etc/portage/env/
 .RS
-In this directory additional package-specific bashrc files can be created.
+In this directory additional package\-specific bashrc files can be created.
+Note that if package\-specific environment variable settings are all that's
+needed, then \fB/etc/portage/package.env\fR should be used instead of the
+bashrc approach that is described here.
 Portage will source all of them after \fB/etc/portage/bashrc\fR in the following
 order:
 .nr step 1 1