[PATCH 1/2] kernel-doc: fix processing nested structs with attributes

2019-09-17 Thread André Almeida
tution will leave at least one whitespace. Signed-off-by: André Almeida --- scripts/kernel-doc | 8 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/scripts/kernel-doc b/scripts/kernel-doc index 6b03012750da..f1faa036ee59 100755 --- a/scripts/kernel-doc +++ b/scripts/kernel-doc

[PATCH 2/2] kernel-doc: add support for ____cacheline_aligned_in_smp attribute

2019-09-17 Thread André Almeida
Subroutine dump_struct uses type attributes to check if the struct syntax is valid. Then, it removes all attributes before using it for output. `cacheline_aligned_in_smp` is an attribute that is not included in both steps. Add it, since it is used by kernel structs. Signed-off-by: André

[PATCH 0/2] kernel-doc: fix bug and improve dump_struct

2019-09-17 Thread André Almeida
ut of "make htmldocs" with and without this patch. No new warning were found and one warning regarding cacheline_aligned_in_smp at include/linux/netdevice.h was removed. Thanks, André André Almeida (2): kernel-doc: fix processing nested structs with attributes kernel-d

Re: [PATCH 1/3] docs: scsi: fix typo

2019-09-11 Thread André Almeida
On 9/11/19 6:10 PM, Joe Perches wrote: > On Wed, 2019-09-11 at 17:37 -0300, André Almeida wrote: >> "Busses" is the third person conjugation of verb "to buss" in the >> present tense. "Buses" is the plural of bus, as in "serial bus". &

[PATCH 3/3] scsi: core: change function comments to kernel-doc style

2019-09-11 Thread André Almeida
Despite of functions being documented they are not in the kernel-doc specification, and could not be included in kernel documentation. Change the style of functions comments to be compliant to the kernel-doc style. Signed-off-by: André Almeida --- drivers/scsi/scsi_lib.c | 166

[PATCH 1/3] docs: scsi: fix typo

2019-09-11 Thread André Almeida
"Busses" is the third person conjugation of verb "to buss" in the present tense. "Buses" is the plural of bus, as in "serial bus". Signed-off-by: André Almeida --- Documentation/driver-api/scsi.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-

[PATCH 2/3] scsi: core: remove trailing whitespaces

2019-09-11 Thread André Almeida
Remove all trailing whitespaces from scsi_lib.c Signed-off-by: André Almeida --- drivers/scsi/scsi_lib.c | 18 +- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/drivers/scsi/scsi_lib.c b/drivers/scsi/scsi_lib.c index 11e64b50497f..8565bee31922 100644 --- a/drivers

[PATCH] sphinx.rst: Add note about code snippets embedded in the text

2019-06-11 Thread André Almeida
There's a paragraph that explains how to create fixed width text block, but it doesn't explains how to create fixed width text inline, although this feature is really used through the documentation. Fix that adding a quick note about it. Signed-off-by: André Almeida --- Documentation