adoc

Semi automated conversion, in part because Pandoc is kind of buggy for adoc:

Some of the commands were along the lines:

    for f in *.md; do pandoc --atx-headers --base-header-level=3 -o ${f%.md}.adoc --wrap=none $f; done
    sed -Ei '/\[\[.*\]\]/d' *.adoc
    while read -r f; do cat $f; echo; done <f >g

device-tree.adoc

@@ -0,0 +1,48 @@
+=== Device tree
+
+`platform_device.c` together with its kernel and QEMU forks contains a minimal runnable example.
+
+Good format descriptions:
+
+* https://www.raspberrypi.org/documentation/configuration/device-tree.md
+
+Minimal example
+
+....
+/dts-v1/;
+
+/ {
+    a;
+};
+....
+
+Check correctness with:
+
+....
+dtc a.dts
+....
+
+Separate nodes are simply merged by node path, e.g.:
+
+....
+/dts-v1/;
+
+/ {
+    a;
+};
+
+/ {
+    b;
+};
+....
+
+then `dtc a.dts` gives:
+
+....
+/dts-v1/;
+
+/ {
+        a;
+        b;
+};
+....