homepage

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author lonetwin
Recipients BreamoreBoy, adam.woodbeck, bethard, chris.jerdonek, dlam, docs@python, eric.araujo, ezio.melotti, georg.brandl, groodt, lonetwin, marcs, sandro.tosi, tshepang, westley.martinez
Date 2014年10月16日.07:18:18
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1413443898.76.0.033412837006.issue11176@psf.upfronthosting.co.za>
In-reply-to
Content
I came here to file a bug against the argparse documentation because reading through the documentation I didn't realize a good usecase for the `epilog` argument to the `ArgumentParser()` class until I started noticing that some commandline tools end with examples of usage.
I found this bug and so thought it would be better to just leave a comment here instead.
I glaced through the submitted patches and noticed that the pizza making example has `epilog="Remember: select a good combination to ensure maximum tastiness` ...which while good, still might not immediately convey the usefulness of the epilog parameter (just IMHO). I think, the example would be better served by something like:
>>> pizza_parser = argparse.ArgumentParser(
... description='Make a pizza out of ingredients and toppings',
... epilog="""Examples: Create a Python Lovers pizza using the command::
... ./makepizz.py spam ham eggs
... """)
Of course this example would then also require passing a formatter_class argument to handle the wrapping ...but in essence the point of my comment is that the examples might be more useful if a 'real-world' usage is demonstrated.
History
Date User Action Args
2014年10月16日 07:18:19lonetwinsetrecipients: + lonetwin, georg.brandl, bethard, ezio.melotti, eric.araujo, sandro.tosi, chris.jerdonek, docs@python, BreamoreBoy, marcs, westley.martinez, tshepang, adam.woodbeck, dlam, groodt
2014年10月16日 07:18:18lonetwinsetmessageid: <1413443898.76.0.033412837006.issue11176@psf.upfronthosting.co.za>
2014年10月16日 07:18:18lonetwinlinkissue11176 messages
2014年10月16日 07:18:18lonetwincreate

AltStyle によって変換されたページ (->オリジナル) /