Internships/ProjectIdeas/APIDocumentationGeneration: Difference between revisions
(Created page with "=== API documentation generation === '''Summary:''' Generation of API documentation from doc comments QEMU currently has many functions documented using the GTK-Doc syntax,...") |
|||
| (2 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
=== API documentation generation === | === API documentation generation === | ||
'''Status:''' Gabriel Barreto is working on this project for GSoC. | |||
'''Summary:''' Generation of API documentation from doc comments | '''Summary:''' Generation of API documentation from doc comments | ||
| Line 8: | Line 9: | ||
that generate API documentation from C and Python source code. | that generate API documentation from C and Python source code. | ||
Tasks: | '''Tasks:''' | ||
* Picking a documentation generation tool and syntax (unclear if we should stay with GTK-Doc) | * Picking a documentation generation tool and syntax (unclear if we should stay with GTK-Doc) | ||
* Fixing or converting existing doc comments to the chosen syntax | * Fixing or converting existing doc comments to the chosen syntax | ||
| Line 16: | Line 17: | ||
** Converting existing ad-hoc comments in the code to doc comment syntax | ** Converting existing ad-hoc comments in the code to doc comment syntax | ||
** Add doc comments to existing APIs that are undocumented | ** Add doc comments to existing APIs that are undocumented | ||
'''Links:''' | '''Links:''' | ||
| Line 25: | Line 25: | ||
'''Details:''' | '''Details:''' | ||
* Skill level: beginner | * Skill level: beginner | ||
* Language: C, Python | * Language: C, Python, GNU Make | ||
* Mentor: Eduardo Habkost <ehabkost@redhat.com> ("ehabkost" on IRC) | * Mentor: Eduardo Habkost <ehabkost@redhat.com> ("ehabkost" on IRC) | ||
* Suggested by: Eduardo Habkost | * Suggested by: Eduardo Habkost | ||
Latest revision as of 15:19, 17 May 2019
API documentation generation
Status: Gabriel Barreto is working on this project for GSoC.
Summary: Generation of API documentation from doc comments
QEMU currently has many functions documented using the GTK-Doc syntax, but there is no mechanism to actually generate API documentation from these doc comments. We need build rules that generate API documentation from C and Python source code.
Tasks:
- Picking a documentation generation tool and syntax (unclear if we should stay with GTK-Doc)
- Fixing or converting existing doc comments to the chosen syntax
- Writing build rules to generate the documentation
- Extra tasks, if time allows:
- Improving clarity or formatting of existing doc comments
- Converting existing ad-hoc comments in the code to doc comment syntax
- Add doc comments to existing APIs that are undocumented
Links:
Details:
- Skill level: beginner
- Language: C, Python, GNU Make
- Mentor: Eduardo Habkost <ehabkost@redhat.com> ("ehabkost" on IRC)
- Suggested by: Eduardo Habkost