After talking with Inaky, I'll update the wiki to reflect the two ways to work around this issue AND update the doxygen.config (gerrit patch submitted: https://gerrit.zephyrproject.org/r/#/c/4741/ )
-- david


From: Kaplan, Amir [mailto:amir.kaplan(a)intel.com]
Sent: Monday, September 12, 2016 8:57 AM
To: Ross, Andrew J <andrew.j.ross(a)intel.com>; devel(a)lists.zephyrproject.org
Subject: [devel] Re: deprecated issue after push to gerrit - need some help

Thanks!

It leads to the same solution as David suggested

I will try it tomorrow

Or I will try Andrew P solution...


There is a command who checks the code in advance:

git show | ./scripts/checkpatch.pl --no-tree -

Any idea why the checking doesn't "catch" the "problem"?



Thanks,
Amir


From: Ross, Andrew J
Sent: Monday, September 12, 2016 18:44
To: Kaplan, Amir <amir.kaplan(a)intel.com<mailto:amir.kaplan(a)intel.com>>; devel(a)lists.zephyrproject.org<mailto:devel(a)lists.zephyrproject.org>
Subject: Re: [devel] deprecated issue after push to gerrit - need some help


It looks like Inaky struggled with this a few months back. Sphinx claims to have fixed it in the bug, no idea if we've done anything to patch it on our end:

https://github.com/sphinx-doc/sphinx/issues/2682

Andy

________________________________
From: Kaplan, Amir
Sent: Monday, September 12, 2016 7:56AM
To: Devel
Subject: [devel] deprecated issue after push to gerrit - need some help
Hi all,

I pushed to : https://gerrit.zephyrproject.org/r/4705

And I got Verified -1 error:

Going to there, and I see:


ERROR: Please fix the documentation warnings
/jenkins/workspace/zephyr-verify/doc/api/power_management_api.rst:16: WARNING: Error when parsing function declaration.
If the function has no return type:
Error in declarator or parameters and qualifiers
Invalid definition: Expected identifier in nested name, got keyword: int [error at 10]
static int __deprecated device_suspend(struct device * device, int pm_policy)
----------^
If the function has a return type:
Error in declarator or parameters and qualifiers
If pointer to member declarator:
Invalid definition: Expected '::' in pointer to member (function). [error at 24]
static int __deprecated device_suspend(struct device * device, int pm_policy)
------------------------^
If declarator-id:
Invalid definition: Expecting "(" in parameters_and_qualifiers. [error at 24]
static int __deprecated device_suspend(struct device * device, int pm_policy)
------------------------^

The function is (in device.h):

static inline int __deprecated device_suspend(struct device *device,
int pm_policy)
{
return device->config->dev_pm_ops->suspend(device, pm_policy);
}

Any idea (I didn't find what is wrong with it)?

Thanks in advance,
Amir Kaplan (S/W dev. in wiot )






---------------------------------------------------------------------
A member of the Intel Corporation group of companies

This e-mail and any attachments may contain confidential material for
the sole use of the intended recipient(s). Any review or distribution
by others is strictly prohibited. If you are not the intended
recipient, please contact the sender and delete all copies.


---------------------------------------------------------------------
A member of the Intel Corporation group of companies

This e-mail and any attachments may contain confidential material for
the sole use of the intended recipient(s). Any review or distribution
by others is strictly prohibited. If you are not the intended
recipient, please contact the sender and delete all copies.