Skip to content

Replace the "goals of Argument Clinic" with a link to PEP 436 #107507

@erlend-aasland

Description

@erlend-aasland

The Argument Clinic howto starts with six paragraphs about the goals of Argument Clinic, mostly repeating the motivation and rationale of PEP-436. Here's a quick run-through of the paragraphs:

  1. AC should take over arg parsing in CPython.
  2. Hand-written arg parsing code is a chore; AC must be easy to use.
  3. AC must generate correct and hopefully fast code; also an outdated section about the possibility of generating tailor made code for various cases.
  4. AC should support all of CPython's "strange parsing behaviours".
  5. AC should provide introspection signatures for builtins.
  6. The last paragraph repeats information present in the tutorial.

Suggesting to remove the whole "The goals of Argument Clinic", and instead provide a short summary (one or two sentences) and link to PEP-436.

Linked PRs

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dir

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions