Make the doxygen setup more user-friendly.

I changed a counter-intuitive default in the build_doxygen.sh script and
added some more lines to a readme file.  However, running the build
script doesn't seem to work out of the box.  The search scripts don't
seem to get set with the right permissions, but I haven't been able to
figure out exactly what's wrong about them.