[libcamera-devel,v2] Implementation was spelled incorrectly in the pipeline-handler documentation
diff mbox series

Message ID 20230225134045.5350-1-advaitdhamorikar@gmail.com
State Accepted
Commit cee03cd183126d1e0828c8ae2cc8706de2404b73
Headers show
Series
  • [libcamera-devel,v2] Implementation was spelled incorrectly in the pipeline-handler documentation
Related show

Commit Message

Advait Dhamorikar Feb. 25, 2023, 1:40 p.m. UTC
Signed-off-by: Advait Dhamorikar <advaitdhamorikar@gmail.com>
---
 Documentation/guides/pipeline-handler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Comments

Jacopo Mondi Feb. 26, 2023, 1:17 p.m. UTC | #1
Hello Advait

   thanks for the patch

On Sat, Feb 25, 2023 at 07:10:45PM +0530, Advait Dhamorikar via libcamera-devel wrote:
> Signed-off-by: Advait Dhamorikar <advaitdhamorikar@gmail.com>

A few notes about the submission process
- The commit subject should ideally be shorter than 80 columns and
  should report what component is modified. As an example

  documentation: guides: pipeline-handler: Fix spelling error

- We usually require a little commit message even for simple patches
  In this case something like:

  Fix wrong spelling of "impelementation" in the pipeline handler
  development guide.

libcamera provides git hooks in utils/hooks that help you catch these
errors early. You can install them by copying them in your
.git/hooks/ directory.

> ---
>  Documentation/guides/pipeline-handler.rst | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/guides/pipeline-handler.rst b/Documentation/guides/pipeline-handler.rst
> index e1930fdf..4d38fa23 100644
> --- a/Documentation/guides/pipeline-handler.rst
> +++ b/Documentation/guides/pipeline-handler.rst
> @@ -1409,7 +1409,7 @@ function to the V4L2 device buffer signal.
>     video_->bufferReady.connect(this, &VividCameraData::bufferReady);
>
>  Create the matching ``VividCameraData::bufferReady`` function after your
> -VividCameradata::init() impelementation.
> +VividCameradata::init() implementation.

The patch itself looks correct.

>
>  The ``bufferReady`` function obtains the request from the buffer using the
>  ``request`` function, and notifies the ``Camera`` that the buffer and
> --
> 2.34.1
>
Laurent Pinchart Feb. 26, 2023, 3:27 p.m. UTC | #2
On Sun, Feb 26, 2023 at 02:17:24PM +0100, Jacopo Mondi via libcamera-devel wrote:
> Hello Advait
> 
>    thanks for the patch
> 
> On Sat, Feb 25, 2023 at 07:10:45PM +0530, Advait Dhamorikar via libcamera-devel wrote:
> > Signed-off-by: Advait Dhamorikar <advaitdhamorikar@gmail.com>
> 
> A few notes about the submission process
> - The commit subject should ideally be shorter than 80 columns and
>   should report what component is modified. As an example
> 
>   documentation: guides: pipeline-handler: Fix spelling error
> 
> - We usually require a little commit message even for simple patches
>   In this case something like:
> 
>   Fix wrong spelling of "impelementation" in the pipeline handler
>   development guide.
> 
> libcamera provides git hooks in utils/hooks that help you catch these
> errors early. You can install them by copying them in your
> .git/hooks/ directory.

Note that there are both pre-commit and post-commit hooks, only one of
them is necessary. I recommend the post-commit hook, as it catches
issues in the git commit message that the pre-commit hook doesn't catch.

> > ---
> >  Documentation/guides/pipeline-handler.rst | 2 +-
> >  1 file changed, 1 insertion(+), 1 deletion(-)
> >
> > diff --git a/Documentation/guides/pipeline-handler.rst b/Documentation/guides/pipeline-handler.rst
> > index e1930fdf..4d38fa23 100644
> > --- a/Documentation/guides/pipeline-handler.rst
> > +++ b/Documentation/guides/pipeline-handler.rst
> > @@ -1409,7 +1409,7 @@ function to the V4L2 device buffer signal.
> >     video_->bufferReady.connect(this, &VividCameraData::bufferReady);
> >
> >  Create the matching ``VividCameraData::bufferReady`` function after your
> > -VividCameradata::init() impelementation.
> > +VividCameradata::init() implementation.
> 
> The patch itself looks correct.
> 
> >
> >  The ``bufferReady`` function obtains the request from the buffer using the
> >  ``request`` function, and notifies the ``Camera`` that the buffer and

Patch
diff mbox series

diff --git a/Documentation/guides/pipeline-handler.rst b/Documentation/guides/pipeline-handler.rst
index e1930fdf..4d38fa23 100644
--- a/Documentation/guides/pipeline-handler.rst
+++ b/Documentation/guides/pipeline-handler.rst
@@ -1409,7 +1409,7 @@  function to the V4L2 device buffer signal.
    video_->bufferReady.connect(this, &VividCameraData::bufferReady);
 
 Create the matching ``VividCameraData::bufferReady`` function after your
-VividCameradata::init() impelementation.
+VividCameradata::init() implementation.
 
 The ``bufferReady`` function obtains the request from the buffer using the
 ``request`` function, and notifies the ``Camera`` that the buffer and