Re: [PATCH 11/14] kernel-doc: public/version.h

[Jan Beulich <jbeulich@xxxxxxxx>]

On 07.08.2020 01:49, Stefano Stabellini wrote:
> --- a/xen/include/public/version.h
> +++ b/xen/include/public/version.h
> @@ -30,19 +30,33 @@
>  
>  #include "xen.h"
>  
> -/* NB. All ops return zero on success, except XENVER_{version,pagesize}
> - * XENVER_{version,pagesize,build_id} */
> +/**
> + * DOC: XENVER_*
> + *
> + * NB. All ops return zero on success, except for:
> + *
> + * - XENVER_{version,pagesize}
> + * - XENVER_{version,pagesize,build_id}

You make the mistake made by 460d24188d81 even more obvious, instead of
fixing it (by removing the first of these two lines).

Jan