firewire: core: correct documentation of fw_csr_string() kernel API
authorTakashi Sakamoto <o-takashi@sakamocchi.jp>
Thu, 1 Feb 2024 11:53:18 +0000 (20:53 +0900)
committerTakashi Sakamoto <o-takashi@sakamocchi.jp>
Thu, 1 Feb 2024 11:53:18 +0000 (20:53 +0900)
Against its current description, the kernel API can accepts all types of
directory entries.

This commit corrects the documentation.

Cc: stable@vger.kernel.org
Fixes: 3c2c58cb33b3 ("firewire: core: fw_csr_string addendum")
Link: https://lore.kernel.org/r/20240130100409.30128-2-o-takashi@sakamocchi.jp
Signed-off-by: Takashi Sakamoto <o-takashi@sakamocchi.jp>
drivers/firewire/core-device.c

index 0547253d16fe5dc5f606a34035473de7f271acf6..e4cb5106fb7d1fc50106585fbb7ad97ed2d98972 100644 (file)
@@ -118,10 +118,9 @@ static int textual_leaf_to_string(const u32 *block, char *buf, size_t size)
  * @buf:       where to put the string
  * @size:      size of @buf, in bytes
  *
- * The string is taken from a minimal ASCII text descriptor leaf after
- * the immediate entry with @key.  The string is zero-terminated.
- * An overlong string is silently truncated such that it and the
- * zero byte fit into @size.
+ * The string is taken from a minimal ASCII text descriptor leaf just after the entry with the
+ * @key. The string is zero-terminated. An overlong string is silently truncated such that it
+ * and the zero byte fit into @size.
  *
  * Returns strlen(buf) or a negative error code.
  */