[GNC-dev] gnucash/gnome-utils/gnc-plugin-page.h missing a documentation parameter

Frank H. Ellenberger frank.h.ellenberger at gmail.com
Tue Mar 1 09:31:34 EST 2022


I had only looked in line 408:
*  @return The color for this page.  This string is owned by the page and
not 419:
*  @param The color for this page.  This string is owned by the page and


Am 01.03.22 um 06:55 schrieb john:
> 
> 
>> On Feb 28, 2022, at 9:26 PM, Frank H. Ellenberger <frank.h.ellenberger at gmail.com> wrote:
>>
>> Hi Kevin,
>>
>> Am 27.02.22 um 08:47 schrieb Kevin Buckley:
>>> appears to be missing the parameter name color
>>>
>>> Line 408 should presumably be
>>>
>>> *  @param color The color for this page.  This string is owned by the page and
>>
>> np, it is the return value. Because a function can have multiple
>> parameeters you have to name them. But there is only one return value.
> 
> Frank,
> 
> Before being so dismissive you should look at https://code.gnucash.org/docs/MAINT/group__ContentPluginBase.html#ga7408d75bdf2e64264cb9386ac860052c: <https://code.gnucash.org/docs/MAINT/group__ContentPluginBase.html#ga7408d75bdf2e64264cb9386ac860052c:>
> 
> BTW
> 
>> void gnc_plugin_page_set_page_color (GncPluginPage *page, const char *color);
> 
> clearly has no return value.
> 
> Regards,
> John Ralls


More information about the gnucash-devel mailing list