Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit cba862dc authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab
Browse files

media: drivers: remove "/**" from non-kernel-doc comments 



Several comments are wrongly tagged as kernel-doc, causing
those warnings:

  drivers/media/rc/st_rc.c:98: warning: No description found for parameter 'irq'
  drivers/media/rc/st_rc.c:98: warning: No description found for parameter 'data'
  drivers/media/pci/solo6x10/solo6x10-enc.c:183: warning: No description found for parameter 'solo_dev'
  drivers/media/pci/solo6x10/solo6x10-enc.c:183: warning: No description found for parameter 'ch'
  drivers/media/pci/solo6x10/solo6x10-enc.c:183: warning: No description found for parameter 'qp'
  drivers/media/usb/pwc/pwc-dec23.c:652: warning: Cannot understand  *
   on line 652 - I thought it was a doc line
  drivers/media/usb/dvb-usb/cinergyT2-fe.c:40: warning: No description found for parameter 'op'
  drivers/media/usb/dvb-usb/friio-fe.c:301: warning: Cannot understand  * (reg, val) commad list to initialize this module.
   on line 301 - I thought it was a doc line
  drivers/media/rc/streamzap.c:201: warning: No description found for parameter 'urb'
  drivers/media/rc/streamzap.c:333: warning: No description found for parameter 'intf'
  drivers/media/rc/streamzap.c:333: warning: No description found for parameter 'id'
  drivers/media/rc/streamzap.c:464: warning: No description found for parameter 'interface'
  drivers/media/i2c/ov5647.c:432: warning: Cannot understand  * @short Subdev core operations registration
   on line 432 - I thought it was a doc line
  drivers/media/usb/dvb-usb/friio.c:35: warning: No description found for parameter 'd'
  drivers/media/usb/dvb-usb/friio.c:35: warning: No description found for parameter 'addr'
  drivers/media/usb/dvb-usb/friio.c:35: warning: No description found for parameter 'wbuf'
  drivers/media/usb/dvb-usb/friio.c:35: warning: No description found for parameter 'wlen'
  drivers/media/usb/dvb-usb/friio.c:35: warning: No description found for parameter 'rbuf'
  drivers/media/usb/dvb-usb/friio.c:35: warning: No description found for parameter 'rlen'
  drivers/media/platform/vim2m.c:350: warning: No description found for parameter 'priv'
  drivers/media/dvb-frontends/tua6100.c:34: warning: cannot understand function prototype: 'struct tua6100_priv '
  drivers/media/platform/sti/hva/hva-h264.c:140: warning: cannot understand function prototype: 'struct hva_h264_stereo_video_sei '
  drivers/media/platform/sti/hva/hva-h264.c:150: warning: Cannot understand  * @frame_width: width in pixels of the buffer containing the input frame
   on line 150 - I thought it was a doc line
  drivers/media/platform/sti/hva/hva-h264.c:356: warning: Cannot understand  * @ slice_size: slice size
   on line 356 - I thought it was a doc line
  drivers/media/platform/sti/hva/hva-h264.c:369: warning: Cannot understand  * @ bitstream_size: bitstream size
   on line 369 - I thought it was a doc line
  drivers/media/platform/sti/hva/hva-h264.c:395: warning: Cannot understand  * @seq_info:  sequence information buffer
   on line 395 - I thought it was a doc line
  drivers/media/dvb-frontends/sp887x.c:137: warning: No description found for parameter 'fe'
  drivers/media/dvb-frontends/sp887x.c:137: warning: No description found for parameter 'fw'
  drivers/media/dvb-frontends/sp887x.c:287: warning: No description found for parameter 'n'
  drivers/media/dvb-frontends/sp887x.c:287: warning: No description found for parameter 'd'
  drivers/media/dvb-frontends/sp887x.c:287: warning: No description found for parameter 'quotient_i'
  drivers/media/dvb-frontends/sp887x.c:287: warning: No description found for parameter 'quotient_f'
  drivers/media/usb/ttusb-budget/dvb-ttusb-budget.c:83: warning: cannot understand function prototype: 'struct ttusb '
  drivers/media/platform/sh_veu.c:277: warning: No description found for parameter 'priv'
  drivers/media/dvb-frontends/zl10036.c:33: warning: cannot understand function prototype: 'int zl10036_debug; '
  drivers/media/dvb-frontends/zl10036.c:179: warning: No description found for parameter 'state'
  drivers/media/dvb-frontends/zl10036.c:179: warning: No description found for parameter 'frequency'
  drivers/media/platform/rcar_fdp1.c:1139: warning: No description found for parameter 'priv'
  drivers/media/platform/ti-vpe/vpe.c:933: warning: No description found for parameter 'priv'
  drivers/media/usb/gspca/ov519.c:36: warning: No description found for parameter 'fmt'
  drivers/media/usb/dvb-usb/dib0700_devices.c:3367: warning: No description found for parameter 'adap'

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
parent ed050c21

drivers/media/dvb-frontends/sp887x.c

+3 −3
Original line number Diff line number Diff line
@@ -57,7 +57,7 @@ static int sp887x_writereg (struct sp887x_state* state, u16 reg, u16 data) 
	int ret;



	if ((ret = i2c_transfer(state->i2c, &msg, 1)) != 1) {

		/**

		/*

		 *  in case of soft reset we ignore ACK errors...

		 */

		if (!(reg == 0xf1a && data == 0x000 &&
@@ -130,7 +130,7 @@ static void sp887x_setup_agc (struct sp887x_state* state) 


#define BLOCKSIZE 30

#define FW_SIZE 0x4000

/**

/*

 *  load firmware and setup MPEG interface...

 */

static int sp887x_initial_setup (struct dvb_frontend* fe, const struct firmware *fw)
@@ -279,7 +279,7 @@ static int configure_reg0xc05(struct dtv_frontend_properties *p, u16 *reg0xc05) 
	return 0;

}



/**

/*

 *  estimates division of two 24bit numbers,

 *  derived from the ves1820/stv0299 driver code

 */

drivers/media/dvb-frontends/tua6100.c

+1 −1
Original line number Diff line number Diff line 
/**

/*

 * Driver for Infineon tua6100 pll.

 *

 * (c) 2006 Andrew de Quincey

drivers/media/dvb-frontends/zl10036.c

+4 −4
Original line number Diff line number Diff line 
/**

/*

 * Driver for Zarlink zl10036 DVB-S silicon tuner

 *

 * Copyright (C) 2006 Tino Reichardt
@@ -157,7 +157,7 @@ static int zl10036_sleep(struct dvb_frontend *fe) 
	return ret;

}



/**

/*

 * register map of the ZL10036/ZL10038

 *

 * reg[default] content
@@ -219,7 +219,7 @@ static int zl10036_set_bandwidth(struct zl10036_state *state, u32 fbw) 
	if (fbw <= 28820) {

		br = _BR_MAXIMUM;

	} else {

		/**

		/*

		 *  f(bw)=34,6MHz f(xtal)=10.111MHz

		 *  br = (10111/34600) * 63 * 1/K = 14;

		 */
@@ -315,7 +315,7 @@ static int zl10036_set_params(struct dvb_frontend *fe) 
	||  (frequency > fe->ops.info.frequency_max))

		return -EINVAL;



	/**

	/*

	 * alpha = 1.35 for dvb-s

	 * fBW = (alpha*symbolrate)/(2*0.8)

	 * 1.35 / (2*0.8) = 27 / 32

drivers/media/i2c/ov5647.c

+2 −2
Original line number Diff line number Diff line
@@ -428,8 +428,8 @@ static int ov5647_sensor_set_register(struct v4l2_subdev *sd, 
}

#endif



/**

 * @short Subdev core operations registration

/*

 * Subdev core operations registration

 */

static const struct v4l2_subdev_core_ops ov5647_subdev_core_ops = {

	.s_power		= ov5647_sensor_power,

drivers/media/pci/solo6x10/solo6x10-enc.c

+1 −1
Original line number Diff line number Diff line
@@ -175,7 +175,7 @@ int solo_osd_print(struct solo_enc_dev *solo_enc) 
	return 0;

}



/**

/*

 * Set channel Quality Profile (0-3).

 */

void solo_s_jpeg_qp(struct solo_dev *solo_dev, unsigned int ch,