gh-102304: doc: Add links to Stable ABI and Limited C API (#105345)

* Add "limited-c-api" and "stable-api" references.
* Rename "stable-abi-list" reference to "limited-api-list".
* Makefile: Document files regenerated by "make regen-limited-abi"
* Remove first empty line in generated files:

  - Lib/test/test_stable_abi_ctypes.py
  - PC/python3dll.c
This commit is contained in:
Victor Stinner 2023-06-06 10:40:32 +02:00 committed by GitHub
parent 00d73caf80
commit bae415ad02
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
17 changed files with 58 additions and 42 deletions

View file

@ -183,7 +183,7 @@ def generator(var_name, default_path):
def gen_python3dll(manifest, args, outfile):
"""Generate/check the source for the Windows stable ABI library"""
write = partial(print, file=outfile)
content = f"""
content = f"""\
/* Re-export stable Python ABI */
/* Generated by {SCRIPT_NAME} */
@ -267,8 +267,8 @@ def gen_doc_annotations(manifest, args, outfile):
def gen_ctypes_test(manifest, args, outfile):
"""Generate/check the ctypes-based test for exported symbols"""
write = partial(print, file=outfile)
write(textwrap.dedent('''
# Generated by Tools/scripts/stable_abi.py
write(textwrap.dedent(f'''\
# Generated by {SCRIPT_NAME}
"""Test that all symbols of the Stable ABI are accessible using ctypes
"""
@ -341,7 +341,7 @@ def gen_ctypes_test(manifest, args, outfile):
def gen_testcapi_feature_macros(manifest, args, outfile):
"""Generate/check the stable ABI list for documentation annotations"""
write = partial(print, file=outfile)
write('// Generated by Tools/scripts/stable_abi.py')
write(f'// Generated by {SCRIPT_NAME}')
write()
write('// Add an entry in dict `result` for each Stable ABI feature macro.')
write()