Hi Pablo,
On Sun, Sep 08, 2019 at 06:25:05PM +1000, Duncan Roe wrote:
> The C source files all contain doxygen documentation for each defined function
> but this was not appearing in the generated HTML.
> Fix is to move all EXPORT_SYMBOL macro calls to after the function definition.
> Doxygen seems to otherwise forget the documentation on encountering
> EXPORT_SYMBOL which is flagged in the EXCLUDE_SYMBOLS tag in doxygen.cfg.in.
> I encountered this "feature" in doxygen 1.8.9.1 but it still appears to be
> present in 1.8.16
>
> Signed-off-by: Duncan Roe <duncan_roe@xxxxxxxxxxxxxxx>
> ---
> src/attr.c | 70 +++++++++++++++++++++++++++++-----------------------------
> src/callback.c | 4 ++--
> src/nlmsg.c | 40 ++++++++++++++++-----------------
> src/socket.c | 22 +++++++++---------
> 4 files changed, 68 insertions(+), 68 deletions(-)
>
> diff --git a/src/attr.c b/src/attr.c
> index 0359ba9..ca42d3e 100644
> --- a/src/attr.c
> +++ b/src/attr.c
> @@ -35,11 +35,11 @@
> *
> * This function returns the attribute type.
> */
> -EXPORT_SYMBOL(mnl_attr_get_type);
> uint16_t mnl_attr_get_type(const struct nlattr *attr)
> {
> return attr->nla_type & NLA_TYPE_MASK;
> }
> +EXPORT_SYMBOL(mnl_attr_get_type);
>
[...]
Oops! I forgot to say: this is a patch for libmnl.
Cheers ... Duncan.
