From mboxrd@z Thu Jan 1 00:00:00 1970 From: Lukas Wunner Subject: [PATCH 0/2] Device links documentation Date: Sun, 4 Dec 2016 13:10:04 +0100 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: iommu-bounces-cunTk1MwBs9QetFLy7KEm3xJsTq8ys+cHZ5vskTnxNA@public.gmane.org Errors-To: iommu-bounces-cunTk1MwBs9QetFLy7KEm3xJsTq8ys+cHZ5vskTnxNA@public.gmane.org To: "Rafael J. Wysocki" , Greg Kroah-Hartman , Jonathan Corbet , Silvio Fricke Cc: Ulf Hansson , Tomasz Figa , Grant Likely , Andrzej Hajda , Laurent Pinchart , Hanjun Guo , Lars-Peter Clausen , Kevin Hilman , Mauro Carvalho Chehab , iommu-cunTk1MwBs9QetFLy7KEm3xJsTq8ys+cHZ5vskTnxNA@public.gmane.org, Krzysztof Kozlowski , Christoph Hellwig , linux-samsung-soc-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, Kukjin Kim , Geert Uytterhoeven , Alan Stern , Arnd Bergmann , Bartlomiej Zolnierkiewicz , Inki Dae , Mark Brown , g@mail.linuxfoundation.org, Tomeu Vizoso , Dmitry Torokhov List-Id: iommu@lists.linux-foundation.org Here's my suggestion for initial documentation on the device links feature that's queued for 4.10 on Greg KH's driver-core-next branch. Please let me know if you have any additions or corrections. To read this in rendered form: http://wunner.de/kernel-doc/core-api/device_link.html Patch [2/2] could go in via driver-core-next, but patch [1/2] would need to go in via docs-next (because the core-api directory doesn't exist yet in driver-core-next). @Jonathan Corbet: Is core-api the right place to put this? An alternative would be Documentation/driver-api, but unlike core-api it contains less prose text but mostly just bare API docs gleaned from kernel-doc. To render the documentation oneself, the device links patches need to be merged from driver-core-next into docs-next. Here's a branch which contains all the necessary bits: https://github.com/l1k/linux/commits/device_links_docs_v1 (The build is currently broken for docs-next, one needs to remove 80211.xml from Documentation/DocBook/Makefile and for some reason $BUILDDIR/cec.h.rst is not found on the first build, but only on the second build.) About half of the documentation was distilled from the mailing list discussion initiated by Luis Rodriguez after KS/LPC: https://lkml.org/lkml/2016/11/7/790 https://lkml.org/lkml/2016/11/7/795 https://lkml.org/lkml/2016/11/8/899 The other half is based on the first draft I posted in September: https://lkml.org/lkml/2016/9/27/215 Thanks, Lukas Lukas Wunner (2): Documentation/core-api/device_link: Add initial documentation driver core: Silence device links sphinx warning Documentation/core-api/device_link.rst | 279 +++++++++++++++++++++++++++++++++ Documentation/core-api/index.rst | 8 + drivers/base/core.c | 4 +- include/linux/device.h | 1 + 4 files changed, 290 insertions(+), 2 deletions(-) create mode 100644 Documentation/core-api/device_link.rst -- 2.10.2