Skip to content

Conversation

@martinjaeger
Copy link
Member

Doxygen comments were existing, but they were not rendered anywhere in the docs.

The code is located in the DFU subsystem, but I think it makes sense to document it under storage, next to similar flash-related APIs.

@martinjaeger
Copy link
Member Author

Looks like the doc build fails because there is a struct flash_img_check and a function int flash_img_check(...) with the same name:

/home/runner/work/zephyr/zephyr/doc/_build/src/services/storage/flash_img/flash_img.rst:13:Duplicate C declaration, also defined at services/storage/flash_img/flash_img:13.
Declaration is '.. c:struct:: flash_img_check'.

@carlescufi or @gmarull do you have any idea how to fix this without changing the API?

@zephyrbot zephyrbot added the area: DFU Device Firmware Upgrade label May 10, 2022
@gmarull
Copy link
Member

gmarull commented May 11, 2022

gmarull
gmarull previously approved these changes May 11, 2022
Doxygen comments were existing, but they were not rendered anywhere in
the docs. The code is located under DFU, but I think it makes sense
to document it under storage, next to similar flash-related APIs.

Signed-off-by: Martin Jäger <[email protected]>
@martinjaeger
Copy link
Member Author

Thanks @gmarull for pointing me the right location in the docs. It's working now.

Unfortunately I had a mistake in the regex in the first attempt, so I have to ask you to re-approve.

@martinjaeger martinjaeger added this to the v3.1.0 milestone May 13, 2022
Copy link
Contributor

@mbolivar-nordic mbolivar-nordic left a comment

Choose a reason for hiding this comment

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

LGTM. Will wait for @carlescufi to ACK as the assignee; since this is a docs patch, it can come in after code freeze.

Copy link
Member

@carlescufi carlescufi left a comment

Choose a reason for hiding this comment

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

LGTM, thank you!

@carlescufi carlescufi merged commit 2554f04 into zephyrproject-rtos:main May 15, 2022
@martinjaeger martinjaeger deleted the doc-flash-img branch May 15, 2022 20:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: API Changes to public APIs area: DFU Device Firmware Upgrade area: Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants