update manual pages with examples and cross-references