GitHub/moto-9609/android_kernel_motorola_exynos9610.git
8 years ago[media] doc-rst: split media_drivers.rst into one file per API type
Mauro Carvalho Chehab [Sun, 17 Jul 2016 11:22:23 +0000 (08:22 -0300)]
[media] doc-rst: split media_drivers.rst into one file per API type

Just like the uAPI book is split into parts, let's split the
kAPI documentation. That should make easier to maintain, and
will split the final documentation into smaller html files.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: media_drivers.rst: Fix paragraph headers for MC
Mauro Carvalho Chehab [Sun, 17 Jul 2016 11:15:08 +0000 (08:15 -0300)]
[media] doc-rst: media_drivers.rst: Fix paragraph headers for MC

Fix the paragraph identation for the media controller
headers.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: Convert media API to rst
Mauro Carvalho Chehab [Sun, 17 Jul 2016 10:20:06 +0000 (07:20 -0300)]
[media] doc-rst: Convert media API to rst

Move the contents of the media section at
DocBooks/DocBook/device-drivers.tmpl to a new ReST book.

For now, the contents is kept as-is. Next patches will fix
the warnings and add cross-references that were removed due to
the conversion.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: Fix compilation of the pdf docbook
Mauro Carvalho Chehab [Fri, 15 Jul 2016 10:42:08 +0000 (07:42 -0300)]
doc-rst: Fix compilation of the pdf docbook

The rst2pdf tool is a very broken toolchain, with is not capable
of parsing complex documents. As such, it doesn't build the
media book, failing with:

[ERROR] pdfbuilder.py:130 too many values to unpack

(using rst2pdf version 0.93.dev-r0 and Sphinx version 1.4.5)

So, make it build only the books we know that are safe to build.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
--

Btw, with the standard Sphinx version shipped on Fedora 24 (Sphinx
1.3.1), rst2pdf doesn't build even the simple kernel-documentation,
failing with this error:
    writing Kernel... [ERROR] pdfbuilder.py:130 list index out of range

This is a known bug:
    https://github.com/sphinx-doc/sphinx/issues/1844

So, maybe we should just disable pdf generation from RST for good,
as I suspect that maintaining it with a broken toolchain will be a
big headache.

8 years agoMerge branch 'docs-next' of git://git.lwn.net/linux into devel/docs-next
Mauro Carvalho Chehab [Fri, 15 Jul 2016 10:33:47 +0000 (07:33 -0300)]
Merge branch 'docs-next' of git://git.lwn.net/linux into devel/docs-next

* 'docs-next' of git://git.lwn.net/linux:
  doc-rst: add an option to ignore DocBooks when generating docs
  workqueue: Fix a typo in workqueue.txt
  Doc: ocfs: Fix typo in filesystems/ocfs2-online-filecheck.txt
  Documentation/sphinx: skip build if user requested specific DOCBOOKS
  Documentation: add cleanmediadocs to the documentation targets

8 years ago[media] docs-rst: Fix some typos
Mauro Carvalho Chehab [Wed, 13 Jul 2016 14:45:48 +0000 (11:45 -0300)]
[media] docs-rst: Fix some typos

Those fixes came from patchs from Andrea for the old DocBook
documentation.

As we're removing it on Kernel 4.8, it doesn't make sense to
apply the original patches, but, as the typos were ported
to ReST, let's fix the issues there.

Suggested-by: Andrea Gelmini <andrea.gelmini@gelma.net>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: increase depth of the main index
Mauro Carvalho Chehab [Wed, 13 Jul 2016 13:50:34 +0000 (10:50 -0300)]
[media] doc-rst: increase depth of the main index

It is useful to have an index with all the book contents somewhere,
as it makes easier to seek for something. So, increase maxdepth
to 5 for the main index at the beginning of the book.

While here, remove the genindex content, as it is bogus.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: fix an undefined reference
Mauro Carvalho Chehab [Wed, 13 Jul 2016 13:22:38 +0000 (10:22 -0300)]
[media] doc-rst: fix an undefined reference

Documentation/media/uapi/cec/cec-ioc-dqevent.rst:43: WARNING: undefined label: cec_event_state_change (if the link has no caption the label must precede a section header)

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: improve CEC documentation
Hans Verkuil [Wed, 13 Jul 2016 11:48:54 +0000 (08:48 -0300)]
[media] doc-rst: improve CEC documentation

Lots of fixups relating to references.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: fix htmldocs build warnings
Mauro Carvalho Chehab [Wed, 13 Jul 2016 12:11:12 +0000 (09:11 -0300)]
[media] doc-rst: fix htmldocs build warnings

Fix those warnings:
Documentation/output/videodev2.h.rst:6: WARNING: undefined label: vidioc_unsubscribe_event (if the link has no caption the label must precede a section header)
Documentation/media/uapi/v4l/dev-overlay.rst:248: WARNING: Title underline too short.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agoRevert "[media] docs-rst: escape [] characters"
Mauro Carvalho Chehab [Wed, 13 Jul 2016 11:43:30 +0000 (08:43 -0300)]
Revert "[media] docs-rst: escape [] characters"

This patch touches on places where it shouldn't: image
files and code examples. Also, it doesn't fix all array
occurrences.

So, let's revert it.

This reverts commit ffbab694ede33c294e5864a5e0bf4d1474446a71.

8 years ago[media] doc-rst: update CEC_RECEIVE
Hans Verkuil [Tue, 12 Jul 2016 18:07:44 +0000 (15:07 -0300)]
[media] doc-rst: update CEC_RECEIVE

The timestamp field was split into rx_ts and tx_ts, and the rx/tx_status
fields were moved. Update the doc accordingly.

Also fix a bug that stated that a non-zero tx_status field signaled an
error. That's not true, since TX_STATUS_OK is 1, not 0.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] docs-rst: escape [] characters
Mauro Carvalho Chehab [Tue, 12 Jul 2016 18:20:11 +0000 (15:20 -0300)]
[media] docs-rst: escape [] characters

Those characters are used for citations. Better to escape, to
avoid them to be misinterpreted.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: use the right markup for footnotes
Mauro Carvalho Chehab [Tue, 12 Jul 2016 18:15:23 +0000 (15:15 -0300)]
[media] doc-rst: use the right markup for footnotes

According with ReST spec, footnotes should be like:
[#name], and not [name]. So, change them.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] vidioc-g-dv-timings.rst: document interlaced defines
Hans Verkuil [Tue, 12 Jul 2016 14:39:37 +0000 (11:39 -0300)]
[media] vidioc-g-dv-timings.rst: document interlaced defines

Document V4L2_DV_PROGRESSIVE and V4L2_DV_INTERLACED and
fix missing references.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] pixfmt-006.rst: add missing V4L2_YCBCR_ENC_SMPTE240M
Hans Verkuil [Tue, 12 Jul 2016 14:31:15 +0000 (11:31 -0300)]
[media] pixfmt-006.rst: add missing V4L2_YCBCR_ENC_SMPTE240M

Fix missing documentation, and its cross reference.

Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: fix a missing reference for V4L2_BUF_FLAG_LAST
Mauro Carvalho Chehab [Tue, 12 Jul 2016 14:49:17 +0000 (11:49 -0300)]
[media] doc-rst: fix a missing reference for V4L2_BUF_FLAG_LAST

Fix it by adding a header to the flat-table to match to
the list of define symbols.

As a side-effect, it also removes some exceptions from
videodev2.h.rst.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: reorganize LIRC ReST files
Mauro Carvalho Chehab [Tue, 12 Jul 2016 12:35:26 +0000 (09:35 -0300)]
[media] doc-rst: reorganize LIRC ReST files

Reorganize the LIRC rst files, using "-" instead of "_" on
their names, and creating a separate chapter for syscalls.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document LIRC set mode ioctls
Mauro Carvalho Chehab [Tue, 12 Jul 2016 12:11:08 +0000 (09:11 -0300)]
[media] doc-rst: document LIRC set mode ioctls

Add LIRC_SET_[REC|SEND]_MODE ioctls to the corresponding
GET functions, and put all LIRC modes altogether.

As now everything is already documented on its own ioctl
pages, get rid of lirc_ioctl.rst.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document LIRC_SET_WIDEBAND_RECEIVER
Mauro Carvalho Chehab [Tue, 12 Jul 2016 11:10:50 +0000 (08:10 -0300)]
[media] doc-rst: document LIRC_SET_WIDEBAND_RECEIVER

Put documentation for this ioctl on a separate page and
improve it.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: add documentation for LIRC_SET_MEASURE_CARRIER_MODE
Mauro Carvalho Chehab [Tue, 12 Jul 2016 11:05:03 +0000 (08:05 -0300)]
[media] doc-rst: add documentation for LIRC_SET_MEASURE_CARRIER_MODE

Place documentation for this ioctl on its own page.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document LIRC_SET_REC_TIMEOUT_REPORTS
Mauro Carvalho Chehab [Tue, 12 Jul 2016 10:56:28 +0000 (07:56 -0300)]
[media] doc-rst: document LIRC_SET_REC_TIMEOUT_REPORTS

Add a separate page for this ioctl and improve its documentation.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document LIRC_SET_REC_TIMEOUT
Mauro Carvalho Chehab [Tue, 12 Jul 2016 10:49:00 +0000 (07:49 -0300)]
[media] doc-rst: document LIRC_SET_REC_TIMEOUT

Add a separate page for this ioctl and adds the cross-references.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document LIRC_SET_TRANSMITTER_MASK
Mauro Carvalho Chehab [Tue, 12 Jul 2016 10:38:58 +0000 (07:38 -0300)]
[media] doc-rst: document LIRC_SET_TRANSMITTER_MASK

Add proper documentation for this ioctl, providing some
additional information about its usage.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document LIRC set carrier ioctls
Mauro Carvalho Chehab [Tue, 12 Jul 2016 10:21:23 +0000 (07:21 -0300)]
[media] doc-rst: document LIRC set carrier ioctls

Put each ioctl on its own page and improve documentation, adding
cross-references for LIRC_SET_REC_CARRIER_RANGE and LIRC_SET_REC_CARRIER,
with can be used together to set a carrier frequency range.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document LIRC_GET_LENGTH ioctl
Mauro Carvalho Chehab [Tue, 12 Jul 2016 09:49:06 +0000 (06:49 -0300)]
[media] doc-rst: document LIRC_GET_LENGTH ioctl

Put documentation for this ioctl on its own page.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document LIRC_GET_*_TIMEOUT ioctls
Mauro Carvalho Chehab [Mon, 11 Jul 2016 11:36:29 +0000 (08:36 -0300)]
[media] doc-rst: document LIRC_GET_*_TIMEOUT ioctls

Improve the documentation for those ioctls, adding them to
a separate file, in order to look like the rest of the
book, and to later allow to generate a man page for those
ioctls.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document LIRC_SET_SEND_DUTY_CYCLE
Mauro Carvalho Chehab [Mon, 11 Jul 2016 02:27:31 +0000 (23:27 -0300)]
[media] doc-rst: document LIRC_SET_SEND_DUTY_CYCLE

Add a separate page for this ioctl.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document LIRC_GET_REC_RESOLUTION
Mauro Carvalho Chehab [Mon, 11 Jul 2016 11:25:30 +0000 (08:25 -0300)]
[media] doc-rst: document LIRC_GET_REC_RESOLUTION

Improve the documentation for this ioctl, adding it to
a separate file, in order to look like the rest of the
book, and to later allow to generate a man page for this
ioctl.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document ioctl LIRC_GET_REC_MODE
Mauro Carvalho Chehab [Mon, 11 Jul 2016 01:46:12 +0000 (22:46 -0300)]
[media] doc-rst: document ioctl LIRC_GET_REC_MODE

Move the documentation of this ioctl from lirc_ioctl to its
own file, and add a short description about the pulse mode
used by IR RX.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: fix some lirc cross-references
Mauro Carvalho Chehab [Tue, 12 Jul 2016 09:12:32 +0000 (06:12 -0300)]
[media] doc-rst: fix some lirc cross-references

Some references were broken. It was also mentioning LIRC_MODE_RAW,
with it is not implemented on current LIRC drivers.

So, fix the references.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: document ioctl LIRC_GET_SEND_MODE
Mauro Carvalho Chehab [Mon, 11 Jul 2016 01:35:21 +0000 (22:35 -0300)]
[media] doc-rst: document ioctl LIRC_GET_SEND_MODE

Move the documentation of this ioctl from lirc_ioctl to its
own file, and add a short description about the pulse mode
used by IR TX.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: Fix LIRC_GET_FEATURES references
Mauro Carvalho Chehab [Mon, 11 Jul 2016 14:46:57 +0000 (11:46 -0300)]
[media] doc-rst: Fix LIRC_GET_FEATURES references

The references pointed by LIRC_GET_FEATURES ioctl are broken.

Fix them.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: remove not used ioctls from documentation
Mauro Carvalho Chehab [Mon, 11 Jul 2016 13:27:32 +0000 (10:27 -0300)]
[media] doc-rst: remove not used ioctls from documentation

As we removed those ioctls from the header file, do the
same at the documentation side.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] lirc.h: remove several unused ioctls
Mauro Carvalho Chehab [Mon, 11 Jul 2016 12:45:32 +0000 (09:45 -0300)]
[media] lirc.h: remove several unused ioctls

While reviewing the documentation gaps on LIRC, it was
noticed that several ioctls aren't used by any LIRC drivers
(nor at staging or mainstream).

It doesn't make sense to document them, as they're not used
anywhere. So, let's remove those from the lirc header.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: add media/uapi/rc/lirc-header.rst
Mauro Carvalho Chehab [Mon, 11 Jul 2016 13:25:00 +0000 (10:25 -0300)]
[media] doc-rst: add media/uapi/rc/lirc-header.rst

changeset 68cd5e0bed99 ("[media] doc-rst: add LIRC header to the book")
did everything but adding the lirc-reader.rst :-p

My fault: I forgot to do a git add for this guy on such
changeset.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: Document ioctl LIRC_GET_FEATURES
Mauro Carvalho Chehab [Mon, 11 Jul 2016 01:33:57 +0000 (22:33 -0300)]
[media] doc-rst: Document ioctl LIRC_GET_FEATURES

The documentation for this ioctl was really crappy.

Add a better documentation, using the lirc.4 man pages as a
reference, plus what was written originally at the lirc-ioctl.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: improve display of notes and warnings
Mauro Carvalho Chehab [Sun, 10 Jul 2016 14:57:43 +0000 (11:57 -0300)]
[media] doc-rst: improve display of notes and warnings

There are several notes and warning mesages in the middle of
the media docbook. Use the ReST tags for that, as it makes
them visually better and hightlights them.

While here, modify a few ones to make them clearer.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: improve DTV_BANDWIDTH_HZ notes
Mauro Carvalho Chehab [Sun, 10 Jul 2016 12:48:58 +0000 (09:48 -0300)]
[media] doc-rst: improve DTV_BANDWIDTH_HZ notes

There are several notes for this DTV property. Some are
outdated, so take some care of it, making it updated.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: improve documentation for DTV_FREQUENCY
Mauro Carvalho Chehab [Sun, 10 Jul 2016 12:33:26 +0000 (09:33 -0300)]
[media] doc-rst: improve documentation for DTV_FREQUENCY

Make the note better formatted and documented.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: Don't use captions for examples
Mauro Carvalho Chehab [Sun, 10 Jul 2016 11:22:19 +0000 (08:22 -0300)]
[media] doc-rst: Don't use captions for examples

Unfortunately, captions are new on Sphinx for c blocks: it was
added only on version 1.3. Also, it were already bad enough
not being able to auto-numerate them.

So, let's give up and use, instead, titles before the examples.
Not much is lost, and, as a side track, we don't need to
numerate them anymore.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: do cross-references between header and the doc
Mauro Carvalho Chehab [Sun, 10 Jul 2016 10:42:58 +0000 (07:42 -0300)]
[media] doc-rst: do cross-references between header and the doc

Now that the LIRC header was added, we can cross-reference it
and identify the documentation gaps.

There are lots of stuff missing there, but at least now we
can avoid the gap to increase.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: add LIRC header to the book
Mauro Carvalho Chehab [Sun, 10 Jul 2016 10:18:52 +0000 (07:18 -0300)]
[media] doc-rst: add LIRC header to the book

Just like the other parts of the document, let's add the LIRC
header, as it is part of the API.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: improve LIRC syscall documentation
Mauro Carvalho Chehab [Sun, 10 Jul 2016 00:03:57 +0000 (21:03 -0300)]
[media] doc-rst: improve LIRC syscall documentation

The lirc syscall documentation uses a very different and
simplified way than the rest of the media book. make it
closer. Still, there's just one page for all ioctls.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: rename some RC files
Mauro Carvalho Chehab [Sat, 9 Jul 2016 23:37:04 +0000 (20:37 -0300)]
[media] doc-rst: rename some RC files

Some files start with an upper letter. Also, they have big
names. rename them.

No functional changes.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: remove an extra label on V4L2 and CEC parts
Mauro Carvalho Chehab [Sat, 9 Jul 2016 23:33:11 +0000 (20:33 -0300)]
[media] doc-rst: remove an extra label on V4L2 and CEC parts

There's no need to say: Table of Contents there. Also, this
generates a duplicated caption xref. So, remove, to use the
same format on every part.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: Group function references together for MC
Mauro Carvalho Chehab [Sat, 9 Jul 2016 22:58:33 +0000 (19:58 -0300)]
[media] doc-rst: Group function references together for MC

Just like the other parts of the media book, group the MC
functions together on one chapter.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: add an option to ignore DocBooks when generating docs
Mauro Carvalho Chehab [Sat, 9 Jul 2016 16:12:45 +0000 (13:12 -0300)]
doc-rst: add an option to ignore DocBooks when generating docs

Sometimes, we want to do a partial build, instead of building
everything. However, right now, if one wants to build just
Sphinx books, it will build also the DocBooks.

Add an option to allow to ignore all DocBooks when building
documentation.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
8 years ago[media] doc-rst: media: reordered top sectioning
Markus Heiser [Sat, 9 Jul 2016 15:06:26 +0000 (12:06 -0300)]
[media] doc-rst: media: reordered top sectioning

Within the old section hierarchy, all doc parts has been placed under
the introduction, e.g:

* Linux Media Infrastructure API
    + Introduction
        - Video for Linux API
        - Digital TV API
        - ...

With separating the introduction sibling to the other parts
we get a more common section hierarchy:

* Linux Media Infrastructure API
    + Introduction
    + Video for Linux API
    + Digital TV API
    + ...

BTW: compacting the intro text.

This patch is on top of media_tree/docs-next

Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
8 years ago[media] doc-rst: make CEC look more like other parts of the book
Mauro Carvalho Chehab [Sat, 9 Jul 2016 14:20:46 +0000 (11:20 -0300)]
[media] doc-rst: make CEC look more like other parts of the book

Better organize the contents of the CEC part, moving the
introduction to chapter 1, placing all ioctls at chapter 2
and numerating all chapters and items.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: add CEC header file to the documentation
Mauro Carvalho Chehab [Sat, 9 Jul 2016 13:25:05 +0000 (10:25 -0300)]
[media] doc-rst: add CEC header file to the documentation

Adding the header file is interesting for several reasons:

1) It makes MC documentation consistend with other parts;
2) The header file can be used as a quick index to all API
   elements;
3) The cross-reference check helps to identify symbols that
   aren't documented.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agoMerge branch 'topic/cec' into topic/docs-next
Mauro Carvalho Chehab [Sat, 9 Jul 2016 13:21:36 +0000 (10:21 -0300)]
Merge branch 'topic/cec' into topic/docs-next

* topic/cec:
  [media] DocBook/media: add CEC documentation
  [media] s5p_cec: get rid of an unused var
  [media] move s5p-cec to staging
  [media] vivid: add CEC emulation
  [media] cec: s5p-cec: Add s5p-cec driver
  [media] cec: adv7511: add cec support
  [media] cec: adv7842: add cec support
  [media] cec: adv7604: add cec support
  [media] cec: add compat32 ioctl support
  [media] cec/TODO: add TODO file so we know why this is still in staging
  [media] cec: add HDMI CEC framework (api)
  [media] cec: add HDMI CEC framework (adapter)
  [media] cec: add HDMI CEC framework (core)
  [media] cec-funcs.h: static inlines to pack/unpack CEC messages
  [media] cec.h: add cec header
  [media] cec-edid: add module for EDID CEC helper functions
  [media] cec.txt: add CEC framework documentation
  [media] rc: Add HDMI CEC protocol handling
  Input: add HDMI CEC specific keycodes
  Input: add BUS_CEC type

8 years ago[media] doc-rst: add media.h header to media contrller
Mauro Carvalho Chehab [Sat, 9 Jul 2016 11:54:35 +0000 (08:54 -0300)]
[media] doc-rst: add media.h header to media contrller

Adding the header file is interesting for several reasons:

1) It makes MC documentation consistend with other parts;
2) The header file can be used as a quick index to all API
   elements;
3) The cross-reference check helps to identify symbols that
   aren't documented.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: parse-headers: remove trailing spaces
Mauro Carvalho Chehab [Sat, 9 Jul 2016 12:35:34 +0000 (09:35 -0300)]
doc-rst: parse-headers: remove trailing spaces

The function that replace references add a "\ " at the end of
references, to avoid the ReST markup parser to not identify
them as references. That works fine except for the end of lines,
as a sequence of { '\', ' ', '\n' } characters makes Sphinx
to ignore the end of line. So, strip those escape/spaces at the
end of lines.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: Add new types to media-types.rst
Mauro Carvalho Chehab [Sat, 9 Jul 2016 11:24:32 +0000 (08:24 -0300)]
[media] doc-rst: Add new types to media-types.rst

Changesets:
eaa0b96bbb65 ("[media] media: Add video statistics computation functions")
and
1179aab13db3 ("[media] media: Add video processing entity functions")

added some new elements to the "media entity types" table at the
DocBook. We need to do the same at the reST version, in order to
keep it in sync with the DocBook version.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: reformat cec-api.rst
Mauro Carvalho Chehab [Fri, 8 Jul 2016 21:03:02 +0000 (18:03 -0300)]
[media] doc-rst: reformat cec-api.rst

Use the same format as the other parts.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-dst: visually improve the CEC pages
Mauro Carvalho Chehab [Fri, 8 Jul 2016 20:59:27 +0000 (17:59 -0300)]
[media] doc-dst: visually improve the CEC pages

Adjust the widths and show error codes as constants.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: linux_tc CEC enhanced markup
Markus Heiser [Fri, 8 Jul 2016 18:55:43 +0000 (20:55 +0200)]
[media] doc-rst: linux_tc CEC enhanced markup

leaved content unchanged, only improved markup and references

* more man-like sections (add Name section)
* defined target for each stuct field description
* replace constant with ":ref:" to (field) description

Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: linux_tv CEC part, DocBook to reST migration
Markus Heiser [Fri, 8 Jul 2016 18:55:42 +0000 (20:55 +0200)]
[media] doc-rst: linux_tv CEC part, DocBook to reST migration

This is the reST migration of media's CEC part.  The migration is based
on media_tree's cec branch:

 https://git.linuxtv.org/media_tree.git

 c7169ad * cec media_tree/cec [media] DocBook/media: add CEC documentation

Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: fix the Z16 format definition
Mauro Carvalho Chehab [Fri, 8 Jul 2016 19:32:33 +0000 (16:32 -0300)]
[media] doc-rst: fix the Z16 format definition

Changeset 811c6d6a4243 ("[media] V4L: fix the Z16 format definition")
fixed the definition for DocBook, but we need to replicate it
also to ReST.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: mention the memory type to be set for all streaming I/O
Mauro Carvalho Chehab [Fri, 8 Jul 2016 18:47:00 +0000 (15:47 -0300)]
[media] doc-rst: mention the memory type to be set for all streaming I/O

Changeset 8c9f46095176 ("[media] DocBook: mention the memory type to
be set for all streaming I/O") updated the media DocBook to mention
the need of filling the memory types. We need to keep the ReST
doc updated to such change.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years ago[media] doc-rst: add dmabuf as streaming I/O in VIDIOC_REQBUFS description
Mauro Carvalho Chehab [Fri, 8 Jul 2016 18:39:03 +0000 (15:39 -0300)]
[media] doc-rst: add dmabuf as streaming I/O in VIDIOC_REQBUFS description

Commit 707e65831d3b("[media] DocBook: add dmabuf as streaming I/O
in VIDIOC_REQBUFS description") added DMABUF to reqbufs description,
but, as we're migrating to ReST markup, we need to keep it in sync
with the change.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc_rst: rename the media Sphinx suff to Documentation/media
Mauro Carvalho Chehab [Fri, 8 Jul 2016 14:40:06 +0000 (11:40 -0300)]
doc_rst: rename the media Sphinx suff to Documentation/media

The name of the subsystem is "media", and not "linux_tv". Also,
as we plan to add other stuff there in the future, let's
rename also the media uAPI book to media_uapi, to make it
clearer.

No functional changes.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: remove an invalid include from the docs
Mauro Carvalho Chehab [Fri, 8 Jul 2016 12:58:00 +0000 (09:58 -0300)]
doc-rst: remove an invalid include from the docs

I suspect that this is a left over from Markus tests.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: linux_tv/Makefile: Honor quiet make O=dir
Markus Heiser [Fri, 8 Jul 2016 12:15:05 +0000 (14:15 +0200)]
doc-rst: linux_tv/Makefile: Honor quiet make O=dir

To honor the:

  make O=dir [targets] Locate all output files in "dir"

* activate kernel-include directive
* export BUILDDIR=$(BUILDDIR)
* linux_tv: replace '.. include::' with '.. kernel-include:: $BUILDDIR/<foo.h.rst>'

Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: add kernel-include directive
Markus Heiser [Fri, 8 Jul 2016 12:15:04 +0000 (14:15 +0200)]
doc-rst: add kernel-include directive

The kernel-include directive is needed to include the auto generated rst
content from a build (pre-) process. E.g. the linux_tv Makefile
generates intermediate reST-files from header files. Since there is a O=
option:

  make O=dir [targets] Locate all output files in "dir"

We need to include intermediate reST files from arbitrary (O=/tmp/foo)
locations:

The 'kernel-include' reST-directive is a replacement for the 'include'
directive. The 'kernel-include' directive expand environment variables
in the path name and allows to include files from arbitrary locations.

.. hint::

  Including files from arbitrary locations (e.g. from '/etc') is a
  security risk for builders. This is why the 'include' directive from
  docutils *prohibit* pathnames pointing to locations *above* the
  filesystem tree where the reST document with the include directive is
  placed.

Substrings of the form $name or ${name} are replaced by the value of
environment variable name. Malformed variable names and references to
non-existing variables are left unchanged.

Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: auto-generate: fixed include "output/*.h.rst" content
Markus Heiser [Fri, 8 Jul 2016 12:15:03 +0000 (14:15 +0200)]
doc-rst: auto-generate: fixed include "output/*.h.rst" content

Include auto-generate reST header files. BTW fixed linux_tv/Makefile.

Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: linux_tv/Makefile: Honor quiet mode
Mauro Carvalho Chehab [Thu, 7 Jul 2016 12:29:48 +0000 (09:29 -0300)]
doc-rst: linux_tv/Makefile: Honor quiet mode

Cleanup the Makefile and handle the V=1 flag and make it
to work when specifying an output directory with O=dir

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: videodev2.h: add cross-references for defines
Mauro Carvalho Chehab [Fri, 8 Jul 2016 09:43:00 +0000 (06:43 -0300)]
doc-rst: videodev2.h: add cross-references for defines

Remove most of ignore stuff for defines, pointing them to the
proper tables/sections.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: document enum symbols
Mauro Carvalho Chehab [Thu, 7 Jul 2016 19:29:39 +0000 (16:29 -0300)]
doc-rst: document enum symbols

After checking that all enum fields are documented at the
corresponding table on the rst file, let's point to the
table, instead of ignore the symbols.

A few symbols are not meant to be documented, as they're
deprecated stuff. keep ignoring them.

One enum field is not documented. Either it is obsolete
or a documentation gap. So, produce warnings for it.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: videodev2.h: don't ignore V4L2_STD macros
Mauro Carvalho Chehab [Thu, 7 Jul 2016 19:21:17 +0000 (16:21 -0300)]
doc-rst: videodev2.h: don't ignore V4L2_STD macros

The content of those macros are all declared at the v4l2-std-id
table. So, point to it.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: linux_tv: Don't ignore pix formats
Mauro Carvalho Chehab [Thu, 7 Jul 2016 19:16:21 +0000 (16:16 -0300)]
doc-rst: linux_tv: Don't ignore pix formats

Now that the reference problems were solved, let's not
ignore anymore the pix formats, as all of them are already
documented.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: fix some badly converted references
Mauro Carvalho Chehab [Thu, 7 Jul 2016 18:53:44 +0000 (15:53 -0300)]
doc-rst: fix some badly converted references

Several references were not converted right. That's why
so many symbols were lost when parsing videodev2.h header.

Fix them.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: autogenerate videodev2.h.rst file
Mauro Carvalho Chehab [Thu, 7 Jul 2016 14:05:38 +0000 (11:05 -0300)]
doc-rst: autogenerate videodev2.h.rst file

This file comes from the uAPI definitions for V4L2, with is dynamic
and updated on almost every Kernel version. So, this file
needs to be auto-updated, as otherwise the documentation will
become obsolete too early.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: parse-headers: don't do substituition references
Mauro Carvalho Chehab [Thu, 7 Jul 2016 16:04:01 +0000 (13:04 -0300)]
doc-rst: parse-headers: don't do substituition references

Add one extra escape character to avoid those warnings:
Documentation/linux_tv/videodev2.h.rst:6: WARNING: Inline substitution_reference start-string without end-string.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: parse-headers: add an option to ignore enum symbols
Mauro Carvalho Chehab [Thu, 7 Jul 2016 17:26:51 +0000 (14:26 -0300)]
doc-rst: parse-headers: add an option to ignore enum symbols

At videodev2.h, we have hundreds of symbols that don't
currently have a reference yet. Let's ignore for how, while
we don't improve those cross-refs.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: parse-headers: better handle comments at the source code
Mauro Carvalho Chehab [Thu, 7 Jul 2016 17:13:12 +0000 (14:13 -0300)]
doc-rst: parse-headers: better handle comments at the source code

We should not let comments to mangle with the symbols
parsing. Unfortunately, videodev2.h has lots of those
in the middle of enums and structs. So, we need to improve
our parser to discard them.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: auto-generate video.h.rst
Mauro Carvalho Chehab [Thu, 7 Jul 2016 11:46:49 +0000 (08:46 -0300)]
doc-rst: auto-generate video.h.rst

This file comes from the uAPI definition header, and
should be auto-generated, to be in sync with Kernel changes.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: auto-generate net.h.rst
Mauro Carvalho Chehab [Thu, 7 Jul 2016 11:28:43 +0000 (08:28 -0300)]
doc-rst: auto-generate net.h.rst

This file comes from the uAPI definition header, and
should be auto-generated, to be in sync with Kernel changes.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: auto-generate ca.h.rst
Mauro Carvalho Chehab [Thu, 7 Jul 2016 10:51:03 +0000 (07:51 -0300)]
doc-rst: auto-generate ca.h.rst

This file comes from the uAPI definition header, and
should be auto-generated, to be in sync with Kernel changes.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: auto-generate audio.h.rst
Mauro Carvalho Chehab [Thu, 7 Jul 2016 10:42:18 +0000 (07:42 -0300)]
doc-rst: auto-generate audio.h.rst

This is an auto-generated header. Remove the hardcoded one
and do the right thing here.

NOTE: this is a deprecated API. So, we won't make any
effort to try identifying the meaning of this obscure
API that is used only on a legacy driver.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: auto-generate dmx.h.rst
Mauro Carvalho Chehab [Thu, 7 Jul 2016 10:11:46 +0000 (07:11 -0300)]
doc-rst: auto-generate dmx.h.rst

This file should be auto-generated from the header files,
and not hardcoded.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: parse-headers: fix multiline typedef handler
Mauro Carvalho Chehab [Thu, 7 Jul 2016 11:09:37 +0000 (08:09 -0300)]
doc-rst: parse-headers: fix multiline typedef handler

The typedef handler should do two things to be generic:
  1) parse typedef enums;
  2) accept both possible syntaxes:
 typedef struct foo { .. } foo_t;
 typedef struct { .. } foo_t;

Unfortunately, this is needed to parse some legacy DVB
files, like dvb/audio.h.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: parse-headers: better handle typedefs
Mauro Carvalho Chehab [Thu, 7 Jul 2016 10:20:27 +0000 (07:20 -0300)]
doc-rst: parse-headers: better handle typedefs

When typedef is used on its multiline format, we need to
also parse enum and struct in the same line.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: parse-headers: be more formal about the valid symbols
Mauro Carvalho Chehab [Thu, 7 Jul 2016 10:06:05 +0000 (07:06 -0300)]
doc-rst: parse-headers: be more formal about the valid symbols

Be more formal about the valid symbols that are expected by
the parser, to match what c language expects.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: fix parsing comments and '{' on a separate line
Mauro Carvalho Chehab [Thu, 7 Jul 2016 09:52:10 +0000 (06:52 -0300)]
doc-rst: fix parsing comments and '{' on a separate line

The dmx.h header has two things that causes the parser to
break while handling enums:
 per-header enums and the '{' starts on a new line

Both makes the parser to get lexical marks to be detected
as if they were symbols.

Fix it.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-dst: parse-headers: highlight deprecated comments
Mauro Carvalho Chehab [Thu, 7 Jul 2016 09:31:21 +0000 (06:31 -0300)]
doc-dst: parse-headers: highlight deprecated comments

When something is deprecated, highlight it, as we want it
to be clearer to the reader.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: parse-headers: improve delimiters to detect symbols
Mauro Carvalho Chehab [Thu, 7 Jul 2016 09:27:54 +0000 (06:27 -0300)]
doc-rst: parse-headers: improve delimiters to detect symbols

As we had to escape the symbols for the ReST markup to not do
the wrong thing, the logic to discover start/end of strings
are not trivial. Improve the end delimiter detection, in order
to highlight more occurrences of the strings.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: auto-build the frontend.h.rst
Mauro Carvalho Chehab [Thu, 7 Jul 2016 03:21:37 +0000 (00:21 -0300)]
doc-rst: auto-build the frontend.h.rst

This file is auto-generated with DocBook, from the uapi header.

Do the same with Sphinx.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: add parse-headers.pl script
Mauro Carvalho Chehab [Thu, 7 Jul 2016 01:58:54 +0000 (22:58 -0300)]
doc-rst: add parse-headers.pl script

This script parses a header file and converts it into a
parsed-literal block, creating references for ioctls,
defines, typedefs, enums and structs.

It also allow an external file to modify the rules, in
order to fix the expressions.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: linux_tv/index: Rename the book name
Mauro Carvalho Chehab [Wed, 6 Jul 2016 11:29:00 +0000 (08:29 -0300)]
doc-rst: linux_tv/index: Rename the book name

There's no need for all caps at its name. As the book title is
now showing at the top of each page, let's use Camel Case, to
make it less bold.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: v4l2: Rename the V4L2 API title
Mauro Carvalho Chehab [Wed, 6 Jul 2016 11:22:16 +0000 (08:22 -0300)]
doc-rst: v4l2: Rename the V4L2 API title

The V4L2 is the only part of the doc that has the word "Specification"
and mentions its version on the title.

Having the version there was important in the past, while we were
getting rid of V4L version 1. But, as v1 is long gone, all it lasts
is history (with is, btw, covered on the spec). So, no need to keep
the version on its title.

So, rename it, to be more generic and look like the remaining
of the document.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: Rename the title of the Digital TV section
Mauro Carvalho Chehab [Wed, 6 Jul 2016 11:16:07 +0000 (08:16 -0300)]
doc-rst: Rename the title of the Digital TV section

The Digital TV section is ackward for two reasons:

  1) it is the only one with everything in upper case;
  2) its name is associated with the European digital TV standard.

Rename the part name, and add a notice that it refers to what's
known as "DVB API".

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: remote_controllers: fix conversion issues
Mauro Carvalho Chehab [Wed, 6 Jul 2016 11:09:58 +0000 (08:09 -0300)]
doc-rst: remote_controllers: fix conversion issues

Make it look like V4L, DVB and MC docbooks initial page.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: gen-errors: Improve table layout
Mauro Carvalho Chehab [Wed, 6 Jul 2016 10:58:20 +0000 (07:58 -0300)]
doc-rst: gen-errors: Improve table layout

Add a :widths: at the flat-table, to make it to look nicer.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: media-ioc-enum-entities: better format the table
Mauro Carvalho Chehab [Wed, 6 Jul 2016 10:55:55 +0000 (07:55 -0300)]
doc-rst: media-ioc-enum-entities: better format the table

Add a :widths: at the flat-table, to improve the visual.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: media-ioc-g-topology: Fix tables
Mauro Carvalho Chehab [Wed, 6 Jul 2016 10:31:59 +0000 (07:31 -0300)]
doc-rst: media-ioc-g-topology: Fix tables

The tables were not properly converted. It looked a little
ackward already at DocBook, but the conversion made it worse.

Fix them.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agoworkqueue: Fix a typo in workqueue.txt
Masanari Iida [Tue, 5 Jul 2016 11:55:30 +0000 (20:55 +0900)]
workqueue: Fix a typo in workqueue.txt

This patch fixes a spelling typo in workqueue.txt

Signed-off-by: Masanari Iida <standby24x7@gmail.com>
Acked-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
8 years agodoc-rst: mediactl: fix some wrong cross references
Mauro Carvalho Chehab [Tue, 5 Jul 2016 20:12:37 +0000 (17:12 -0300)]
doc-rst: mediactl: fix some wrong cross references

Those cross references should point to media control syscalls,
and not to V4L ones.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
8 years agodoc-rst: media-controller-model: fix a typo
Mauro Carvalho Chehab [Tue, 5 Jul 2016 20:05:03 +0000 (17:05 -0300)]
doc-rst: media-controller-model: fix a typo

Remove a 'm' at the end of the last phrase.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>