[PATCH] kernel-doc: rename the kernel-doc directive 'functions' to 'specific'
tzimmermann at suse.de
Tue Oct 15 12:08:04 UTC 2019
Am 15.10.19 um 13:54 schrieb Matthew Wilcox:
> On Tue, Oct 15, 2019 at 11:25:53AM +0200, Thomas Zimmermann wrote:
>>> My preference would be to use 'symbols'. I tried to come up with something
>>> but 'symbols' is better than anything I came up with.
>> Maybe 'interfaces' or 'artifacts'. The term 'symbols' is just as
>> imprecise as 'functions'.
> I suggested 'identifier' because that's the term used in the C spec (6.2.1):
> : An identifier can denote an object; a function; a tag or a member
> : of a structure, union, or enumeration; a typedef name; a label name;
> : a macro name; or a macro parameter.
> We don't allow documenting all those things separately, but it does cover
> all the things we do allow to be individually documented.
Yeah, makes sense.
Graphics Driver Developer
SUSE Software Solutions Germany GmbH
Maxfeldstr. 5, 90409 Nürnberg, Germany
(HRB 36809, AG Nürnberg)
Geschäftsführer: Felix Imendörffer
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 488 bytes
Desc: OpenPGP digital signature
More information about the dri-devel