r9740: documentation additions