bpo-37726: Prefer argparse over getopt in stdlib tutorial (#15052)
diff --git a/Doc/tutorial/stdlib.rst b/Doc/tutorial/stdlib.rst
index e030f8f..f32063e 100644
--- a/Doc/tutorial/stdlib.rst
+++ b/Doc/tutorial/stdlib.rst
@@ -72,10 +72,21 @@
>>> print(sys.argv)
['demo.py', 'one', 'two', 'three']
-The :mod:`getopt` module processes *sys.argv* using the conventions of the Unix
-:func:`getopt` function. More powerful and flexible command line processing is
-provided by the :mod:`argparse` module.
+The :mod:`argparse` module provides a mechanism to process command line arguments.
+It should always be preferred over directly processing ``sys.argv`` manually.
+Take, for example, the below snippet of code::
+
+ >>> import argparse
+ >>> from getpass import getuser
+ >>> parser = argparse.ArgumentParser(description='An argparse example.')
+ >>> parser.add_argument('name', nargs='?', default=getuser(), help='The name of someone to greet.')
+ >>> parser.add_argument('--verbose', '-v', action='count')
+ >>> args = parser.parse_args()
+ >>> greeting = ["Hi", "Hello", "Greetings! its very nice to meet you"][args.verbose % 3]
+ >>> print(f'{greeting}, {args.name}')
+ >>> if not args.verbose:
+ >>> print('Try running this again with multiple "-v" flags!')
.. _tut-stderr: