RE: [PULL] http://www.linuxtv.org/hg/~hverkuil/v4l-dvb-vpfe-cap

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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

[Index of Archives]     [Linux Input]     [Video for Linux]     [Gstreamer Embedded]     [Mplayer Users]     [Linux USB Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [Yosemite Backpacking]
  Powered by Linux