Commit 0a874b3a authored by Andreas Rottmann's avatar Andreas Rottmann Committed by Stefan Kost
Browse files

Add support for `scope' and `skip' annotations

See <http://bugzilla.gnome.org/show_bug.cgi?id=615550>.
parent f099e17b
......@@ -306,7 +306,10 @@ my %AnnotationDefinition = (
'out' => "Parameter for returning results. Default is <acronym>transfer full</acronym>.",
'transfer container' => "Free data container after the code is done.",
'transfer full' => "Free data after the code is done.",
'transfer none' => "Don't free data after the code is done."
'transfer none' => "Don't free data after the code is done.",
'scope call' => "The callback is valid only during the call to the method.",
'scope async' => "The callback is valid until first called.",
'scope notfied' => "The callback is valid until the GDestroyNotify argument is called."
);
# Create the root DocBook output directory if it doens't exist.
......@@ -3782,7 +3785,7 @@ sub ScanSourceFile {
$symbol = $1;
#print "SECTION DOCS found in source for : '$symbol'\n";
$ignore_broken_returns = 1;
} elsif (m%^\s*([\w:-]*\w)\s*:?\s*$%) {
} elsif (m%^\s*([\w:-]*\w)\s*:?\s*(\([a-z ]+\)\s*)*$%) {
$symbol = $1;
#print "SYMBOL DOCS found in source for : '$symbol'\n";
}
......
......@@ -7,6 +7,8 @@ annotation_nullable
annotation_elementtype
annotation_elementtype_returns
annotation_outparams
annotation_skip
annotation_scope
<SUBSECTION Standard>
<SUBSECTION Private>
</SECTION>
......
......@@ -85,3 +85,25 @@ annotation_outparams (GList **list)
return TRUE;
}
/**
* annotation_skip: (skip)
* @list: a pointer to take a list
*
* Documentation for this function.
*/
void
annotation_skip (GList *list)
{
}
/**
* annotation_scope:
* @callback: (scope async): a callback
* @user_data: data to pass to callback
*
* Documentation for this function.
*/
void
annotation_scope (GCallback *callback, gpointer user_data)
{
}
......@@ -23,5 +23,9 @@ extern GList *annotation_elementtype_returns (void);
extern gboolean annotation_outparams (GList **list);
extern void annotation_skip (GList *list);
extern void annotation_scope (GCallback *callback, gpointer user_data);
#endif // GTKDOC_TESTER_H
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment