I did an "GENTOO_SRCDIR=/usr/gentoo-src emerge gentoo-web" to install a local copy of the gentoo web site, then an "emerge boa" to install boa-0.94.11-r2. I edited /etc/boa/boa.conf to have Port 8080 and DocumentRoot /www/virtual/www.gentoo.org/htdocs. Pointing galeon at http://localhost:8080 brings up my local gentoo page just fine. Clicking on "About Gentoo Linux" works fine, as does clicking on any of the "Recent Gentoo Linux news" items. In fact, "http://localhost:8080/news/" gives me a listing of the news entries. Clicking on any of the "User Doc" entries, though, gives a 404 Not Found. Entering "http://localhost:8080/doc/" reveals the problem, as what's listed is the contents of /usr/share/doc, which isn't at all what I'd had in mind (and also not at all below the DocumentRoot). Huh?!
There is an alias for /doc which points to /usr/share/doc Simply remove the alias. Note that this behavior is consistent with Aliases being devirtualized before consulting the file system, which is a design consideration, and the same consideration made by all other httpds I have consulted.
