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: proper handle @foo->bar() · 346282db
    Mauro Carvalho Chehab authored Apr 14, 2020
    
    
    The pattern @foo->bar() is valid, as it can be used by a
    function pointer inside a struct passed as a parameter.
    
    Right now, it causes a warning:
    
    	./drivers/firewire/core-transaction.c:606: WARNING: Inline strong start-string without end-string.
    
    In this specific case, the kernel-doc markup is:
    
    	/**
    	 * fw_core_remove_address_handler() - unregister an address handler
    	 * @handler: callback
    	 *
    	 * To be called in process context.
    	 *
    	 * When fw_core_remove_address_handler() returns, @handler->callback() is
    	 * guaranteed to not run on any CPU anymore.
    	 */
    
    With seems valid on my eyes. So, instead of trying to hack
    the kernel-doc markup, let's teach it about how to handle
    such things. This should likely remove lots of other similar
    warnings as well.
    
    Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
    Link: https://lore.kernel.org/r/48b46426d7bf6ff7529f20e5718fbf4e9758e62c.1586881715.git.mchehab+huawei@kernel.org
    
    
    Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
    346282db
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7