I'd like to see an `examples` option added to argparse.ArgumentParser as found in many man pages.

This could also be done using the `epilog` option, but that misses the "%(proc)s" replacement which makes usage examples like this

  Example usage:
    ./script.py option1 option2

impossible.

Is http://docs.python.org/dev/library/argparse#usage what you want?

Nope. I want an "examples" section, for example from `man git log`:


EXAMPLES
       git log --no-merges
           Show the whole commit history, but skip any merges

       git log v2.6.12.. include/scsi drivers/scsi
           Show all commits since version v2.6.12 that changed any file in the include/scsi or drivers/scsi subdirectories

       ...

%(prog)s is available in epilog:

---------- temp.py ----------
import argparse

epilog = """\
Example usage:
  %(prog)s option1 option2
"""
parser = argparse.ArgumentParser(
    formatter_class=argparse.RawTextHelpFormatter,
    epilog=epilog)
parser.parse_args()
------------------------------
$ python temp.py -h
usage: temp.py [-h]

optional arguments:
  -h, --help  show this help message and exit

Example usage:
  temp.py option1 option2
------------------------------

Did you need more than that?

@Jonas do you wish to follow up on this?