Skip to content
GitLab
Projects Groups Topics Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
  • Register
  • Sign in
  • L linux
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributor statistics
    • Graph
    • Compare revisions
  • Issues 0
    • Issues 0
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 0
    • Merge requests 0
  • Deployments
    • Deployments
    • Releases
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Commits
  • Issue Boards
Collapse sidebar
  • Kirill Smelkov
  • linux
  • Repository
  • linux
  • scripts
  • kernel-doc
Find file BlameHistoryPermalink
  • Mauro Carvalho Chehab's avatar
    scripts: kernel-doc: use a less pedantic markup for funcs on Sphinx 3.x · e3ad05fe
    Mauro Carvalho Chehab authored Sep 25, 2020
    Unfortunately, Sphinx 3.x parser for c functions is too pedantic:
    
    	https://github.com/sphinx-doc/sphinx/issues/8241
    
    
    
    While it could be relaxed with some configurations, there are
    several corner cases that it would make it hard to maintain,
    and will require teaching conf.py about several macros.
    
    So, let's instead use the :c:macro notation. This will
    produce an output that it is not as nice as currently, but it
    should still be acceptable, and will provide cross-references,
    removing thousands of warnings when building with newer
    versions of Sphinx.
    
    Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
    e3ad05fe
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7