Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Put hyperlink to API reference into readme and improve autogen of API mapping table. #425

Merged
merged 9 commits into from Apr 19, 2023

Conversation

fangerer
Copy link
Contributor

Should finally resolve #323 and also improves the auto-generation of the C API - HPy API function mapping table.
The table is now written into the document that contains it (currently docs/porting-guide.rst). The new approach replaces everything between two markers (i.e. .. mark: BEGIN API MAPPING\n and .. mark: END API MAPPING\n).

Previously, I manually merged an auto-generated part of the table with some manually defined mappings. This is now also done by autogen. Therefore, one needs to specify the manual mappings in dict DOC_MANUAL_API_MAPPING(file hpy/tools/autogen/conf.py).

Copy link
Contributor

@hodgestar hodgestar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I left a couple of small comments, but I think this is a step forward on the documentation front. Thank you!

docs/api-reference/index.rst Outdated Show resolved Hide resolved
docs/api-reference/public_api.rst Outdated Show resolved Hide resolved
docs/api-reference/public_api.rst Outdated Show resolved Hide resolved
@fangerer fangerer merged commit e10482c into hpyproject:master Apr 19, 2023
35 checks passed
@fangerer fangerer deleted the fa/doc1 branch April 19, 2023 12:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

What is the actual API?
2 participants