aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
AgeCommit message (Collapse)AuthorFilesLines
2016-07-05doc-rst: linux_tv: don't use uppercases for syscall sectionsMauro Carvalho Chehab182-913/+1107
On the syscall conversions, we used uppercase for the sections, but this is too bold. So, convert them to Camel Case, as it looks visually better. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-05doc-rst: customize RTD theme, captions & inline literalMarkus Heiser1-0/+25
The layout of (table) captions in the RTD theme is a bit ugly and the bordered, red colored of inline literals is a bit to gaudy. The requirements has been discussed in the ML [1]. captions: - captions should have 100% (not 85%) font size - hide the permalink symbol as long as link is not hovered inline literal: - drop the borderbox and red color [1] http://article.gmane.org/gmane.linux.drivers.video-input-infrastructure/101099 Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
2016-07-05doc-rst: customize RTD theme, table & full widthMarkus Heiser1-1/+20
The default table layout of the RTD theme does not fit for vast tables, like the ones we have in the linux_tv project. This has been discussed on the ML [1]. The RTD theme is a two column layout, with a navigation column on the left and a content column on the right: content column RTD theme's default is 800px as max width for the content, but we have tables with tons of columns, which need the full width of the view-port (BTW: *full width* is what DocBook's HTML is). table - sequences of whitespace should collapse into a single whitespace. - make the overflow auto (scrollbar if needed) - align caption "left" ("center" is unsuitable on vast tables) [1] http://article.gmane.org/gmane.linux.kernel/2216509 Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
2016-07-05doc-rst: remove Documentation/linux_tv/conf.py fileMauro Carvalho Chehab1-221/+0
This file is actually not used to build the media uAPI docbook. So, remove it. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-05doc-rst: boilerplate HTML theme customizationMarkus Heiser2-1/+17
Implements the minimal boilerplate for Sphinx HTML theme customization. Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de> Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-05Documentation: dt: Add new compatible to STM32 pinctrl driver bindingsAlexandre TORGUE1-0/+1
Signed-off-by: Alexandre TORGUE <alexandre.torgue@st.com> Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
2016-07-05doc-rst: linux_tv: dvb: put return value at the endMauro Carvalho Chehab11-58/+41
On some syscall descriptions, the tables are described after the return value. Do that inside descriptions. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-05doc-rst: linux_tv: dvb: use lowercase for filenamesMauro Carvalho Chehab9-8/+8
There are some ioctls in upper case. This is not the standard. Put them on lowercase, to match what's done with other ioctls. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-05powerpc/mm: Add a parameter to disable 1TB segsOliver O'Halloran1-0/+6
This patch adds the kernel command line parameter "no_tb_segs" which forces the kernel to use 256MB rather than 1TB segments. Forcing the use of 256MB segments makes it considerably easier to test code that depends on an SLB miss occurring. Suggested-by: Michael Neuling <mikey@neuling.org> Suggested-by: Michael Ellerman <mpe@ellerman.id.au> Signed-off-by: Oliver O'Halloran <oohall@gmail.com> Signed-off-by: Michael Ellerman <mpe@ellerman.id.au>
2016-07-05dt-bindings: analogix_dp: rockchip: correct the wrong compatible nameYakir Yang1-1/+1
The document about rockchip platform make a mistaken in available compatible name of "rk3288-edp", we should correct it to "rk3288-dp" which correspond to the compatible name in driver. This mistaken was introduced in commit be91c36247089 ("dt-bindings: add document for rockchip variant of analogix_dp"). Reported-by: Tomasz Figa <tfiga@chromium.com> Signed-off-by: Yakir Yang <ykk@rock-chips.com> Reviewed-by: Douglas Anderson <dianders@chromium.org> Reviewed-by: Tomasz Figa <tomasz.figa@chromium.com>
2016-07-05drm/rockchip: analogix_dp: introduce the pclk for grfYakir Yang1-0/+6
For RK3399's GRF module, if we want to operate the graphic related grf registers, we need to enable the pclk_vio_grf which supply power for VIO GRF IOs, so it's better to introduce an optional grf clock in driver. Signed-off-by: Yakir Yang <ykk@rock-chips.com> Reviewed-by: Douglas Anderson <dianders@chromium.org> Reviewed-by: Tomasz Figa <tomasz.figa@chromium.com>
2016-07-05drm/rockchip: analogix_dp: add rk3399 eDP supportYakir Yang2-1/+3
RK3399 and RK3288 shared the same eDP IP controller, only some light difference with VOP configure and GRF configure. Signed-off-by: Yakir Yang <ykk@rock-chips.com> Acked-by: Mark Yao <mark.yao@rock-chips.com> Reviewed-by: Tomasz Figa <tomasz.figa@chromium.com> Reviewed-by: Sean Paul <seanpaul@chromium.org>
2016-07-05doc-rst: linux_tv: reformat all syscall pagesMauro Carvalho Chehab181-1904/+2261
The syscall pages are written to be used also as man-pages. However, they don't match the format used by kernel-doc generated pages from DocBook. Rewrite them to match it. One side effect is that now all such pages at the book will have the same format, reducing the format differences between DVB and the other parts of the book. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-05doc-rst: linux_tv: split DVB function call documentationMauro Carvalho Chehab89-5137/+5395
Just like V4L, split the DVB function calls into one file per system call. This is a requirement for the man pages creator on Sphinx to work, and makes the document easier to maintain. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04Merge tag 'qcom-dt-for-4.8' of git://git.kernel.org/pub/scm/linux/kernel/git/agross/linux into next/dtOlof Johansson2-0/+144
Qualcomm Device Tree Changes for v4.8 * Reverse BAM dma node reverts * Add BAM remote control options for affected platforms * Enable peripherals on APQ8074 dragonboard * Enable PMA8084 pwrky * Fix PMIC reg entries by removing unnecessary size element * Add SCM binding and support for all currently supported boards * Add Qualcomm WCNSS binding documentation * Rename db600c to SD_600eval and add peripheral nodes * Remove gpio key entry from Nexus7 * Add APQ8060 based dragonboard and associated peripherals * Add ARMv7 PMU for IPQ4019 * Update smem state cells to match documentation * tag 'qcom-dt-for-4.8' of git://git.kernel.org/pub/scm/linux/kernel/git/agross/linux: (26 commits) dts: ipq4019: support ARMv7 PMU ARM: dts: add Qualcomm APQ8060-based Dragonboard ARM: dts: move the fixed MMC regulator to SURF board ARM: dts: fix the MSM8660 RTC base address ARM: dts: add I2C block in GSBI12 ARM: dts: add L2CC and RPM with regulators for MSM8660 ARM: dts: add SDCC5 to Qualcomm MSM8660 ARM: dts: add GPIO and MPP to MSM8660 PMIC device-tree: nexus7: Remove power gpio key entry and use pmic8xxx-pwrkey arm: dts: qcom: Update smem state cells usage ARM: dts: qcom: msm8974-honami: Set DMA as remotely controlled ARM: dts: sd_600eval: Fix eMMC lockup issue ARM: dts: apq8064: rename db600c to SD_600eval ARM: dts: apq8064: move sdcc3 pinctrls out of baord file ARM: dts: apq8064: move sdcc1 pinctrl nodes to soc file dt: binding: Add Qualcomm WCNSS control binding dts: qcom: apq8064: Add SCM firmware node dts: qcom: msm8974: Add SCM firmware node dts: qcom: apq8084: Add SCM firmware node dt/bindings: firmware: Add Qualcomm SCM binding ... Signed-off-by: Olof Johansson <olof@lixom.net>
2016-07-04Merge tag 'qcom-drivers-for-4.8' of git://git.kernel.org/pub/scm/linux/kernel/git/agross/linux into next/driversOlof Johansson2-4/+4
Qualcomm ARM Based Driver Updates for v4.8 * Rework of SCM driver * Add file patterns for Qualcomm Maintainers entry * Add worker for wcnss_ctrl signaling * Fixes for smp2p * Update smem_state properties to match documentation * Add SCM Peripheral Authentication service * Expose SCM PAS command 10 as a reset controller * tag 'qcom-drivers-for-4.8' of git://git.kernel.org/pub/scm/linux/kernel/git/agross/linux: firmware: qcom: scm: Expose PAS command 10 as reset-controller firmware: qcom: scm: Peripheral Authentication Service soc: qcom: Update properties for smem state referencing soc: qcom: smp2p: Drop io-accessors soc: qcom: smp2p: Correct addressing of outgoing value soc: qcom: wcnss_ctrl: Make wcnss_ctrl parent the other components firmware: qcom: scm: Add support for ARM64 SoCs firmware: qcom: scm: Convert to streaming DMA APIS firmware: qcom: scm: Generalize shared error map firmware: qcom: scm: Use atomic SCM for cold boot firmware: qcom: scm: Convert SCM to platform driver MAINTAINERS: Add file patterns for qcom device tree bindings Signed-off-by: Olof Johansson <olof@lixom.net>
2016-07-04Merge tag 'omap-for-v4.8/dt-part1-signed-v2' of git://git.kernel.org/pub/scm/linux/kernel/git/tmlind/linux-omap into next/dtOlof Johansson4-22/+91
Device tree changes for omaps for v4.8 merge window: - PWM binding updates and related dts changes - OCM RAM updates for dra7 - Enable n900 lirc-rx51 driver - omap3-gta04 updates for backlight, bma180, itg3200, hmc5843 and wifi - am335x, am437x and am57xx operating point updates and additions - am335x-icev2 pca9536 node - dra72-evm regulator updates - edma spelling fixes - am335x and am437x ethernet phy update - a series of mcbsp updates - omap3-gta04 eeprom - dra7 PCIe unit address fix - stdout-path for beaglebone variants - crypto accelerator nodes for am335x, am437x and dra7 * tag 'omap-for-v4.8/dt-part1-signed-v2' of git://git.kernel.org/pub/scm/linux/kernel/git/tmlind/linux-omap: (42 commits) ARM: dts: AM43xx: Add node for RNG ARM: dts: AM43xx: clk: Add RNG clk node ARM: dts: DRA7: Add DT node for RNG IP ARM: dts: DRA7: Add support for SHA IP ARM: dts: DRA7: Add DT nodes for AES IP ARM: dts: DRA7: Add DT node for DES IP ARM: dts: am335x-bone-common: use stdout-path in Beaglebone boards. ARM: dts: DRA7: fix unit address of second PCIe instance ARM: dts: omap3-gta04: Add RFID eeprom node ARM: dts: omap4-duovero: Add pdmclk binding for audio ARM: dts: omap4-var-som-om44: Add pdmclk binding for audio ARM: dts: omap4-sdp: Add pdmclk binding for audio ARM: dts: omap4-panda-common: Add pdmclk binding for audio ARM: dts: omap5-board-common: Add pdmclk binding for audio ARM: dts: omap3: Add clocks to McBSP nodes ARM: dts: am335x-bone-common: Mark MAC as having only one PHY ARM: dts: am437x-idk-evm: Mark MAC as having only one PHY ARM: dts: Correct misspelling, "emda3" -> "edma3" ARM: dts: dra72-evm: Rename 3.3V regulator tag ARM: dts: am335x-icev2: Add DT node for TI PCA9536 ... Signed-off-by: Olof Johansson <olof@lixom.net>
2016-07-04Merge tag 'xgene-dts-for-v4.8-part1' of https://github.com/AppliedMicro/xgene-next into next/dt64Olof Johansson1-2/+2
First part of X-Gene DTS changes queued for v4.8 The changes include: + 2 clean-up and style-fix patches from Bjorn + Correct timer interrupt polarity for X-Gene 2 + Remove unused qmlclk node on X-Gene 1 * tag 'xgene-dts-for-v4.8-part1' of https://github.com/AppliedMicro/xgene-next: arm64: dts: apm: Remove unused qmlclk node on X-Gene 1 arm64: dts: apm: Fix timer interrupt polarity for X-Gene 2 SoC arm64: dts: apm: Remove leading '0x' from unit addresses arm64: dts: apm: Use lowercase consistently for hex constants Signed-off-by: Olof Johansson <olof@lixom.net>
2016-07-04Merge tag 'scpi-updates-4.8' of git://git.kernel.org/pub/scm/linux/kernel/git/sudeep.holla/linux into next/driversOlof Johansson1-0/+34
SCPI updates and fixes for v4.8 1. Adds support for device power state management using generic power domains and runtime PM 2. Other minor/miscellaneous fixes to the driver * tag 'scpi-updates-4.8' of git://git.kernel.org/pub/scm/linux/kernel/git/sudeep.holla/linux: firmware: scpi: add device power domain support using genpd Documentation: add DT bindings for ARM SCPI power domains firmware: arm_scpi: add support for device power state management firmware: arm_scpi: make it depend on MAILBOX instead of ARM_MHU firmware: arm_scpi: mark scpi_get_sensor_value as static firmware: arm_scpi: remove dvfs_get packed structure Signed-off-by: Olof Johansson <olof@lixom.net>
2016-07-04Merge tag 'at91-ab-4.8-soc2' of git://git.kernel.org/pub/scm/linux/kernel/git/abelloni/linux into next/socOlof Johansson1-2/+8
SoC changes for 4.8 #2: - Add final documentation for sama5d2 - Fix some compilation warnings * tag 'at91-ab-4.8-soc2' of git://git.kernel.org/pub/scm/linux/kernel/git/abelloni/linux: ARM: at91: fix warnings in pm.c ARM: at91: Documentation: update the sama5d2 entry Signed-off-by: Olof Johansson <olof@lixom.net>
2016-07-04doc-rst: libv4l-introduction: improve formatMauro Carvalho Chehab1-6/+6
Fix some cross-references and improve the layout of this page. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: subdev-formats: Improve figure captionMauro Carvalho Chehab1-3/+1
Add a numbering for the figure. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: dev-subdev: fix some format issuesMauro Carvalho Chehab1-8/+8
The conversion from DocBook made somethings look ugly. Improve them. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: dev-sliced-vbi: convert table captions into headersMauro Carvalho Chehab1-9/+36
Sphinx doesn't format nice table captions, nor auto-numberate them. So, convert tables into chapters. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: dev-raw-vbi fix conversion issuesMauro Carvalho Chehab1-19/+10
There are several things that didn't convert well. Fix them, in order to improve the layout of the formatted document. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: linux_tv: Use references for read()/write()Mauro Carvalho Chehab4-11/+12
Use cross-references for read()/write() on a few places where they weren't used. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: dev-codec: Fix a reference for _STREAMONMauro Carvalho Chehab1-1/+1
The referenced ioctl there is only VIDIOC_STREAMON, so we should override the name, to avoid it to also show _STREAMOFF. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: dev-osd: Fix some issues due to conversionMauro Carvalho Chehab1-2/+3
The conversion to ReST broke a minor things. Fix them. While here, also make EBUSY constant, just like on other places. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: dev-overlay: Fix conversion issuesMauro Carvalho Chehab1-24/+21
There were several conversion issues on this file, causing it to be badly formatted. Fix them, in order to match the design used on DocBook. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: buffer: numerate tables and figuresMauro Carvalho Chehab2-4/+10
Sphinx actually doesn't numerate tables nor figures. So, let's add a subtitle before each table. That makes them "numerated". While here, fix the git binary that got corrupted. Let's hope this will work, as the reason why we had to encode them were to prevent some issues on commiting those gif files on git. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: buffer: numerate tablesMauro Carvalho Chehab1-7/+31
Sphinx actually doesn't numerate tables. So, let's add a subtitle before each table. That makes them numerated. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: dmabuf: Add ioctl cross referencesMauro Carvalho Chehab1-19/+22
There are lots of ioctls mentioned there that aren't cross-referenced. Convert the const to cross references. That makes it visually better, and improves navigation along the document. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: dmabuf: re-add the missing captionsMauro Carvalho Chehab1-0/+3
The conversion from DocBook removed them. Re-add. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: linux_tv: remove whitespacesMauro Carvalho Chehab141-6030/+6030
Let's remove bad whitespaces on the entire book. That helps to avoid mixing whitespace removal with other patches. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: userp: Add ioctl cross referencesMauro Carvalho Chehab1-27/+29
There are lots of ioctls mentioned there that aren't cross-referenced. Convert the const to cross references. That makes it visually better, and improves navigation along the document. While here, remove bad whitespaces. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: userp: re-add the missing captionsMauro Carvalho Chehab1-0/+1
The conversion from DocBook removed them. Re-add. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: mmap: Add ioctl cross referencesMauro Carvalho Chehab1-97/+98
There are lots of ioctls mentioned there that aren't cross-referenced. Convert the const to cross references. That makes it visually better, and improves navigation along the document. While here, remove bad whitespaces. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: mmap: re-add the missing captionsMauro Carvalho Chehab1-0/+2
The conversion from DocBook removed them. Re-add. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: pixfmt-nv16m: remove an empty columnMauro Carvalho Chehab1-7/+0
The conversion added an empty column (probably, it was used on DocBook just to increase spacing. Remove it. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: v4l/pixfmt: re-join a broken paragraphMauro Carvalho Chehab39-74/+38
Originally, at the DocBook, the "Byte Order" were a single paragraph with the string that follows it. The conversion broke it, and, sometimes, it added an extra dot. Fix them altogheter at pixfmt-*. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: pixfmt-nv16m: remove an empty columnMauro Carvalho Chehab1-10/+0
The conversion added an empty column (probably, it was used on DocBook just to increase spacing. It also added an extra line on one of the texts, breaking the original paragraph into two ones. Remove them. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: linux_tv: Fix a warning at lirc_dev_introMauro Carvalho Chehab1-5/+5
Documentation/linux_tv/media/rc/lirc_dev_intro:17: WARNING: Inline substitution_reference start-string without end-string. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: linux_tv: promote generic documents to the parent dirMauro Carvalho Chehab3-2/+2
The generic error codes and licensing sections are general to the entire media book. They should not be inside the v4l dir. So, promote them to the parent directory. No functional changes. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: linux_tv: move MC stuff to a separate dirMauro Carvalho Chehab13-1/+1
When we wrote the media controller's section, we re-used the V4L, just because we were lazy to create a brand new DocBook. Yet, it is a little ackward to have it mixed with V4L. So, move it to its own directory, in order to have it better organized. No functional changes. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: linux_tv: move RC stuff to a separate dirMauro Carvalho Chehab12-1/+1
When we wrote the remote controller's section, we re-used the V4L, just because we were lazy to create a brand new DocBook. Yet, it is a little ackward to have it mixed with V4L. So, move it to its own directory, in order to have it better organized. No functional changes. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: linux_tv: avoid using c:func::Mauro Carvalho Chehab20-91/+92
Using auto-generated links is dangerous, as there are multiple definitions for syscalls (at least one on each book part). So, reference them by their explicit reference. I used this small script to help writing this patch: for i in $(git grep -l "c:func:"); do perl -ne 's/\:c\:func:\`(open|close|read|poll|write|select|mmap|munmap|ioctl)\(\)`/:ref:`$1() <func-$1>`/; print $_' < $i >a && mv a $i; done Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: linux_tv: fix remaining lack of escapesMauro Carvalho Chehab2-3/+3
Add escape before asterisk to fix those warnings: Documentation/linux_tv/media/dvb/FE_GET_EVENT:47: WARNING: Inline emphasis start-string without end-string. Documentation/linux_tv/media/v4l/media-ioc-enum-links:78: WARNING: Inline emphasis start-string without end-string. Documentation/linux_tv/media/v4l/media-ioc-enum-links:87: WARNING: Inline emphasis start-string without end-string. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: FE_DISHNETWORK_SEND_LEGACY_CMD: improve man-like formatMauro Carvalho Chehab1-7/+9
Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: FE_GET_EVENT: improve man-like formatMauro Carvalho Chehab1-6/+9
Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-07-04doc-rst: FE_GET_FRONTEND: improve man-like formatMauro Carvalho Chehab1-8/+10
Parsing this file were causing lots of warnings with sphinx, due to the c function prototypes. Fix that by prepending them with .. c:function:: While here, use the same way we document man-like pages, at the V4L side of the book and add escapes to asterisks. Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>