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

media: atomisp: stop producing hundreds of kernel-doc warnings 



A recent change on Kernel 4.15-rc1 causes all tags with
/** to be handled as kernel-doc markups. Well, several
atomisp modules, it doesn't use kernel-doc, but some other
documentation markup (doxygen?).

So, suppress all those warns by:
	- replacing /**< by /**.
	- replacing /** by /*.

The core changes were done with:

	for i in $(find drivers/staging/media/atomisp -type f); do sed 's,/\*\* ,/\*, ' -i $i; done
	for i in $(find drivers/staging/media/atomisp -type f); do sed 's,/\*\*<,/\**,' -i $i; done
	for i in drivers/staging/media/atomisp/pci/atomisp2/css2400/runtime/debug/src/ia_css_debug.c drivers/staging/media/atomisp/pci/atomisp2/css2400/sh_css_sp.c drivers/staging/media/atomisp/pci/atomisp2/css2400/runtime/rmgr/src/rmgr_vbuf.c; do perl -ne 's,\/\*\*$,/*,g; print $_'  $i > a && mv a $i; done;

A few manual adjustments were made, where needed.

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@s-opensource.com>
Acked-by: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
parent 04226916

drivers/staging/media/atomisp/include/linux/atomisp.h

+17 −17
Original line number Diff line number Diff line
@@ -208,14 +208,14 @@ struct atomisp_dis_vector { 
};





/** DVS 2.0 Coefficient types. This structure contains 4 pointers to

/* DVS 2.0 Coefficient types. This structure contains 4 pointers to

 *  arrays that contain the coeffients for each type.

 */

struct atomisp_dvs2_coef_types {

	short __user *odd_real; /**< real part of the odd coefficients*/

	short __user *odd_imag; /**< imaginary part of the odd coefficients*/

	short __user *even_real;/**< real part of the even coefficients*/

	short __user *even_imag;/**< imaginary part of the even coefficients*/

	short __user *odd_real; /** real part of the odd coefficients*/

	short __user *odd_imag; /** imaginary part of the odd coefficients*/

	short __user *even_real;/** real part of the even coefficients*/

	short __user *even_imag;/** imaginary part of the even coefficients*/

};



/*
@@ -223,10 +223,10 @@ struct atomisp_dvs2_coef_types { 
 * arrays that contain the statistics for each type.

 */

struct atomisp_dvs2_stat_types {

	int __user *odd_real; /**< real part of the odd statistics*/

	int __user *odd_imag; /**< imaginary part of the odd statistics*/

	int __user *even_real;/**< real part of the even statistics*/

	int __user *even_imag;/**< imaginary part of the even statistics*/

	int __user *odd_real; /** real part of the odd statistics*/

	int __user *odd_imag; /** imaginary part of the odd statistics*/

	int __user *even_real;/** real part of the even statistics*/

	int __user *even_imag;/** imaginary part of the even statistics*/

};



struct atomisp_dis_coefficients {
@@ -390,16 +390,16 @@ struct atomisp_metadata_config { 
 * Generic resolution structure.

 */

struct atomisp_resolution {

	uint32_t width;  /**< Width */

	uint32_t height; /**< Height */

	uint32_t width;  /** Width */

	uint32_t height; /** Height */

};



/*

 * This specifies the coordinates (x,y)

 */

struct atomisp_zoom_point {

	int32_t x; /**< x coordinate */

	int32_t y; /**< y coordinate */

	int32_t x; /** x coordinate */

	int32_t y; /** y coordinate */

};



/*
@@ -411,9 +411,9 @@ struct atomisp_zoom_region { 
};



struct atomisp_dz_config {

	uint32_t dx; /**< Horizontal zoom factor */

	uint32_t dy; /**< Vertical zoom factor */

	struct atomisp_zoom_region zoom_region; /**< region for zoom */

	uint32_t dx; /** Horizontal zoom factor */

	uint32_t dy; /** Vertical zoom factor */

	struct atomisp_zoom_region zoom_region; /** region for zoom */

};



struct atomisp_parm {
@@ -758,7 +758,7 @@ enum atomisp_acc_arg_type { 
	ATOMISP_ACC_ARG_FRAME	     /* Frame argument */

};



/** ISP memories, isp2400 */

/* ISP memories, isp2400 */

enum atomisp_acc_memory {

	ATOMISP_ACC_MEMORY_PMEM0 = 0,

	ATOMISP_ACC_MEMORY_DMEM0,

drivers/staging/media/atomisp/pci/atomisp2/atomisp_cmd.c

+1 −1
Original line number Diff line number Diff line
@@ -5187,7 +5187,7 @@ int get_frame_info_nop(struct atomisp_sub_device *asd, 
	return 0;

}



/**

/*

 * Resets CSS parameters that depend on input resolution.

 *

 * Update params like CSS RAW binning, 2ppc mode and pp_input

drivers/staging/media/atomisp/pci/atomisp2/atomisp_compat_css20.c

+1 −1
Original line number Diff line number Diff line
@@ -4051,7 +4051,7 @@ int atomisp_css_get_formats_config(struct atomisp_sub_device *asd, 
int atomisp_css_get_zoom_factor(struct atomisp_sub_device *asd,

					unsigned int *zoom)

{

	struct ia_css_dz_config dz_config;  /**< Digital Zoom */

	struct ia_css_dz_config dz_config;  /** Digital Zoom */

	struct ia_css_isp_config isp_config;

	struct atomisp_device *isp = asd->isp;

drivers/staging/media/atomisp/pci/atomisp2/atomisp_compat_ioctl32.h

+8 −8
Original line number Diff line number Diff line
@@ -28,17 +28,17 @@ struct atomisp_histogram32 { 
};



struct atomisp_dvs2_stat_types32 {

	compat_uptr_t odd_real; /**< real part of the odd statistics*/

	compat_uptr_t odd_imag; /**< imaginary part of the odd statistics*/

	compat_uptr_t even_real;/**< real part of the even statistics*/

	compat_uptr_t even_imag;/**< imaginary part of the even statistics*/

	compat_uptr_t odd_real; /** real part of the odd statistics*/

	compat_uptr_t odd_imag; /** imaginary part of the odd statistics*/

	compat_uptr_t even_real;/** real part of the even statistics*/

	compat_uptr_t even_imag;/** imaginary part of the even statistics*/

};



struct atomisp_dvs2_coef_types32 {

	compat_uptr_t odd_real; /**< real part of the odd coefficients*/

	compat_uptr_t odd_imag; /**< imaginary part of the odd coefficients*/

	compat_uptr_t even_real;/**< real part of the even coefficients*/

	compat_uptr_t even_imag;/**< imaginary part of the even coefficients*/

	compat_uptr_t odd_real; /** real part of the odd coefficients*/

	compat_uptr_t odd_imag; /** imaginary part of the odd coefficients*/

	compat_uptr_t even_real;/** real part of the even coefficients*/

	compat_uptr_t even_imag;/** imaginary part of the even coefficients*/

};



struct atomisp_dvs2_statistics32 {

drivers/staging/media/atomisp/pci/atomisp2/atomisp_subdev.h

+1 −1
Original line number Diff line number Diff line
@@ -223,7 +223,7 @@ struct atomisp_subdev_params { 


	bool dis_proj_data_valid;



	struct ia_css_dz_config   dz_config;  /**< Digital Zoom */

	struct ia_css_dz_config   dz_config;  /** Digital Zoom */

	struct ia_css_capture_config   capture_config;



	struct atomisp_css_isp_config config;

CRA Git | Maintained and supported by SUSTech CRA and CCSE