From b186614857dd800cc9e468f289c9849651a5c94f Mon Sep 17 00:00:00 2001
From: JacobCrabill <jacob@flyvoly.com>
Date: Fri, 28 Feb 2020 21:09:58 -0800
Subject: [PATCH] airframes srcparser.py: Allow non-param comments

Add a "@desc" tag that gets ignored by the parameter parser.  This
allows you to add (multi-line) documentation to airframe init files.
---
 Tools/px4airframes/srcparser.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/Tools/px4airframes/srcparser.py b/Tools/px4airframes/srcparser.py
index b10f9b6ba7..771a28de51 100644
--- a/Tools/px4airframes/srcparser.py
+++ b/Tools/px4airframes/srcparser.py
@@ -273,7 +273,7 @@ class SourceParser(object):
     re_remove_dots = re.compile(r'\.+$')
     re_remove_carriage_return = re.compile('\n+')
 
-    valid_tags = set(["url", "maintainer", "output", "arch", "name", "type"])
+    valid_tags = set(["url", "maintainer", "output", "arch", "name", "type", "desc"])
 
     # Order of parameter groups
     priority = {
@@ -394,6 +394,9 @@ class SourceParser(object):
                 airframe_class = tags[tag]
             elif tag == "name":
                 airframe_name = tags[tag]
+            elif tag == "desc":
+                # General documentation - not a parameter to be saved.
+                pass
             elif tag not in self.valid_tags:
                 sys.stderr.write("Aborting due to invalid documentation tag: '%s'\n" % tag)
                 return False