summaryrefslogtreecommitdiffstats
path: root/Documentation/media
Commit message (Collapse)AuthorAgeFilesLines
...
* [media] doc-rst: Fix issues with RC documentationMauro Carvalho Chehab2016-07-171-0/+9
| | | | | | | The kernel-doc script is now broken if it doesn't find all exported symbols documented. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: split media_drivers.rst into one file per API typeMauro Carvalho Chehab2016-07-175-415/+428
| | | | | | | | 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>
* [media] doc-rst: media_drivers.rst: Fix paragraph headers for MCMauro Carvalho Chehab2016-07-171-17/+24
| | | | | | | Fix the paragraph identation for the media controller headers. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: Convert media API to rstMauro Carvalho Chehab2016-07-171-0/+414
| | | | | | | | | | | 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>
* [media] doc-rst: increase depth of the main indexMauro Carvalho Chehab2016-07-131-8/+3
| | | | | | | | | | 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>
* [media] doc-rst: fix an undefined referenceMauro Carvalho Chehab2016-07-131-3/+3
| | | | | | 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>
* [media] doc-rst: improve CEC documentationHans Verkuil2016-07-138-72/+64
| | | | | | | 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>
* [media] doc-rst: fix htmldocs build warningsMauro Carvalho Chehab2016-07-133-4/+4
| | | | | | | | 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>
* Revert "[media] docs-rst: escape [] characters"Mauro Carvalho Chehab2016-07-1368-188/+188
| | | | | | | | | | 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.
* [media] doc-rst: update CEC_RECEIVEHans Verkuil2016-07-131-25/+41
| | | | | | | | | | | 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>
* [media] docs-rst: escape [] charactersMauro Carvalho Chehab2016-07-1268-188/+188
| | | | | | | 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>
* [media] doc-rst: use the right markup for footnotesMauro Carvalho Chehab2016-07-1220-94/+94
| | | | | | | 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>
* [media] vidioc-g-dv-timings.rst: document interlaced definesHans Verkuil2016-07-122-3/+3
| | | | | | | | 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>
* [media] pixfmt-006.rst: add missing V4L2_YCBCR_ENC_SMPTE240MHans Verkuil2016-07-122-3/+7
| | | | | | | 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>
* [media] doc-rst: fix a missing reference for V4L2_BUF_FLAG_LASTMauro Carvalho Chehab2016-07-122-40/+19
| | | | | | | | | | 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>
* [media] doc-rst: reorganize LIRC ReST filesMauro Carvalho Chehab2016-07-126-12/+24
| | | | | | | 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>
* [media] doc-rst: document LIRC set mode ioctlsMauro Carvalho Chehab2016-07-125-98/+50
| | | | | | | | | | 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>
* [media] doc-rst: document LIRC_SET_WIDEBAND_RECEIVERMauro Carvalho Chehab2016-07-123-19/+57
| | | | | | | Put documentation for this ioctl on a separate page and improve it. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: add documentation for LIRC_SET_MEASURE_CARRIER_MODEMauro Carvalho Chehab2016-07-123-9/+49
| | | | | | Place documentation for this ioctl on its own page. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: document LIRC_SET_REC_TIMEOUT_REPORTSMauro Carvalho Chehab2016-07-123-8/+50
| | | | | | Add a separate page for this ioctl and improve its documentation. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: document LIRC_SET_REC_TIMEOUTMauro Carvalho Chehab2016-07-123-11/+53
| | | | | | Add a separate page for this ioctl and adds the cross-references. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: document LIRC_SET_TRANSMITTER_MASKMauro Carvalho Chehab2016-07-123-10/+54
| | | | | | | Add proper documentation for this ioctl, providing some additional information about its usage. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: document LIRC set carrier ioctlsMauro Carvalho Chehab2016-07-125-18/+143
| | | | | | | | 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>
* [media] doc-rst: document LIRC_GET_LENGTH ioctlMauro Carvalho Chehab2016-07-123-11/+46
| | | | | | Put documentation for this ioctl on its own page. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: document LIRC_GET_*_TIMEOUT ioctlsMauro Carvalho Chehab2016-07-123-13/+56
| | | | | | | | | 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>
* [media] doc-rst: document LIRC_SET_SEND_DUTY_CYCLEMauro Carvalho Chehab2016-07-123-9/+50
| | | | | | Add a separate page for this ioctl. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: document LIRC_GET_REC_RESOLUTIONMauro Carvalho Chehab2016-07-123-10/+50
| | | | | | | | | 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>
* [media] doc-rst: document ioctl LIRC_GET_REC_MODEMauro Carvalho Chehab2016-07-123-9/+60
| | | | | | | | 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>
* [media] doc-rst: fix some lirc cross-referencesMauro Carvalho Chehab2016-07-124-7/+6
| | | | | | | | | 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>
* [media] doc-rst: document ioctl LIRC_GET_SEND_MODEMauro Carvalho Chehab2016-07-113-9/+49
| | | | | | | | 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>
* [media] doc-rst: Fix LIRC_GET_FEATURES referencesMauro Carvalho Chehab2016-07-112-39/+60
| | | | | | | | The references pointed by LIRC_GET_FEATURES ioctl are broken. Fix them. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: remove not used ioctls from documentationMauro Carvalho Chehab2016-07-112-74/+9
| | | | | | | 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>
* [media] doc-rst: add media/uapi/rc/lirc-header.rstMauro Carvalho Chehab2016-07-111-0/+10
| | | | | | | | | | 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>
* [media] doc-rst: Document ioctl LIRC_GET_FEATURESMauro Carvalho Chehab2016-07-114-43/+169
| | | | | | | | | 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>
* [media] doc-rst: improve display of notes and warningsMauro Carvalho Chehab2016-07-1069-526/+592
| | | | | | | | | | 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>
* [media] doc-rst: improve DTV_BANDWIDTH_HZ notesMauro Carvalho Chehab2016-07-101-11/+17
| | | | | | | 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>
* [media] doc-rst: improve documentation for DTV_FREQUENCYMauro Carvalho Chehab2016-07-101-10/+16
| | | | | | Make the note better formatted and documented. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
* [media] doc-rst: Don't use captions for examplesMauro Carvalho Chehab2016-07-1012-29/+71
| | | | | | | | | | | | 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>
* [media] doc-rst: do cross-references between header and the docMauro Carvalho Chehab2016-07-102-2/+79
| | | | | | | | | | 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>
* [media] doc-rst: add LIRC header to the bookMauro Carvalho Chehab2016-07-103-1/+7
| | | | | | | 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>
* [media] doc-rst: improve LIRC syscall documentationMauro Carvalho Chehab2016-07-103-46/+240
| | | | | | | | 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>
* [media] doc-rst: rename some RC filesMauro Carvalho Chehab2016-07-105-4/+4
| | | | | | | | | 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>
* [media] doc-rst: remove an extra label on V4L2 and CEC partsMauro Carvalho Chehab2016-07-102-2/+0
| | | | | | | | 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>
* [media] doc-rst: Group function references together for MCMauro Carvalho Chehab2016-07-102-19/+19
| | | | | | | 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>
* [media] doc-rst: media: reordered top sectioningMarkus Heiser2016-07-092-52/+47
| | | | | | | | | | | | | | | | | | | | | | | | | | 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>
* [media] doc-rst: make CEC look more like other parts of the bookMauro Carvalho Chehab2016-07-093-55/+57
| | | | | | | | 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>
* [media] doc-rst: add CEC header file to the documentationMauro Carvalho Chehab2016-07-099-86/+593
| | | | | | | | | | | | 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>
* [media] doc-rst: add media.h header to media contrllerMauro Carvalho Chehab2016-07-0910-12/+170
| | | | | | | | | | | | 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>
* [media] doc-rst: Add new types to media-types.rstMauro Carvalho Chehab2016-07-091-0/+69
| | | | | | | | | | | | | 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>
* [media] doc-rst: reformat cec-api.rstMauro Carvalho Chehab2016-07-081-4/+10
| | | | | | Use the same format as the other parts. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
generated by cgit v1.2.3 (git 2.25.1) at 2024-08-18 18:39:20 +0000