Hi, <Snip> >> > >> > -/** >> > +/* >> > * struct tvp514x_decoder - TVP5146/47 decoder object >> > - * @v4l2_int_device: Slave handle >> > - * @tvp514x_slave: Slave pointer which is used by @v4l2_int_device >> > + * @sd: Subdevice Slave handle >> > * @tvp514x_regs: copy of hw's regs with preset values. >> > * @pdata: Board specific >> > - * @client: I2C client data >> > - * @id: Entry from I2C table >> > * @ver: Chip version >> > - * @state: TVP5146/47 decoder state - detected or not-detected >> > + * @streaming: TVP5146/47 decoder streaming - enabled or disabled. >> > * @pix: Current pixel format >> > * @num_fmts: Number of formats >> > * @fmt_list: Format list >> > * @current_std: Current standard >> > * @num_stds: Number of standards >> > * @std_list: Standards list >> > - * @route: input and output routing at chip level >> > + * @input: Input routing at chip level >> > + * @output: Output routing at chip level >> > */ >> > >> > Please read Documentation/kernel-doc-nano-HOWTO.txt for the proper >> > format. Basically, it should be like this example: >> > >> > /** >> > * foobar() - short function description of foobar >> > * @arg1: Describe the first argument to foobar. >> > * @arg2: Describe the second argument to foobar. >> > * One can provide multiple line descriptions >> > * for arguments. >> > * >> > * A longer description, with more discussion of the function foobar() >> > * that might be useful to those using or modifying it. Begins with >> > * empty comment line, and may include additional embedded empty >> > * comment lines. >> > * >> > * The longer description can have multiple paragraphs. >> > **/ >> > But kernel-doc-nano-HOWTO.txt says it should be of the form /** * foobar() - short function description of foobar * @arg1: Describe the first argument to foobar. * @arg2: Describe the second argument to foobar. * One can provide multiple line descriptions * for arguments. * * A longer description, with more discussion of the function foobar() * that might be useful to those using or modifying it. Begins with * empty comment line, and may include additional embedded empty * comment lines. * * The longer description can have multiple paragraphs. */ Only one * followed by slash as */, not **/ as you have mentioned. Please confirm so that I can send you a patch to correct this. -- To unsubscribe from this list: send the line "unsubscribe linux-media" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html