Re: [PATCH 01/12] habanalabs/gaudi2: add asic registers header files

From: Oded Gabbay
Date: Tue Jun 28 2022 - 02:53:11 EST


On Tue, Jun 28, 2022 at 9:28 AM Greg KH <gregkh@xxxxxxxxxxxxxxxxxxx> wrote:
>
> On Mon, Jun 27, 2022 at 11:26:09PM +0300, Oded Gabbay wrote:
> > +#ifndef __GAUDI2_ARC_COMMON_PACKETS_H__
> > +#define __GAUDI2_ARC_COMMON_PACKETS_H__
> > +
> > +/**
> > + * \file gaudi2_arc_common_packets.h
> > + * \brief IDs for QMAN ARC CPUs
> > + * This defines IDs that needs to be programmed into CPU ID
> > + * register xx_ARC_AUX_ARC_NUM
>
> What is this "\" formatting for and from? What uses it? I don't think
> it's kernel-doc, right?
>
> And if it is kernel-doc, are these files all hooked into the kernel
> documentation build process to generate the output of them?
>
> thanks,
>
> greg k-h
No, it's not kernel-doc.
It's a file copied from f/w team and these comments went under my radar.
I'll just remove the non-standard format. It's not relevant anyway.

Thanks,
Oded