Re: [patch] minor fixes to gconvert inline API docs



Sven Neumann <sven gimp org> writes:

> Hi,
> 
> the following patch tries to eliminate a couple of minor issues with
> the inline API docs in glib/gconvert.c. Is it OK to commit this?
> 
> I'm not entirely sure how we would like to spell 'NULL-terminated'. At 
> the moment, there are a number of different spellings in the docs:
> 
>  NULL-terminated
>  NULL terminated
>  %NULL-terminated
>  %NULL terminated
>  nul-terminated 
>  nul terminated 
> 
> which is the preferred one ?
 
nul-terminated is prefered.

 nul is preferred over NULL or %NULL because the string is terminated
 with an ASCII nul, not a %NULL pointer.

 nul-terminated is preferred over nul terminated, because in
 best practice, compound adjectives in English are hyphenated.

Other than that, the patch looks fine.

Regards,
                                        Owen




[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]