This is the first series of patches that will improve the DVB documentation. Our DocBook was a conversion from a past LaTex documentation that had some parts updated to cover what's there at DVBv5 API and got merged with V4L2, media controller and remote controllers documentation to provide a consistent document about the media infrastructure API. Yet, it doesn't follow the same format as other parts of the document. This patch series rewrite lots of code inside the DVB frontend API documentation (with is the biggest chapter). It also moves the DVBv3 legacy stuff into a separate xml file, after the non-legacy stuff. This should hopefully make clearer to the readers what's the recommended ioctls and what's deprecated. This work is not complete yet: there are still some structures that are docummented on both frontend.xml and dvbproperty.xml, but, as we have already 35 patches, let me flush what I have so far. Mauro Carvalho Chehab (35): DocBook: Update DVB supported standards at introduction DocBook: add a note about the ALSA API DocBook: add drawing with a typical media device DocBook: fix emphasis at the DVB documentation DocBook: Improve DVB frontend description DocBook: move DVBv3 frontend bits to a separate section dvb: split enum from typedefs at frontend.h DocBook: reformat FE_GET_INFO ioctl documentation DocBook: move FE_GET_INFO to a separate xml file DocBook: improve documentation for FE_READ_STATUS DocBook: move DVB properties to happen earlier at the document DocBook: rewrite FE_GET_PROPERTY/FE_SET_PROPERTY to use the std way DocBook: fix xref to the FE open() function DocBook: Merge FE_SET_PROPERTY/FE_GET_PROPERTY ioctl description DocBook: Improve the description of the properties API DocBook: Add xref links for DTV propeties DocBook: Improve xref check for undocumented ioctls DocBook: remove duplicated ioctl from v4l2-subdev DocBook: Fix false positive undefined ioctl references DocBook: Rename ioctl xml files DocBook: move FE_GET_PROPERTY to its own xml file DocBook: reformat FE_SET_FRONTEND_TUNE_MODE ioctl DocBook: reformat FE_ENABLE_HIGH_LNB_VOLTAGE ioctl DocBook: better document FE_SET_VOLTAGE ioctl DocBook: better document FE_SET_TONE ioctl DocBook: better document FE_DISEQC_SEND_BURST ioctl DocBook: better document FE_DISEQC_RECV_SLAVE_REPLY DocBook: better document FE_DISEQC_SEND_MASTER_CMD DocBook: better document FE_DISEQC_RESET_OVERLOAD DocBook: better organize the function descriptions for frontend DocBook: fix FE_READ_STATUS argument description DocBook: Provide a high-level description for DVB frontend DocBook: add a proper description for dvb_frontend_info.fe_type DocBook: Better document enum fe_modulation DocBook: some fixes at FE_GET_INFO Documentation/DocBook/media/Makefile | 33 +- Documentation/DocBook/media/dvb/audio.xml | 6 +- Documentation/DocBook/media/dvb/ca.xml | 4 +- Documentation/DocBook/media/dvb/demux.xml | 10 +- Documentation/DocBook/media/dvb/dvbproperty.xml | 227 ++-- .../media/dvb/fe-diseqc-recv-slave-reply.xml | 78 ++ .../DocBook/media/dvb/fe-diseqc-reset-overload.xml | 51 + .../DocBook/media/dvb/fe-diseqc-send-burst.xml | 86 ++ .../media/dvb/fe-diseqc-send-master-cmd.xml | 72 ++ .../media/dvb/fe-enable-high-lnb-voltage.xml | 61 + Documentation/DocBook/media/dvb/fe-get-info.xml | 266 ++++ .../DocBook/media/dvb/fe-get-property.xml | 81 ++ Documentation/DocBook/media/dvb/fe-read-status.xml | 107 ++ .../media/dvb/fe-set-frontend-tune-mode.xml | 64 + Documentation/DocBook/media/dvb/fe-set-tone.xml | 88 ++ Documentation/DocBook/media/dvb/fe-set-voltage.xml | 94 ++ Documentation/DocBook/media/dvb/frontend.xml | 1351 +------------------- .../DocBook/media/dvb/frontend_legacy_api.xml | 613 +++++++++ Documentation/DocBook/media/dvb/intro.xml | 26 +- Documentation/DocBook/media/dvb/kdapi.xml | 4 +- Documentation/DocBook/media/dvb/net.xml | 4 +- Documentation/DocBook/media/dvb/video.xml | 10 +- .../DocBook/media/typical_media_device.svg | 28 + .../DocBook/media/v4l/vidioc-g-dv-timings.xml | 4 +- Documentation/DocBook/media/v4l/vidioc-g-edid.xml | 4 +- .../DocBook/media/v4l/vidioc-query-dv-timings.xml | 3 +- .../DocBook/media/v4l/vidioc-subscribe-event.xml | 3 +- Documentation/DocBook/media_api.tmpl | 25 +- include/uapi/linux/dvb/frontend.h | 36 +- 29 files changed, 1974 insertions(+), 1465 deletions(-) create mode 100644 Documentation/DocBook/media/dvb/fe-diseqc-recv-slave-reply.xml create mode 100644 Documentation/DocBook/media/dvb/fe-diseqc-reset-overload.xml create mode 100644 Documentation/DocBook/media/dvb/fe-diseqc-send-burst.xml create mode 100644 Documentation/DocBook/media/dvb/fe-diseqc-send-master-cmd.xml create mode 100644 Documentation/DocBook/media/dvb/fe-enable-high-lnb-voltage.xml create mode 100644 Documentation/DocBook/media/dvb/fe-get-info.xml create mode 100644 Documentation/DocBook/media/dvb/fe-get-property.xml create mode 100644 Documentation/DocBook/media/dvb/fe-read-status.xml create mode 100644 Documentation/DocBook/media/dvb/fe-set-frontend-tune-mode.xml create mode 100644 Documentation/DocBook/media/dvb/fe-set-tone.xml create mode 100644 Documentation/DocBook/media/dvb/fe-set-voltage.xml create mode 100644 Documentation/DocBook/media/dvb/frontend_legacy_api.xml create mode 100644 Documentation/DocBook/media/typical_media_device.svg -- 2.4.1 -- To unsubscribe from this list: send the line "unsubscribe linux-media" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
