Skip to content

usb subsystem doc not pulling from header doxygen comments #5702

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

Closed
dbkinder opened this issue Jan 16, 2018 · 0 comments
Closed

usb subsystem doc not pulling from header doxygen comments #5702

dbkinder opened this issue Jan 16, 2018 · 0 comments
Assignees
Labels
area: Documentation area: USB Universal Serial Bus bug The issue is a bug, or the PR is fixing a bug priority: low Low impact/importance bug

Comments

@dbkinder
Copy link
Contributor

The usb subsystem documentation in doc/subsystem/usb/usb.rst has API information directly in the .rst file instead of pulling from the doxygen comments (creating an opportunity for doc and header APIs getting out of sync). Doxygen comments need to include a group that can be pulled into the .rst file as is done for Shell API functions in doc/subsystems/shell.rst, for example.

@dbkinder dbkinder added area: Documentation area: USB Universal Serial Bus labels Jan 16, 2018
@nashif nashif added the bug The issue is a bug, or the PR is fixing a bug label Feb 6, 2018
@nashif nashif added this to the v1.11.0 milestone Feb 6, 2018
@nashif nashif added the priority: low Low impact/importance bug label Feb 6, 2018
@carlescufi carlescufi modified the milestones: v1.11.0, v1.12.0 Mar 9, 2018
@nashif nashif removed this from the v1.12.0 milestone Sep 5, 2018
finikorg added a commit to finikorg/zephyr that referenced this issue Sep 11, 2018
Fixes issue with USB subsystem doc not pulling from header
doxygen comments of USB Device Controller code.

Fixes: zephyrproject-rtos#5702

Signed-off-by: Andrei Emeltchenko <[email protected]>
finikorg added a commit to finikorg/zephyr that referenced this issue Sep 11, 2018
Instead of documenting in rst, pull the API from USB Device Core Layer
header.

Fixes: zephyrproject-rtos#5702

Signed-off-by: Andrei Emeltchenko <[email protected]>
@nashif nashif closed this as completed in 1e1b46d Sep 11, 2018
nashif pushed a commit that referenced this issue Sep 11, 2018
Instead of documenting in rst, pull the API from USB Device Core Layer
header.

Fixes: #5702

Signed-off-by: Andrei Emeltchenko <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area: Documentation area: USB Universal Serial Bus bug The issue is a bug, or the PR is fixing a bug priority: low Low impact/importance bug
Projects
None yet
Development

No branches or pull requests

4 participants