CR-1700 Fix for OPENDJ-865: Document new upgrade experience
Fix for OPENDJ-533: Config examples should use instances on 2 different hosts, instead of the 2 instances on the same host
Fix for OPENDJ-458: Man pages for common tools shouldn't be the same for tools in server and toolkit
Add missing metadata
Fix for OPENDJ-364: Generated man pages contain too much of the legalnotice
Fix OpenDJ-222: Remove more references to OpenDS. Also update/adds the man-pages for tools.