[vlc-commits] commit: one way to save [OUT] param comments (Jean Brouwers )

[git at videolan.org]

vlc/python | branch: master | Jean Brouwers <MrJean1 at Gmail.com> | Tue Dec  7 21:42:41 2010 -0800| [f4ab7c70a721db77aa1f17fa5205506086046f3a] | committer: Olivier Aubert 

one way to save [OUT] param comments

Signed-off-by: Olivier Aubert <olivier.aubert at liris.cnrs.fr>

> http://git.videolan.org/gitweb.cgi/vlc/python.git/?a=commit;h=f4ab7c70a721db77aa1f17fa5205506086046f3a
---

 generate.py |    6 +++++-
 1 files changed, 5 insertions(+), 1 deletions(-)

diff --git a/generate.py b/generate.py
index 3e49b21..04e1f4b 100755
--- a/generate.py
+++ b/generate.py
@@ -78,6 +78,7 @@ _blacklist = {
 _NA_     = 'N/A'
 _NL_     = '\n'  # os.linesep
 _OUT_    = '[OUT]'
+_PNTR_   = 'pointer to get the '  # KLUDGE: see @param ... [OUT]
 _INDENT_ = '    '
 
 # special keywords in header.py
@@ -250,7 +251,10 @@ class Func(_Source):
                           .splitlines():
             if '@param' in t:
                 if _OUT_ in t:
-                    t = at_param_re.findall(t)[0][0]
+                    if _PNTR_ in t:  # KLUDGE: name plus purpose
+                        t = t.replace(_OUT_, '').replace(_PNTR_, '')
+                    else:  # keep just the name
+                        t = at_param_re.findall(t)[0][0]
                     o.append(t.replace('@param', '').strip())
                     c = ['']  # drop continuation line(s)
                 else: