compile(): `func_type` mode is not documented

In 2019, compile() got a new mode="func_type" used to parse the signature of a function as AST:

• commit dcfcd146f8e6fc5c2fc16a4c192a0c5f5ca8c53c
• issue gh-79947

>>> compile('() -> int', '<string>', 'func_type', flags=ast.PyCF_ONLY_AST)
FunctionType(argtypes=[], returns=Name(id='int', ctx=Load()))

>>> import ast; ast.parse('() -> int', '<string>', 'func_type')
FunctionType(argtypes=[], returns=Name(id='int', ctx=Load()))

It's tested by test_type_comments using ast.parse() function.

The 'func_type' mode is documented in ast.parse() documentation:

In addition, if mode is 'func_type', the input syntax is modified to correspond to PEP 484 “signature type comments”, e.g. (str, int) -> List[str].

But it's not documented in the compile() function documentation. Should it be documented there as well? Maybe at least by redirecting to ast.parse()?

Linked PRs

• gh-153542
• gh-153561

compile() 関数のドキュメントを、issue にリンクされている既存の ast.parse() ドキュメントと比較し、ドキュメント化されていない 'func_type' モードに重点を置いてください。compile() のドキュメントがこのモードを説明するか、ast.parse() の説明へ読者を明確に誘導すれば完了です。開始前に、リンクされている PR gh-153542 と gh-153561 を確認してください。