]> git.baikalelectronics.ru Git - kernel.git/commit
kernel-doc: properly document array arguments of function
authorGabriel Krisman Bertazi <krisman@collabora.co.uk>
Mon, 9 Jan 2017 20:11:57 +0000 (18:11 -0200)
committerJonathan Corbet <corbet@lwn.net>
Fri, 13 Jan 2017 17:53:24 +0000 (10:53 -0700)
commit302a909d6687dec64422dce5582197f016a94fad
tree2bc4c134cdccbe4231530a268d7f9fc4b036a51d
parentb7f9b02c0a51d086b9ed28b76198e2ae3db5fd1e
kernel-doc: properly document array arguments of function

Documentation for array parameters passed in a function, like the first
argument in the function below, weren't getting exported in the rst
format, although they work fine for html and pdf formats:

  void drm_clflush_pages(struct page * pages[], unsigned long num_pages)

That's because the string key to store the description in the
parameterdescs dictionary doesn't have the [] suffix.  This cleans up
the suffix from the key before accessing the dictionary.

Signed-off-by: Gabriel Krisman Bertazi <krisman@collabora.co.uk>
Fixes: 8b1a296fd2f9 ("kernel-doc: produce RestructuredText output")
Reviewed-by: Jani Nikula <jani.nikula@intel.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
scripts/kernel-doc