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

So sánh tài liệu về hàm compile() với tài liệu ast.parse() hiện có được liên kết trong issue, tập trung vào chế độ 'func_type' chưa được tài liệu hóa. Được xem là hoàn thành khi tài liệu của compile() mô tả chế độ này hoặc chuyển hướng rõ ràng người đọc đến phần giải thích về ast.parse(); hãy kiểm tra các PR được liên kết gh-153542 và gh-153561 trước khi bắt đầu.