a word about thrad safety; linking to first entry in doxygen if there are multiple; some more link fixes
