[PATCH 0/7] Documentation warning reduction

Jonathan Corbet corbet at lwn.net
Mon Jul 17 21:00:41 UTC 2017


I've come to the conclusion that we really need to make the docs build
quieter.  Here's a small step in that direction: getting rid of all of the
"no structured comments found" warnings.  Such warnings are usually the
result of kerneldoc comments being moved elsewhere, so this took a bit of
git archeology to do; hopefully I got it right.

Each patch stands alone, so if the DRM folks want to carry the last two
themselves, that's fine, just let me know.

Jonathan Corbet (7):
  docs: Get module_init() docs from module.h
  docs: Do not include kerneldoc comments from kernel/sys.c
  docs: Do not include from .../seqno-fence.c
  docs: Get the struct cmbdata kernel doc from the right file
  docs: Do not include from drivers/scsi/constants.c
  docs: Do not include from include/drm/drm_color_mgmt.h
  docs: Use :internal: for include/drm/drm_syncobj.h

 Documentation/driver-api/basics.rst       | 5 +----
 Documentation/driver-api/dma-buf.rst      | 3 ---
 Documentation/driver-api/s390-drivers.rst | 2 +-
 Documentation/driver-api/scsi.rst         | 8 --------
 Documentation/gpu/drm-kms.rst             | 3 ---
 Documentation/gpu/drm-mm.rst              | 2 +-
 6 files changed, 3 insertions(+), 20 deletions(-)

-- 
2.9.4



More information about the dri-devel mailing list