Added on_success docs from Richard

svn path=/trunk/libs/spirit/; revision=84746