From: Tomasz Figa <tfiga@chromium.org>
To: Hans Verkuil <hverkuil-cisco@xs4all.nl>,
Alexandre Courbot <acourbot@chromium.org>
Cc: Linux Media Mailing List <linux-media@vger.kernel.org>
Subject: Re: [PATCH 3/3] Documentation/media: rename "Codec Interface"
Date: Wed, 23 Jan 2019 12:46:17 +0900 [thread overview]
Message-ID: <CAAFQd5C4-nxgUb=ufhga9w+267EpeDzGobz2nVaLrcBwxc3DwQ@mail.gmail.com> (raw)
In-Reply-To: <CAAFQd5DDGJnRMFq+f5o4YzOaRPPWUzWWr6woOeEa8+tBUz_1fQ@mail.gmail.com>
On Wed, Jan 23, 2019 at 12:17 PM Tomasz Figa <tfiga@chromium.org> wrote:
>
> Hi Hans,
>
> On Tue, Jan 22, 2019 at 8:27 PM <hverkuil-cisco@xs4all.nl> wrote:
> >
> > From: Hans Verkuil <hverkuil-cisco@xs4all.nl>
> >
> > The "Codec Interface" chapter is poorly named since codecs are just one
> > use-case of the Memory-to-Memory Interface. Rename it and clean up the
> > text a bit.
> >
> > Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
> > ---
> > .../media/uapi/mediactl/request-api.rst | 4 ++--
> > .../v4l/{dev-codec.rst => dev-mem2mem.rst} | 21 +++++++------------
> > Documentation/media/uapi/v4l/devices.rst | 2 +-
> > .../media/uapi/v4l/pixfmt-compressed.rst | 2 +-
> > Documentation/media/uapi/v4l/vidioc-qbuf.rst | 2 +-
> > 5 files changed, 13 insertions(+), 18 deletions(-)
> > rename Documentation/media/uapi/v4l/{dev-codec.rst => dev-mem2mem.rst} (79%)
> >
>
> Thanks for this cleanup! Indeed it makes much more sense with your
> changes. Some comments inline.
>
> > diff --git a/Documentation/media/uapi/mediactl/request-api.rst b/Documentation/media/uapi/mediactl/request-api.rst
> > index 4b25ad03f45a..1ad631e549fe 100644
> > --- a/Documentation/media/uapi/mediactl/request-api.rst
> > +++ b/Documentation/media/uapi/mediactl/request-api.rst
> > @@ -91,7 +91,7 @@ A request must contain at least one buffer, otherwise ``ENOENT`` is returned.
> > A queued request cannot be modified anymore.
> >
> > .. caution::
> > - For :ref:`memory-to-memory devices <codec>` you can use requests only for
> > + For :ref:`memory-to-memory devices <mem2mem>` you can use requests only for
> > output buffers, not for capture buffers. Attempting to add a capture buffer
> > to a request will result in an ``EACCES`` error.
> >
> > @@ -152,7 +152,7 @@ if it had just been allocated.
> > Example for a Codec Device
> > --------------------------
> >
> > -For use-cases such as :ref:`codecs <codec>`, the request API can be used
> > +For use-cases such as :ref:`codecs <mem2mem>`, the request API can be used
>
> I guess this should eventually be made to point to the codec sections.
> Alex, perhaps it would make sense to do it in your documentation
> patch.
>
> > to associate specific controls to
> > be applied by the driver for the OUTPUT buffer, allowing user-space
> > to queue many such buffers in advance. It can also take advantage of requests'
> > diff --git a/Documentation/media/uapi/v4l/dev-codec.rst b/Documentation/media/uapi/v4l/dev-mem2mem.rst
> > similarity index 79%
> > rename from Documentation/media/uapi/v4l/dev-codec.rst
> > rename to Documentation/media/uapi/v4l/dev-mem2mem.rst
> > index b5e017c17834..69efcc747588 100644
> > --- a/Documentation/media/uapi/v4l/dev-codec.rst
> > +++ b/Documentation/media/uapi/v4l/dev-mem2mem.rst
> > @@ -7,11 +7,11 @@
> > ..
> > .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
> >
> > -.. _codec:
> > +.. _mem2mem:
> >
> > -***************
> > -Codec Interface
> > -***************
> > +********************************
> > +Video Memory To Memory Interface
> > +********************************
> >
Also to bikeshed a bit, the text seems to follow the
"memory-to-memory" convention, so perhaps "Video Memory-to-memory
Interface" would be more consistent?
Best regards,
Tomasz
next prev parent reply other threads:[~2019-01-23 3:46 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-01-22 11:27 [PATCH 0/3] Documentation cleanups hverkuil-cisco
2019-01-22 11:27 ` [PATCH 1/3] dev-effect.rst: remove unused Effect Interface chapter hverkuil-cisco
2019-01-22 11:27 ` [PATCH 2/3] dev-teletext.rst: remove obsolete teletext interface hverkuil-cisco
2019-01-22 11:27 ` [PATCH 3/3] Documentation/media: rename "Codec Interface" hverkuil-cisco
2019-01-23 3:17 ` Tomasz Figa
2019-01-23 3:46 ` Tomasz Figa [this message]
2019-01-23 8:07 ` [PATCHv2 " Hans Verkuil
2019-01-24 5:35 ` Tomasz Figa
2019-01-25 6:31 ` Alexandre Courbot
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CAAFQd5C4-nxgUb=ufhga9w+267EpeDzGobz2nVaLrcBwxc3DwQ@mail.gmail.com' \
--to=tfiga@chromium.org \
--cc=acourbot@chromium.org \
--cc=hverkuil-cisco@xs4all.nl \
--cc=linux-media@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).