Re: [PATCH 4/5] x86/sgx: Remove superfluous asterisk from copyright comment in asm/sgx.h
On Wed, Nov 12, 2025 at 08:07:07AM -0800, Sean Christopherson wrote: > Drop an asterisk from a file-level copyright comment so that the comment > isn't intrepeted as a kernel-doc comment. > > E.g. if arch/x86/include/asm/sgx.h is fed into kernel-doc processing: > > WARNING: ./arch/x86/include/asm/sgx.h:2 This comment starts with '/**', > but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst > > Signed-off-by: Sean Christopherson > --- > arch/x86/include/asm/sgx.h | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/arch/x86/include/asm/sgx.h b/arch/x86/include/asm/sgx.h > index a88c4ab95edd..3c90cae04e1d 100644 > --- a/arch/x86/include/asm/sgx.h > +++ b/arch/x86/include/asm/sgx.h > @@ -1,5 +1,5 @@ > /* SPDX-License-Identifier: GPL-2.0 */ > -/** > +/* > * Copyright(c) 2016-20 Intel Corporation. > * > * Intel Software Guard Extensions (SGX) support. > -- > 2.51.2.1041.gc1ab5b90ca-goog > Reviewed-by: Jarkko Sakkinen BR, Jarkko
Re: [PATCH 4/5] x86/sgx: Remove superfluous asterisk from copyright comment in asm/sgx.h
On Wed, 2025-11-12 at 08:07 -0800, Sean Christopherson wrote: > Drop an asterisk from a file-level copyright comment so that the comment > isn't intrepeted as a kernel-doc comment. ^ interpreted
[PATCH 4/5] x86/sgx: Remove superfluous asterisk from copyright comment in asm/sgx.h
Drop an asterisk from a file-level copyright comment so that the comment isn't intrepeted as a kernel-doc comment. E.g. if arch/x86/include/asm/sgx.h is fed into kernel-doc processing: WARNING: ./arch/x86/include/asm/sgx.h:2 This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst Signed-off-by: Sean Christopherson --- arch/x86/include/asm/sgx.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/arch/x86/include/asm/sgx.h b/arch/x86/include/asm/sgx.h index a88c4ab95edd..3c90cae04e1d 100644 --- a/arch/x86/include/asm/sgx.h +++ b/arch/x86/include/asm/sgx.h @@ -1,5 +1,5 @@ /* SPDX-License-Identifier: GPL-2.0 */ -/** +/* * Copyright(c) 2016-20 Intel Corporation. * * Intel Software Guard Extensions (SGX) support. -- 2.51.2.1041.gc1ab5b90ca-goog
