--- man/ebuild.5.orig	2005-10-27 12:41:19.119828160 +0200
+++ man/ebuild.5.orig	2005-10-27 13:08:32.735480832 +0200
@@ -336,6 +336,16 @@ 
 For example, blackdown-jdk and sun-jdk provide \fIvirtual/jdk\fR.  This
 allows for packages to depend on \fIvirtual/jdk\fR rather than on blackdown
 or sun specifically.
+.TP
+\fBHTMLDOC_DIR\fR = \fI"relative/path/to/html/documentation"\fR
+This optionnal variable should only be used for packages which provides HTML 
+documentation in a non-standard installation path. This paths should be 
+relative to \fI/usr/share/doc\fR anyway, and standard paths are 
+\fI{$PN,$PF}/{html,HTML}\fR. If your package (\fIlibfoobar-1.1-r2\fR) installs 
+documentation in, for instance, \fI/usr/share/doc/libfoobar-1.1-r2/refmanual\fR, 
+then you should set \fBHTMLDOC_DIR\fR=\fI"${PF}/refmanual"\fR. This way, you allow users
+who have set \fBDOC_SYMLINKS_DIR\fR in their \fImake.conf\fR to keep a symlink on this 
+doc, at a bookmarkable location which won't change across ebuild bumps.
 .SH "PORTAGE DECLARATIONS"
 .TP
 .B inherit