doxygen-bash.sed: updated version from upstream

Author: Damien Nadé

doxygen-bash.sed

@@ -1,4 +1,24 @@
 #!/bin/sed -nf
+##
+##             DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+##                     Version 2, December 2004
+##
+##  Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+##
+##  Everyone is permitted to copy and distribute verbatim or modified
+##  copies of this license document, and changing it is allowed as long
+##  as the name is changed.
+##
+##             DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+##    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+##
+##   0. You just DO WHAT THE FUCK YOU WANT TO.
+##
+##
+## Project Home Page: http://github.com/Anvil/bash-doxygen/
+## Project Author: Damien Nadé <github@livna.org>
+##
+
 /^## \+@fn/{
     :step
     /@param [^ ]\+ .*$/{
@@ -13,15 +33,25 @@
         # Here, we-reinsert param names into the <funcname>()
         s/\(@fn [^(\n]\+\)(\([^(]*\))\(.*\)\(@param \)\([^ \n]\+\(\.\.\.\)\?\)\([^\n]*\)$/\1(\2, \5)\3\4\5\7/
     }
-    / *[a-zA-Z0-9_]\+ *() *{ *$/!{
+    / *\(function \+\)\?[a-z:.A-Z0-9_]\+ *() *{ *$/!{
         N
         b step
     }
+    # Remove optional 'function' keyword (and some extra spaces).
+    s/ *\(function \+\)\?\([a-z:.A-Z0-9_]\+ *() *{\) *$/\2/
+    # Here, we should have @fn (, param1, param2, param3), we remove
+    # the first extra ", ".
     s/\(@fn[^(]\+\)(, /\1(/
-    s/\(@fn \([^(]\+\)(\)\([^)]*\)\().*\)\n\2() {/\1\3\4\n\2(\3) { }/
+    # Remove the function body to avoid interference, and re-introduce
+    # list of parameters in the funcname(<here>).
+    s/\(@fn \([^(]\+\)(\)\([^)]*\)\().*\)\n\2() *{/\1\3\4\n\2(\3) { }/
+    # Replace all '## ' by '//! ' at beginning-of-line.
+    s/\(^\|\n\)##\n/\1\/\/!\n/g
     s/\(^\|\n\)## /\1\/\/! /g
     p
+    b end
 }
+
 /^declare /{
     # The principle is quite easy. For every declare option, we add a
     # keyword into the sed exchange buffer. Once everything is parsed,
@@ -110,6 +140,22 @@
     s/$/;/
     p
     x
+    b end
+}
+
+/^ *export \+[_a-zA-Z]/{
+    s/=/ = /
+    s/\([^;]\) *$/\1;/
+    s/^ *export \+/Exported String /
+    p
+    b end
+}
+
+
+# Delete non doxygen-related lines content, but not the line
+# themselves.
+/^## \|^##$/!{
+     s/^.*$//p
 }
 b end
 
@@ -120,4 +166,4 @@ b declareprint
 
 :end
 # Make all ## lines doxygen-able.
-s/^## /\/\/! /p
+s/^##\( \|$\)/\/\/!\1/p