Hi Amir,

Check out this Zephyr wiki note for a workaround:  https://wiki.zephyrproject.org/view/Function_Documentation#Workarounds

 

-- david

 

 

From: Kaplan, Amir [mailto:amir.kaplan@intel.com]
Sent: Monday, September 12, 2016 7:57 AM
To: devel@lists.zephyrproject.org
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.