media: v4l2-fwnode: Add a deprecation note in the old ACPI parsing example
authorSakari Ailus <sakari.ailus@linux.intel.com>
Tue, 19 Mar 2019 08:07:32 +0000 (04:07 -0400)
committerMauro Carvalho Chehab <mchehab+samsung@kernel.org>
Wed, 20 Mar 2019 10:37:55 +0000 (06:37 -0400)
This is not how ACPI tables are written. Add a deprecation note and refer
to the proper documentation.

Signed-off-by: Sakari Ailus <sakari.ailus@linux.intel.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
drivers/media/v4l2-core/v4l2-fwnode.c

index ccefa55813ade1adbe1ef8b35b68768e94c22630..ea1ed88f9dc82ce4f0890dc852a316a58f21dcac 100644 (file)
@@ -828,7 +828,10 @@ error:
  * underneath the fwnode identified by the previous tuple, etc. until you
  * reached the fwnode you need.
  *
- * An example with a graph, as defined in Documentation/acpi/dsd/graph.txt:
+ * THIS EXAMPLE EXISTS MERELY TO DOCUMENT THIS FUNCTION. DO NOT USE IT AS A
+ * REFERENCE IN HOW ACPI TABLES SHOULD BE WRITTEN!! See documentation under
+ * Documentation/acpi/dsd instead and especially graph.txt,
+ * data-node-references.txt and leds.txt .
  *
  *     Scope (\_SB.PCI0.I2C2)
  *     {