• Linus Torvalds's avatar
    Merge tag 'docs/v5.10-1' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media · 54a4c789
    Linus Torvalds authored
    Pull documentation updates from Mauro Carvalho Chehab:
     "A series of patches addressing warnings produced by make htmldocs.
      This includes:
    
       - kernel-doc markup fixes
    
       - ReST fixes
    
       - Updates at the build system in order to support newer versions of
         the docs build toolchain (Sphinx)
    
      After this series, the number of html build warnings should reduce
      significantly, and building with Sphinx 3.1 or later should now be
      supported (although it is still recommended to use Sphinx 2.4.4).
    
      As agreed with Jon, I should be sending you a late pull request by the
      end of the merge window addressing remaining issues with docs build,
      as there are a number of warning fixes that depends on pull requests
      that should be happening along the merge window.
    
      The end goal is to have a clean htmldocs build on Kernel 5.10.
    
      PS. It should be noticed that Sphinx 3.0 is not currently supported,
      as it lacks support for C domain namespaces. Such feature, needed in
      order to document uAPI system calls with Sphinx 3.x, was added only on
      Sphinx 3.1"
    
    * tag 'docs/v5.10-1' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media: (75 commits)
      PM / devfreq: remove a duplicated kernel-doc markup
      mm/doc: fix a literal block markup
      workqueue: fix a kernel-doc warning
      docs: virt: user_mode_linux_howto_v2.rst: fix a literal block markup
      Input: sparse-keymap: add a description for @sw
      rcu/tree: docs: document bkvcache new members at struct kfree_rcu_cpu
      nl80211: docs: add a description for s1g_cap parameter
      usb: docs: document altmode register/unregister functions
      kunit: test.h: fix a bad kernel-doc markup
      drivers: core: fix kernel-doc markup for dev_err_probe()
      docs: bio: fix a kerneldoc markup
      kunit: test.h: solve kernel-doc warnings
      block: bio: fix a warning at the kernel-doc markups
      docs: powerpc: syscall64-abi.rst: fix a malformed table
      drivers: net: hamradio: fix document location
      net: appletalk: Kconfig: Fix docs location
      dt-bindings: fix references to files converted to yaml
      memblock: get rid of a :c:type leftover
      math64.h: kernel-docs: Convert some markups into normal comments
      media: uAPI: buffer.rst: remove a left-over documentation
      ...
    54a4c789
mei.rst 5.89 KB