parser = argparse.ArgumentParser(prog='script.py', description=func.__doc__,
    formatter_class=argparse.RawDescriptionHelpFormatter)
parser.add_argument('-f', '--foo', type=float, default=1, help=
    'default: %(default)s')
parser.add_argument('-b', '--bar', action='store_false', help=
    'default: %(default)s')
Библиотека арки Python: сохранить форматирование строки документации в справочном сообщении