Thread (55 messages) 55 messages, 5 authors, 2018-10-23

[PATCH v3 1/2] mtd: spi-nor: add support to non-uniform SFDP SPI NOR flash memories

From: Tudor Ambarus <hidden>
Date: 2018-09-17 17:03:27
Also in: lkml

Hi, Boris,

On 09/11/2018 06:40 PM, Tudor Ambarus wrote:
quoted hunk ↗ jump to hunk
diff --git a/drivers/mtd/spi-nor/spi-nor.c b/drivers/mtd/spi-nor/spi-nor.c
[cut]
 /*
I missed to use the opening comment mark for kernel-doc comments: "/**". This
observation applies to all newly introduced function descriptions, in this patch
and in the next as well.
+ * spi_nor_div_by_erase_size() - calculate remainder and update new dividend
+ * @erase:	pointer to a structure that describes a SPI NOR erase type
+ * @dividend:	dividend value
+ * @remainder:	pointer to u32 remainder (will be updated)
+ *
+ * Returns two values: remainder and the new dividend
I should have used "Return: describe the return value" in order to be aligned
with the example from kernel-doc. This also applies to most of the function
descriptions.

[cut]
+/*
+ *spi_nor_init_uniform_erase_map() - Initialize uniform erase map
add a space after that "*"

I will gladly submit a new version if there are no other comments. Please let me
know.

Cheers,
ta
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help