Revision as of 19:37, 16 January 2019

Drafts

I'm saving some drafts here before including it on the wiki page. -Ehabkost (talk) 19:36, 16 January 2019 (UTC)

API documentation generation

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 tools to generate API documentation from C and Python source code.

Links:

Details:

Skill level: beginner
Language: C, Python
Mentor: Eduardo Habkost <ehabkost@redhat.com> ("ehabkost" on IRC)
Suggested by: Eduardo Habkost

Guest ABI automated testing

Summary: Automated test of Guest ABI and compatibility

QEMU tries to provide a stable guest ABI on versioned machine-types. Despite investing lots of effort keeping compatibility, we have no automated testing to detect common bugs that break guest ABI. It should be possible to write automated test cases that will compare a virtual machine to a previously stored dump of guest ABI information, including:

CPUID data
Physical memory and I/O port maps
Device addresses (PCI, USB, etc.)

Links:

TODO
Wiki links to relevant material
External links to mailing lists or web sites

Details:

Skill level: intermediate
Language: C
Mentor: Eduardo Habkost <ehabkost@redhat.com> ("ehabkost" on IRC)
Suggested by: Eduardo Habkost

@@ Line 20: / Line 20: @@
 * Skill level: beginner
 * Language: C, Python
-* Mentor: Eduardo Habkost <ehabkost@redhat.com>, ehabkost
+* Mentor: Eduardo Habkost <ehabkost@redhat.com> ("ehabkost" on IRC)
 * Suggested by: Eduardo Habkost
@@ Line 46: / Line 46: @@
 * Skill level: intermediate
 * Language: C
-* Mentor: Eduardo Habkost
+* Mentor: Eduardo Habkost <ehabkost@redhat.com> ("ehabkost" on IRC)
 * Suggested by: Eduardo Habkost