Re: [PATCH v3 2/3] docs: media: document media multi-committers rules and process

2024-12-03 Thread Sakari Ailus
gt; > + > > > + - the Media development profile: > > > +Documentation/driver-api/media/maintainer-entry-profile.rst > > > > Could you add a label to the title and refer to it directly? > > Same as above. > > > > + > > > +- understanding of the projects' code base and coding style; > > > +- ability to provide feedback to the patch authors; > > > +- ability to judge when a patch might be ready for review and to submit; > > > +- ability to write good code (last but certainly not least). > > > + > > > +Developers that intend to become committers are encouraged to > > > participate > > > > s/intend/yearn/ > > Heh, I had to go to the dictionary to seek for "yearn" meaning ;-) > > Let's use a simpler language, as most developers are not native-English > speakers. I did: > > s/intend/desire/ > > which is a synonym. Works for me. -- Kind regards, Sakari Ailus

Re: [PATCH v3 2/3] docs: media: document media multi-committers rules and process

2024-12-02 Thread Sakari Ailus
nactive for more than a couple of Kernel cycles, > +maintainers will try to reach you via e-mail. If not possible, they may > +revoke your committer grants and update MAINTAINERS file entries > +accordingly. If you wish to resume contributing later on, then contact > +the subsystem main

Re: [PATCH v2] media: v4l2-fwnode: fix location of acpi/dsd documentation

2019-09-24 Thread Sakari Ailus
On Tue, Sep 24, 2019 at 09:03:56AM -0300, Mauro Carvalho Chehab wrote: > This got moved to the firmware-guide. > > Fixes: f2dde1ed0f28 ("Documentation: ACPI: move dsd/graph.txt to > firmware-guide/acpi and convert to reST") > Signed-off-by: Mauro Carvalho Chehab

Re: [PATCH] media: v4l2-fwnode: fix location of acpi/dsd documentation

2019-09-24 Thread Sakari Ailus
See documentation under > - * Documentation/acpi/dsd instead and especially graph.txt, > + * Documentation/firmware-guide/acpi/dsd instead and especially graph.txt, > * data-node-references.txt and leds.txt . Thanks! The files now have .rst suffix. Could you address that as well?

[PATCH 1/1] scripts/kernel-doc: Fix struct and struct field attribute processing

2018-11-22 Thread Sakari Ailus
, - attributes (such as aligned) containing numbers were not removed, - attributes are only cleared from struct fields, not structs themselves. This patch addresses these issues by removing the attributes. Signed-off-by: Sakari Ailus --- scripts/kernel-doc | 7 --- 1 file changed, 4 insertions(+), 3

Re: [PATCH 15/24] media: v4l2-subdev: get rid of __V4L2_SUBDEV_MK_GET_TRY() macro

2017-12-19 Thread Sakari Ailus
imple enough to just declare them, de-obfuscating > the code. > > While here, replace BUG_ON() by WARN_ON() as there's no reason > why to panic the Kernel if this fails. > > Signed-off-by: Mauro Carvalho Chehab Thanks! Acked-by: Sakari Ailus -- Sakari Ailus e-mail:

Re: [PATCH 15/24] media: v4l2-subdev: get rid of __V4L2_SUBDEV_MK_GET_TRY() macro

2017-12-19 Thread Sakari Ailus
On Mon, Dec 18, 2017 at 05:27:04PM -0200, Mauro Carvalho Chehab wrote: > Em Mon, 9 Oct 2017 23:23:56 +0300 > Sakari Ailus escreveu: > > > Hi Mauro, > > > > On Mon, Oct 09, 2017 at 07:19:21AM -0300, Mauro Carvalho Chehab wrote: > > > The __V4L2_SUBDEV_MK_GET_T

Re: [PATCH v7 5/7] media: open.rst: Adjust some terms to match the glossary

2017-10-10 Thread Sakari Ailus
Hi Mauro, On Tue, Oct 10, 2017 at 08:37:43AM -0300, Mauro Carvalho Chehab wrote: > Em Fri, 6 Oct 2017 15:48:22 +0300 > Sakari Ailus escreveu: > > > Hi Mauro, > > > > On Wed, Sep 27, 2017 at 07:23:47PM -0300, Mauro Carvalho Chehab wrote: > > > As we now

Re: [PATCH v7 1/7] media: add glossary.rst with a glossary of terms used at V4L2 spec

2017-10-10 Thread Sakari Ailus
Hi Mauro, On Tue, Oct 10, 2017 at 09:49:38AM -0300, Mauro Carvalho Chehab wrote: > Em Tue, 10 Oct 2017 14:54:35 +0300 > Sakari Ailus escreveu: > > > On Tue, Oct 10, 2017 at 06:15:03AM -0300, Mauro Carvalho Chehab wrote: > > > Em Fri, 6 Oct 2017 14:51:06 +0300 >

Re: [PATCH 18/24] media: vb2-core: use bitops for bits

2017-10-10 Thread Sakari Ailus
On Mon, Oct 09, 2017 at 07:19:24AM -0300, Mauro Carvalho Chehab wrote: > Use the existing macros to identify vb2_io_modes bits. > > Signed-off-by: Mauro Carvalho Chehab Acked-by: Sakari Ailus -- Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send

Re: [PATCH 22/24] media: vb2: add cross references at memops and v4l2 kernel-doc markups

2017-10-10 Thread Sakari Ailus
On Mon, Oct 09, 2017 at 07:19:28AM -0300, Mauro Carvalho Chehab wrote: > Add cross-references where needed and add periods at the end of > each kernel-doc paragraph, in order to make it coherent with other > VB2 descriptions. > > Signed-off-by: Mauro Carvalho Chehab Acked-b

Re: [PATCH 21/24] media: vb2-core: fix descriptions for VB2-only functions

2017-10-10 Thread Sakari Ailus
implement QUERYBUF operation. It is called "Videobuf2" and "VIDIOC_" prefix for IOCTL commands. With this and the ones below fixed, Acked-by: Sakari Ailus > + * internally by VB2 by an API-specific handler, like ``videobuf2-v4l2.h``. > * > * The passed buffer shoul

Re: [PATCH 19/24] media: vb2-core: Improve kernel-doc markups

2017-10-10 Thread Sakari Ailus
* .. note:: > + * > + *The following fields at @q should be set before calling this function: should -> shall I bet there's a lot of that in the documentation elsewhere, including this patch. -- Kind regards, Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from

Re: [PATCH v7 1/7] media: add glossary.rst with a glossary of terms used at V4L2 spec

2017-10-10 Thread Sakari Ailus
On Tue, Oct 10, 2017 at 06:15:03AM -0300, Mauro Carvalho Chehab wrote: > Em Fri, 6 Oct 2017 14:51:06 +0300 > Sakari Ailus escreveu: > > > Hi Mauro, > > > > On Fri, Oct 06, 2017 at 01:22:29PM +0300, Sakari Ailus wrote: > > > > +V4L2 device nod

Re: [PATCH v7 1/7] media: add glossary.rst with a glossary of terms used at V4L2 spec

2017-10-10 Thread Sakari Ailus
On Tue, Oct 10, 2017 at 05:30:04AM -0300, Mauro Carvalho Chehab wrote: > Em Fri, 6 Oct 2017 13:22:29 +0300 > Sakari Ailus escreveu: > > > > +Bridge driver > > > + The same as V4L2 main driver. > > > > Not all V4L2 main drivers can be bridge driver

Re: [PATCH 16/24] media: v4l2-subdev: document remaining undocumented functions

2017-10-09 Thread Sakari Ailus
> @@ -1048,6 +1100,14 @@ void v4l2_subdev_init(struct v4l2_subdev *sd, > __result; \ > }) > > +/** > + * v4l2_subdev_has_op - Checks if a subdev defines a certain ops. s/ops/operation/ (or "op"). > + * &

Re: [PATCH 17/24] media: v4l2-subdev: fix a typo

2017-10-09 Thread Sakari Ailus
as defined by &enum v4l2_subdev_flags. > * > * @v4l2_dev: pointer to struct &v4l2_device Acked-by: Sakari Ailus -- Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH 10/24] media: v4l2-subdev: use kernel-doc markups to document subdev flags

2017-10-09 Thread Sakari Ailus
its right place. > > Signed-off-by: Mauro Carvalho Chehab For patches 10--14: Acked-by: Sakari Ailus -- Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo

Re: [PATCH 15/24] media: v4l2-subdev: get rid of __V4L2_SUBDEV_MK_GET_TRY() macro

2017-10-09 Thread Sakari Ailus
y_compose(struct v4l2_subdev *sd, > + struct v4l2_subdev_pad_config *cfg, > + unsigned int pad) > +{ > + WARN_ON(pad >= sd->entity.num_pads); > + return &cfg[pad].try_compose; > +} > #endif > > extern c

Re: [PATCH 03/24] media: v4l2-mediabus: use BIT() macro for flags

2017-10-09 Thread Sakari Ailus
On Mon, Oct 09, 2017 at 07:19:09AM -0300, Mauro Carvalho Chehab wrote: > Instead of using (1 << n) for bits, use the BIT() macro, > as it makes them better documented. I wouldn't say this makes a difference from documentation point of view. Anyway, Acked-by: Sakari Ailus &

Re: [PATCH 02/24] media: v4l2-flash-led-class.h: add kernel-doc to two ancillary funcs

2017-10-09 Thread Sakari Ailus
b/include/media/v4l2-flash-led-class.h > @@ -91,12 +91,24 @@ struct v4l2_flash { > struct v4l2_ctrl **ctrls; > }; > > +/** > + * v4l2_subdev_to_v4l2_flash - Returns a &v4l2_flash from the v4l2_flash -> struct v4l2_flash ? Same below. With these, Acked-by: Sakari Ai

Re: [PATCH 01/24] media: v4l2-dev.h: add kernel-doc to two macros

2017-10-09 Thread Sakari Ailus
e &struct media_entity embedded on it. > + * > + * @entity: pointer to &struct media_entity > + */ > +#define media_entity_to_video_device(entity) \ > + container_of(entity, struct video_device, entity) > + > +/** > + * media_entity_to_video_device - Returns a &stru

Re: [PATCH v7 5/7] media: open.rst: Adjust some terms to match the glossary

2017-10-06 Thread Sakari Ailus
ed for this purpose. But several drivers do not use it, and while some > +code exists that uses sysfs to discover related V4L2 device nodes (see > libmedia_dev in the > `v4l-utils <http://git.linuxtv.org/cgit.cgi/v4l-utils.git/>`__ git > repository), there is no library yet that can pro

Re: [PATCH v7 4/7] media: open.rst: document devnode-centric and mc-centric types

2017-10-06 Thread Sakari Ailus
he :ref:`media controller API ` before > +the periferal can be used. For such devices, the sub-devices' configuration > +can be controlled via the :ref:`sub-device API `, which creates one > +device node per sub-device. > + > .. _v4l2_device_naming: > > V4L2 Device Node Naming -- Kind regards, Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH v7 1/7] media: add glossary.rst with a glossary of terms used at V4L2 spec

2017-10-06 Thread Sakari Ailus
Hi Mauro, On Fri, Oct 06, 2017 at 01:22:29PM +0300, Sakari Ailus wrote: > > +V4L2 device node > > + A device node that is associated to a V4L2 main driver, > > + as specified in :ref:`v4l2_device_naming`. I think we need to name the interface, not so much their ins

Re: [PATCH v6 2/7] media: open.rst: better document device node naming

2017-10-06 Thread Sakari Ailus
y: Hans Verkuil > Signed-off-by: Mauro Carvalho Chehab Acked-by: Sakari Ailus -- Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH v7 1/7] media: add glossary.rst with a glossary of terms used at V4L2 spec

2017-10-06 Thread Sakari Ailus
long. > + V4L2 hardware that it is controlled via V4L2 device nodes. > + > + See :ref:`v4l2_hardware_control`. > diff --git a/Documentation/media/uapi/v4l/v4l2.rst > b/Documentation/media/uapi/v4l/v4l2.rst > index 2128717299b3..698c060939f0 100644 > --- a/Documentation/media/uapi/v4l/v4l2.rst > +++ b/Documentation/media/uapi/v4l/v4l2.rst > @@ -32,6 +32,7 @@ This part describes the Video for Linux API version 2 (V4L2 > API) specification. > videodev > capture-example > v4l2grab-example > +glossary > biblio > > -- Regards, Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH v5 1/7] media: add glossary.rst with a glossary of terms used at V4L2 spec

2017-10-06 Thread Sakari Ailus
ISP drivers. > > We have drivers for things implemented via ISP. However, right now, > there's no distinction at the driver if the functionality is implemented > on software (ISP) or in hardware. > > > > > > confusing, as an ISP hardware may actually implemen

Re: [PATCH v5 1/7] media: add glossary.rst with a glossary of terms used at V4L2 spec

2017-10-06 Thread Sakari Ailus
On Thu, Oct 05, 2017 at 03:39:29PM -0300, Mauro Carvalho Chehab wrote: > Em Thu, 5 Oct 2017 11:21:07 +0300 > Sakari Ailus escreveu: > > > Hi Mauro, > > > > My apologies for the late reply. > > > > On Tue, Aug 29, 2017 at 10:07:50AM -0300, Mauro Carvalho

Re: [PATCH v5 1/7] media: add glossary.rst with a glossary of terms used at V4L2 spec

2017-10-05 Thread Sakari Ailus
Hi Mauro, My apologies for the late reply. On Tue, Aug 29, 2017 at 10:07:50AM -0300, Mauro Carvalho Chehab wrote: > Em Tue, 29 Aug 2017 10:47:48 +0300 > Sakari Ailus escreveu: > > > Hi Mauro, > > > > Thanks for the update. A few comments below. > > >

Re: [PATCH v2 13/17] media: v4l2-async: simplify v4l2_async_subdev structure

2017-09-29 Thread Sakari Ailus
Hi Mauro, (Removing the non-list recipients.) On Fri, Sep 29, 2017 at 06:27:13AM -0300, Mauro Carvalho Chehab wrote: > Em Thu, 28 Sep 2017 15:09:21 +0300 > Sakari Ailus escreveu: > > > Hi Mauro, > > > > On Wed, Sep 27, 2017 at 06:46:56PM -0300, Mauro Carva

Re: [PATCH v7 6/7] media: videodev2: add a flag for MC-centric devices

2017-09-28 Thread Sakari Ailus
On Wed, Sep 27, 2017 at 07:23:48PM -0300, Mauro Carvalho Chehab wrote: > As both vdev-centric and MC-centric devices may implement the > same APIs, we need a flag to allow userspace to distinguish > between them. > > Signed-off-by: Mauro Carvalho Chehab Acked-by: Sakari Ailus -

Re: [PATCH v7 7/7] media: open.rst: add a notice about subdev-API on vdev-centric

2017-09-28 Thread Sakari Ailus
support some subdev-specific > controls. > > Signed-off-by: Mauro Carvalho Chehab Thanks! Acked-by: Sakari Ailus -- Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.

Re: [RESEND PATCH v2 13/17] media: v4l2-async: simplify v4l2_async_subdev structure

2017-09-28 Thread Sakari Ailus
interface with that name, fwnode property API is just an API. -- Kind regards, Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [RESEND PATCH v2 13/17] media: v4l2-async: simplify v4l2_async_subdev structure

2017-09-28 Thread Sakari Ailus
interface with that name, fwnode property API is just an API. -- Kind regards, Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH v2 00/17] V4L cleanups and documentation improvements

2017-09-28 Thread Sakari Ailus
union at async match struct > media: v4l2-ctrls: document nested members of structs > media: videobuf2-core: improve kernel-doc markups > media: media-entity.h: add kernel-doc markups for nested structs For patches apart form 7 and 13 (see my comments to them): Acked-by: Sakari

Re: [PATCH v2 07/17] media: v4l2-event.rst: improve events description

2017-09-28 Thread Sakari Ailus
ffer/g With that, Acked-by: Sakari Ailus > name is, instead, v4l2_kevent; > > - Some things are mentioned on both places (with different words), > others are either on one of the files. > > In order to cleanup this mess, put everything at v4l2-event.rst > and improve

Re: [PATCH v2 12/17] media: v4l2-fwnode.h: better describe bus union at fwnode endpoint struct

2017-09-28 Thread Sakari Ailus
liance/ Same below. Please see: https://mipi.org/content/what-does-mipi-stand> With that, Acked-by: Sakari Ailus > + * Interface's Camera Serial Interface version 1 > + * (MIPI CSI1) or Standard Mobile Imaging Architecture's &g

Re: [PATCH 1/2] docs-rst: media: Don't use \small for V4L2_PIX_FMT_SRGGB10 documentation

2017-09-05 Thread Sakari Ailus
Hi Mauro, On Mon, Sep 04, 2017 at 05:41:27PM -0300, Mauro Carvalho Chehab wrote: > From: Sakari Ailus > > There appears to be an issue in using \small in certain cases on Sphinx > 1.4 and 1.5. Other format documents don't use \small either, remove it > from here as w

[PATCH 1/1] docs-rst: media: Don't use \small for V4L2_PIX_FMT_SRGGB10 documentation

2017-09-03 Thread Sakari Ailus
There appears to be an issue in using \small in certain cases on Sphinx 1.4 and 1.5. Other format documents don't use \small either, remove it from here as well. Signed-off-by: Sakari Ailus --- Hi Mauro, What would you think of this as an alternative approach? No hacks needed. J

Re: [PATCH v5 3/7] media: open.rst: remove the minor number range

2017-08-29 Thread Sakari Ailus
be true. In any case, > this is not relevant, as udev will take care of it. > > So, remove this useless misinformation. > > Acked-by: Hans Verkuil > Signed-off-by: Mauro Carvalho Chehab Acked-by: Sakari Ailus -- Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe

Re: [PATCH v5 2/7] media: open.rst: better document device node naming

2017-08-29 Thread Sakari Ailus
_USB_Camera-B4.04.27.1-video-index0 -> > ../../video0 > + └── by-path > + └── pci-:00:14.0-usb-0:2:1.0-video-index0 -> ../../video0 > + > + > Many drivers support "video_nr", "radio_nr" or "vbi_nr" module > options to sel

Re: [PATCH v5 1/7] media: add glossary.rst with a glossary of terms used at V4L2 spec

2017-08-29 Thread Sakari Ailus
ine. > + > + See :ref:`subdev`. > + > +Vdev-centric > + V4L2 hardware that it is controlled via V4L2 device nodes. > + > + See :ref:`v4l2_hardware_control`. > diff --git a/Documentation/media/uapi/v4l/v4l2.rst > b/Documentation/media/uapi/v4l/v4l2.rst > index f52a11c949d3..1ee4b86d18e1 100644 > --- a/Documentation/media/uapi/v4l/v4l2.rst > +++ b/Documentation/media/uapi/v4l/v4l2.rst > @@ -31,6 +31,7 @@ This part describes the Video for Linux API version 2 (V4L2 > API) specification. > videodev > capture-example > v4l2grab-example > +glossary > biblio > > -- Kind regards, Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH 1/3] media: open.rst: document devnode-centric and mc-centric types

2017-08-25 Thread Sakari Ailus
ote:: > + > + A **vdev-centric** may optionally expose V4L2 sub-devices via > + :ref:`sub-device API `. In that case, it has to implement > + the :ref:`media controller API ` as well. Looks good! > + > + > + > +.. _v4l2_device_naming: > > Device Naming > = -- Kind regards, Sakari Ailus e-mail: sakari.ai...@iki.fi -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH RFC v2] media: open.rst: document devnode-centric and mc-centric types

2017-08-24 Thread Sakari Ailus
note:: > + > + It is forbidden for **device-centric** devices to expose V4L2 > + sub-devices via :ref:`sub-device API `, although this > + might change in the future. I believe we agree on the subject matter but we can still argue. :-D Could you drop ", although this might change in

Re: [PATCH RFC] media: open.rst: document devnode-centric and mc-centric types

2017-08-24 Thread Sakari Ailus
Hi Mauro, On Wed, Aug 23, 2017 at 10:42:28AM -0300, Mauro Carvalho Chehab wrote: > Em Wed, 23 Aug 2017 12:37:30 +0300 > Sakari Ailus escreveu: > > > Hi Mauro, > > > > Thanks for the patch! Something like this was long due. > > > > I cc'd

Re: [PATCH RFC] media: open.rst: document devnode-centric and mc-centric types

2017-08-23 Thread Sakari Ailus
is a pain without MC. Less variance in interface availability is better for the user space, and unlike between video node centric vs. MC-centric, there are hardly technical reasons (or at least I can't remember one) for doing this. I remember we had a few of these drivers and the agreement was to add MC interfac

[PATCH 1/1] docs: nfsroot: Document that nfsvers=2 is the default

2017-07-05 Thread Sakari Ailus
Nfsroot uses nfsvers=2 by default (as in fs/nfs/nfsroot.c), unlike is specified in a modern nfs man page. Document this. Signed-off-by: Sakari Ailus --- Hi all, I just figured out that NFS v2 is the default version when mounting root over NFS. It'd be nice to tell in documentation th