Skip to content

Sanitize kernel-doc comments#214

Merged
igaw merged 8 commits intolinux-nvme:masterfrom
hreinecke:kdoc
Feb 2, 2022
Merged

Sanitize kernel-doc comments#214
igaw merged 8 commits intolinux-nvme:masterfrom
hreinecke:kdoc

Conversation

@hreinecke
Copy link
Copy Markdown
Collaborator

Run kernel-doc over the source files and update comments to keep sphinx happy.

To keep sphinx happy.

Signed-off-by: Hannes Reinecke <hare@suse.de>
To keep sphinx happy.

Signed-off-by: Hannes Reinecke <hare@suse.de>
To keep sphinx happy.

Signed-off-by: Hannes Reinecke <hare@suse.de>
To keep sphinx happy.

Signed-off-by: Hannes Reinecke <hare@suse.de>
To keep sphinx happy.

Signed-off-by: Hannes Reinecke <hare@suse.de>
To keep sphinx happy.

Signed-off-by: Hannes Reinecke <hare@suse.de>
When configuring with 'meson -Dman=true' sphinx is printing out errors
on the generated libnvme.rst file. This patch fixes up the function
documentations to fixup these warnings.

Signed-off-by: Hannes Reinecke <hare@suse.de>
Regenerate libnvme.rst with 'kernel-doc src/nvme/{filters,ioctl,linux,tree,types,fabrics,util}.h > doc/libnvme.rst'

Signed-off-by: Hannes Reinecke <hare@suse.de>
@igaw
Copy link
Copy Markdown
Collaborator

igaw commented Feb 2, 2022

I think we could add a script for regenerating the doc as we have in nvme-cli. And add a check list what to do before a release. I am going to forget it for sure.

@igaw igaw merged commit 7da9570 into linux-nvme:master Feb 2, 2022
@hreinecke hreinecke deleted the kdoc branch February 2, 2022 11:54
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.

2 participants