Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1198737

Re: [PATCH 2/6] iio: buffer: Fix kernel docs warnings

Show all headers | View raw

On Sun, Aug 2, 2015 at 10:46 PM, Hartmut Knaack <knaack.h@gmx.de> wrote:
> Hartmut Knaack schrieb am 02.08.2015 um 21:32:
>> Jonathan Cameron schrieb am 02.08.2015 um 19:27:
>>> On 24/07/15 14:18, Cristina Opriceana wrote:
>>>> Fix kernel docs for structures and functions in order to
>>>> remove some warnings when the documentation gets generated.
>>>>
>>>> Signed-off-by: Cristina Opriceana <cristina.opriceana@gmail.com>
>>> Applied with another typo fixed up.
>>
>> Hi,
>> I'm afraid there is some information missing.
>>
>>>> ---
>>>>  drivers/iio/industrialio-buffer.c | 15 ++++++++++++++-
>>>>  1 file changed, 14 insertions(+), 1 deletion(-)
>>>>
>>>> diff --git a/drivers/iio/industrialio-buffer.c b/drivers/iio/industrialio-buffer.c
>>>> index b13f941..a671953 100644
>>>> --- a/drivers/iio/industrialio-buffer.c
>>>> +++ b/drivers/iio/industrialio-buffer.c
>>>> @@ -91,9 +91,16 @@ static bool iio_buffer_ready(struct iio_dev *indio_dev, struct iio_buffer *buf,
>>>>
>>>>  /**
>>>>   * iio_buffer_read_first_n_outer() - chrdev read for buffer access
>>>> + * @filp:  File structure pointer for the char device
>>>> + * @buf:   Destination buffer for iio buffer read
>>>> + * @n:             First n bytes to read
>>>> + * @f_ps:  Long offset provided by the user as a seek position
>>>>   *
>>>>   * This function relies on all buffer implementations having an
>>>>   * iio_buffer as their first element.
>>>> + *
>>>> + * Return: negative values corresponding to error codes or ret != 0
>>>> + *    for ending the reading activity
>>
>> This may also return 0. Would it be wrong to state that if the return
>> value is not negative, then it will indicate the amount of data read?
>>
>>>>   **/
>>>>  ssize_t iio_buffer_read_first_n_outer(struct file *filp, char __user *buf,
>>>>                                   size_t n, loff_t *f_ps)
>>>> @@ -143,6 +150,12 @@ ssize_t iio_buffer_read_first_n_outer(struct file *filp, char __user *buf,
>>>>
>>>>  /**
>>>>   * iio_buffer_poll() - poll the buffer to find out if it has data
>>>> + * @filp:  File structure poiner for device access
>>> pointer
>>>> + * @wait:  Poll table structure pointer for which the driver adds
>>>> + *         a wait queue
>>>> + *
>>>> + * Return: (POLLIN | POLLRDNORM) if data is available for reading
>>>> + *    or 0 for other cases
>>
>> This can also return -ENODEV.
>
> On second thought however, it may return anything, given it is unsigned int.
> Any volunteers?
>
I sent a patch changing the return value in case that no device is bound

Cristina
>>
>>>>   */
>>>>  unsigned int iio_buffer_poll(struct file *filp,
>>>>                          struct poll_table_struct *wait)
>>>> @@ -1136,7 +1149,7 @@ int iio_scan_mask_query(struct iio_dev *indio_dev,
>>>>  EXPORT_SYMBOL_GPL(iio_scan_mask_query);
>>>>
>>>>  /**
>>>> - * struct iio_demux_table() - table describing demux memcpy ops
>>>> + * struct iio_demux_table - table describing demux memcpy ops
>>>>   * @from:  index to copy from
>>>>   * @to:            index to copy to
>>>>   * @length:        how many bytes to copy
>>>>
>>>
>>> --
>>> To unsubscribe from this list: send the line "unsubscribe linux-iio" in
>>> the body of a message to majordomo@vger.kernel.org
>>> More majordomo info at  http://vger.kernel.org/majordomo-info.html
>>>
>>
>> --
>> To unsubscribe from this list: send the line "unsubscribe linux-iio" in
>> the body of a message to majordomo@vger.kernel.org
>> More majordomo info at  http://vger.kernel.org/majordomo-info.html
>>
>
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

Back to linux.kernel | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

[PATCH 0/6] iio: Fix kernel docs warnings Cristina Opriceana <cristina.opriceana@gmail.com> - 2015-07-24 15:20 +0200
  [PATCH 2/6] iio: buffer: Fix kernel docs warnings Cristina Opriceana <cristina.opriceana@gmail.com> - 2015-07-24 15:20 +0200
    Re: [PATCH 2/6] iio: buffer: Fix kernel docs warnings Hartmut Knaack <knaack.h@gmx.de> - 2015-08-02 21:40 +0200
      Re: [PATCH 2/6] iio: buffer: Fix kernel docs warnings Hartmut Knaack <knaack.h@gmx.de> - 2015-08-02 21:50 +0200
        Re: [PATCH 2/6] iio: buffer: Fix kernel docs warnings Cristina Georgiana Opriceana <cristina.opriceana@gmail.com> - 2015-08-03 12:50 +0200
    Re: [PATCH 2/6] iio: buffer: Fix kernel docs warnings Jonathan Cameron <jic23@kernel.org> - 2015-08-02 19:30 +0200
  [PATCH 1/6] iio: core: Add function params for kernel docs Cristina Opriceana <cristina.opriceana@gmail.com> - 2015-07-24 15:20 +0200
    Re: [PATCH 1/6] iio: core: Add function params for kernel docs Jonathan Cameron <jic23@kernel.org> - 2015-08-02 19:30 +0200
  [PATCH 3/6] iio: trigger: Add missing fields in kernel docs Cristina Opriceana <cristina.opriceana@gmail.com> - 2015-07-24 15:30 +0200
    Re: [PATCH 3/6] iio: trigger: Add missing fields in kernel docs Jonathan Cameron <jic23@kernel.org> - 2015-08-02 19:40 +0200
  [PATCH 5/6] include: linux: iio: Fix function parameter name in  kernel doc Cristina Opriceana <cristina.opriceana@gmail.com> - 2015-07-24 15:30 +0200
    Re: [PATCH 5/6] include: linux: iio: Fix function parameter name in  kernel doc Jonathan Cameron <jic23@kernel.org> - 2015-08-02 19:40 +0200
  [PATCH 6/6] include: linux: iio: Add missing kernel doc field Cristina Opriceana <cristina.opriceana@gmail.com> - 2015-07-24 15:30 +0200
    Re: [PATCH 6/6] include: linux: iio: Add missing kernel doc field Jonathan Cameron <jic23@kernel.org> - 2015-08-02 19:40 +0200
  [PATCH 4/6] iio: event: Add missing fields in kernel docs Cristina Opriceana <cristina.opriceana@gmail.com> - 2015-07-24 15:30 +0200
    Re: [PATCH 4/6] iio: event: Add missing fields in kernel docs Hartmut Knaack <knaack.h@gmx.de> - 2015-08-02 21:50 +0200
      Re: [PATCH 4/6] iio: event: Add missing fields in kernel docs Lars-Peter Clausen <lars@metafoo.de> - 2015-08-03 11:10 +0200
      Re: [PATCH 4/6] iio: event: Add missing fields in kernel docs Cristina Georgiana Opriceana <cristina.opriceana@gmail.com> - 2015-08-03 11:10 +0200
    Re: [PATCH 4/6] iio: event: Add missing fields in kernel docs Jonathan Cameron <jic23@kernel.org> - 2015-08-02 19:40 +0200

csiph-web