driver: core: Improve documentation for fwnode_operations.add_links()
authorSaravana Kannan <saravanak@google.com>
Fri, 11 Oct 2019 19:15:20 +0000 (12:15 -0700)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Thu, 17 Oct 2019 12:57:03 +0000 (05:57 -0700)
commit92df01e3601fe29eb3727a82705eafa6209053f5
treebdf9dbc1734e003af8bfb3f0aa9c339f81fbf861
parentaf1b967af5ffb94aaed5b9b3259349cc2d398fa7
driver: core: Improve documentation for fwnode_operations.add_links()

The add_links() ops shouldn't return on the first failed device link
add. It needs to continue trying to add device links to other suppliers
that are available. The documentation didn't explain WHY this behavior
is necessary. So, update the documentation with an example that explains
why this is necessary.

Signed-off-by: Saravana Kannan <saravanak@google.com>
Link: https://lore.kernel.org/r/20191011191521.179614-3-saravanak@google.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
include/linux/fwnode.h