Camera: Docs XML - allow multiple kinds per section

- When adding a new entry and maintaining ABI, make a new kind if can't be
  semantically part of the last kind. Don't add to the end of an existing
  non-last kind.

- Print generated file names in metadata-generate

(Aside) New sections should also be ended at the end of the root namespace to
  maintain ABI compatibility.

Change-Id: I5df0a701763af3cc91ee6eead4fe9fd423c9aa86
diff --git a/camera/docs/metadata-generate b/camera/docs/metadata-generate
index a9e53d8..38f8ac7 100755
--- a/camera/docs/metadata-generate
+++ b/camera/docs/metadata-generate
@@ -25,12 +25,26 @@
 
 thisdir=$(dirname $(readlink -f $0))
 
+function relpath() {
+    python -c "import os.path; print os.path.relpath('$1', '$PWD')"
+}
+
 function gen_file() {
     local in=$thisdir/$1
     local out=$thisdir/$2
 
     python $thisdir/metadata_parser_xml.py $thisdir/metadata_properties.xml $in > $out
-    return $?
+
+    local succ=$?
+
+    if [[ $succ -eq 0 ]]
+    then
+        echo "OK: Generated $(relpath "$out")"
+    else
+        echo "FAIL: Errors while generating $(relpath "$out")" >& 2
+    fi
+
+    return $succ
 }
 
 $thisdir/metadata-check-dependencies || exit 1