From 1aff53b2fd903b300dfd71af0064c21fbca313c6 Mon Sep 17 00:00:00 2001

From: Randy Dunlap <rdunlap@infradead.org>

Date: Mon, 13 Feb 2023 13:25:49 -0800

Subject: [PATCH] ata: pata_octeon_cf: drop kernel-doc notation

Git-commit: 1aff53b2fd903b300dfd71af0064c21fbca313c6

Patch-mainline: v6.2

References: git-fixes

Fix a slew of kernel-doc warnings in pata_octeon_cf.c by changing

all "/**" comments to "/*" since they are not in kernel-doc format.

Fixes: 3c929c6f5aa7 ("libata: New driver for OCTEON SOC Compact Flash interface (v7).")

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>

Reported-by: kernel test robot <lkp@intel.com>

Link: https://lore.kernel.org/all/202302101722.5O56RClE-lkp@intel.com/

Cc: David Daney <ddaney@caviumnetworks.com>

Cc: Damien Le Moal <damien.lemoal@opensource.wdc.com>

Cc: Mauro Carvalho Chehab <mchehab@kernel.org>

Cc: linux-ide@vger.kernel.org

Signed-off-by: Damien Le Moal <damien.lemoal@opensource.wdc.com>

Acked-by: Takashi Iwai <tiwai@suse.de>

---

 drivers/ata/pata_octeon_cf.c |   16 ++++++++--------

 1 file changed, 8 insertions(+), 8 deletions(-)

--- a/drivers/ata/pata_octeon_cf.c

+++ b/drivers/ata/pata_octeon_cf.c

@@ -67,7 +67,7 @@ module_param(enable_dma, int, 0444);

 MODULE_PARM_DESC(enable_dma,

 		 "Enable use of DMA on interfaces that support it (0=no dma [default], 1=use dma)");

-/**

+/*

  * Convert nanosecond based time to setting used in the

  * boot bus timing register, based on timing multiple

  */

@@ -118,7 +118,7 @@ static void octeon_cf_set_boot_reg_cfg(i

 	cvmx_write_csr(CVMX_MIO_BOOT_REG_CFGX(cs), reg_cfg.u64);

 }

-/**

+/*

  * Called after libata determines the needed PIO mode. This

  * function programs the Octeon bootbus regions to support the

  * timing requirements of the PIO mode.

@@ -282,7 +282,7 @@ static void octeon_cf_set_dmamode(struct

 	cvmx_write_csr(cf_port->dma_base + DMA_TIM, dma_tim.u64);

 }

-/**

+/*

  * Handle an 8 bit I/O request.

  *

  * @qc:         Queued command

@@ -321,7 +321,7 @@ static unsigned int octeon_cf_data_xfer8

 	return buflen;

 }

-/**

+/*

  * Handle a 16 bit I/O request.

  *

  * @qc:         Queued command

@@ -376,7 +376,7 @@ static unsigned int octeon_cf_data_xfer1

 	return buflen;

 }

-/**

+/*

  * Read the taskfile for 16bit non-True IDE only.

  */

 static void octeon_cf_tf_read16(struct ata_port *ap, struct ata_taskfile *tf)

@@ -459,7 +459,7 @@ static int octeon_cf_softreset16(struct

 	return 0;

 }

-/**

+/*

  * Load the taskfile for 16bit non-True IDE only.  The device_addr is

  * not loaded, we do this as part of octeon_cf_exec_command16.

  */

@@ -551,7 +551,7 @@ static void octeon_cf_dma_setup(struct a

 	DPRINTK("EXIT\n");

 }

-/**

+/*

  * Start a DMA transfer that was already setup

  *

  * @qc:     Information about the DMA

@@ -612,7 +612,7 @@ static void octeon_cf_dma_start(struct a

 	cvmx_write_csr(cf_port->dma_base + DMA_CFG, mio_boot_dma_cfg.u64);

 }

-/**

+/*

  *

  *	LOCKING:

  *	spin_lock_irqsave(host lock)