diff options
author | marxin <marxin@138bc75d-0d04-0410-961f-82ee72b054a4> | 2017-05-31 14:08:36 +0000 |
---|---|---|
committer | marxin <marxin@138bc75d-0d04-0410-961f-82ee72b054a4> | 2017-05-31 14:08:36 +0000 |
commit | d0cbc668c8259a841bb63066f87fb909cae8840b (patch) | |
tree | c229959c3b82d51042f83fe3cf9f45ba801a5b29 /contrib/filter_params.py | |
parent | 16ed3c2c49902308fa85a8a122b2390441fc4375 (diff) |
Doxygen: transform ENUM_BITFIELD and comments starting with '/**'.
2017-05-31 Martin Liska <mliska@suse.cz>
* filter_params.py:
Transform ENUM_BITFIELD and comments starting with '/**'
git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@248741 138bc75d-0d04-0410-961f-82ee72b054a4
Diffstat (limited to 'contrib/filter_params.py')
-rw-r--r-- | contrib/filter_params.py | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/contrib/filter_params.py b/contrib/filter_params.py index f94d201bbf8..a82a8d5728c 100644 --- a/contrib/filter_params.py +++ b/contrib/filter_params.py @@ -34,6 +34,11 @@ def filter_src(text): # so that doxygen will parse them. # # Only comments that begin on the left-most column are converted. + # + text = re.sub(r'^/\*\* ', + r'/** @verbatim ', + text, + flags=re.MULTILINE) text = re.sub(r'^/\* ', r'/** @verbatim ', text, @@ -58,6 +63,11 @@ def filter_src(text): r'(\1)', text) + # Replace 'ENUM_BITFIELD(enum_name)' with 'enum enum_name'. + text = re.sub('ENUM_BITFIELD\s*\(([^\)]*)\)', + r'enum \1', + text) + return text class FilteringTests(unittest.TestCase): @@ -81,6 +91,21 @@ class FilteringTests(unittest.TestCase): ' NEXT_LINE\n' ' FINAL_LINE. @endverbatim */\n')) + def test_comment_example_gengtype(self): + self.assert_filters_to( + ('/** Allocate and initialize an input buffer state.\n' + ' * @param file A readable stream.\n' + ' * @param size The character buffer size in bytes. When in doubt, use @c YY_BUF_SIZE.\n' + ' * \n' + ' * @return the allocated buffer state.\n' + ' */'), + ('/** @verbatim Allocate and initialize an input buffer state.\n' + ' * @param file A readable stream.\n' + ' * @param size The character buffer size in bytes. When in doubt, use @c YY_BUF_SIZE.\n' + ' * \n' + ' * @return the allocated buffer state.\n' + ' @endverbatim */')) + def test_oneliner_comment(self): self.assert_filters_to( '/* Returns the string representing CLASS. */\n', @@ -131,6 +156,11 @@ class FilteringTests(unittest.TestCase): 'char *strcpy PARAMS ((char *dest, char *source));\n', 'char *strcpy (char *dest, char *source);\n') + def test_ENUM_BITFIELD(self): + self.assert_filters_to( + ' ENUM_BITFIELD (sym_intent) intent:2;\n', + ' enum sym_intent intent:2;\n') + def act_on_files(argv): for filename in argv[1:]: with open(filename) as f: |