linux-kernel - Re: [PATCH v3] kernel-doc: rename the kernel-doc directive 'functions' to 'identifiers'

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <20191107125557.0522eb49@lwn.net>
Date:   Thu, 7 Nov 2019 12:55:57 -0700
From:   Jonathan Corbet <corbet@....net>
To:     Changbin Du <changbin.du@...il.com>
Cc:     Jiri Kosina <trivial@...nel.org>, linux-doc@...r.kernel.org,
        linux-kernel@...r.kernel.org
Subject: Re: [PATCH v3] kernel-doc: rename the kernel-doc directive
 'functions' to 'identifiers'

On Thu, 31 Oct 2019 21:52:45 +0800
Changbin Du <changbin.du@...il.com> wrote:

> The 'functions' directive is not only for functions, but also works for
> structs/unions. So the name is misleading. This patch renames it to
> 'identifiers', which specific the functions/types to be included in
> documentation. We keep the old name as an alias of the new one before
> all documentation are updated.
> 
> Signed-off-by: Changbin Du <changbin.du@...il.com>
> 
> ---
> v2:
>   o use 'identifiers' as the new directive name.

It would have been nice to update that last text for v3 ... but the patch
looks better, so I've gone ahead and applied it, thanks.

jon