expand the user manual

- improve example args