rebase: Add --pick-note=<command> option

This allows appending arbitrary text after each `pick' action.
Experimental: Record failed pick note command in rebase instruction
Update doc
Use $COMMENT_CHAR instead of #
Factor out add_pick_note
Tests passed