[PATCH] kernel-doc: rename the kernel-doc directive 'functions' to 'specific'

Thomas Zimmermann 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.

Best regards

Thomas Zimmermann
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...
Name: signature.asc
Type: application/pgp-signature
Size: 488 bytes
Desc: OpenPGP digital signature
URL: <https://lists.freedesktop.org/archives/dri-devel/attachments/20191015/09356d41/attachment.sig>

More information about the dri-devel mailing list