[PULL] Documentation changes for 4.7

From: Jonathan Corbet
Date: Thu May 19 2016 - 14:55:28 EST


Here's the documentation tree for 4.7. A bit busier this time around;
details below.

Thanks,

jon

The following changes since commit
f55532a0c0b8bb6148f4e07853b876ef73bc69ca:

Linux 4.6-rc1 (2016-03-26 16:03:24 -0700)

are available in the git repository at:

git://git.lwn.net/linux.git tags/docs-for-linus

for you to fetch changes up to 9f8036643dd9609b329aa1b89c9a95981e9ba62f:

doc: self-protection: provide initial details (2016-05-17 16:24:52 -0600)

----------------------------------------------------------------
The most interesting thing (IMO) this time around is some beginning
infrastructural work to allow documents to be written using restructured
text. Maybe someday, in a galaxy far far away, we'll be able to eliminate
the DocBook dependency and have a much better integrated set of kernel
docs. Someday.

Beyond that, there's a new document on security hardening from Kees, the
movement of some sample code over to samples/, a number of improvements to
the serial docs from Geert, and the usual collection of corrections, typo
fixes, etc.

----------------------------------------------------------------
Alexander Kurz (1):
Documentation: devres: Add missing INPUT function

Arnd Bergmann (2):
samples: connector: from Documentation to samples directory
samples: v4l: from Documentation to samples directory

Askar Safin (1):
documentation: trivial typo: adding-syscalls.txt: s/statat/fstatat/

Baolin Wang (1):
Documentation: mmc: Add the introduction for mmc-utils

Cao jin (1):
hrtimers: doc cleanup

Dave Anderson (1):
bpf: doc: "neg" opcode has no operands

Diego Herranz (1):
doc: usb: Fix typo in gadget_multi documentation

Diego Viola (1):
README: remove trailing whitespace

Doug Hoyte (1):
Documentation typo: wrong page flag bit for KPF_HUGE

Eric Engestrom (7):
Documentation: laptops: fix spelling mistake
Documentation: lzo: fix spelling mistakes
Documentation: pps: fix spelling mistake
Documentation: robust-futexes: fix spelling mistakes
Documentation: scsi: fix spelling mistakes
Documentation: x86: fix spelling mistakes
Documentation: xillybus: fix spelling mistake

Fu Wei (1):
Documentation:Update Documentation/zh_CN/arm64/booting.txt

Geert Uytterhoeven (16):
serial: doc: Un-document non-existing uart_write_console()
serial: doc: Un-document obsolete tmpbuf_sem
serial: doc: Document .throttle()
serial: doc: Document .unthrottle()
serial: doc: Document .set_ldisc()
serial: doc: .break_ctl() is called with port->mutex() held
serial: doc: Spelling s/divsor/divisor/
serial: doc: Grammar s/function are/functions are/
serial: doc: Correct return type of mctrl_gpio_to_gpiod()
serial: doc: Re-add paragraph documenting uart_console_write()
serial: doc: .(un)throttle() depends on hardware assisted flow control
serial: doc: .(un)throttle() are serialized by the tty layer
serial: doc: .break_ctl() may sleep
Documentation: vm: Spelling s/paltform/platform/g
serial: doc: Always refer to tty_port->mutex
serial: doc: Use port->state instead of info

Jani Nikula (8):
kernel-doc: rewrite usage description, remove duplicated comments
kernel-doc: use rst C domain directives and references for types
docproc: add variables for subcommand and filename
docproc: reduce unnecessary indentation
docproc: abstract docproc directive detection
docproc: abstract terminating lines at first space
docproc: add support for reStructuredText format via --rst option
docproc: print a comment about autogeneration for rst output

Jianyu Zhan (1):
Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}

Jonathan Corbet (2):
kernel-doc: produce RestructuredText output
Merge branch 'jani-rest' into docs-next

Kees Cook (2):
Documentation: fix common spelling mistakes
doc: self-protection: provide initial details

Luis de Bethencourt (4):
Documentation: add Linux Kernel Development book
Documentation: update URL of Analysis of the Ext2fs structure
Documentation: update URLs for Richard Gooch's articles
Documentation: update Michael K. Johnson's work

Qiang Huang (1):
Documentation/memcg: update kmem limit doc as codes behavior

Renà Nyffenegger (1):
Doc: correct the location of sysrq.c

SeongJae Park (2):
Documentatio: HOWTO: remove regression postings info from translations
Documentation: HOWTO: update git home URL in translations

Wei Fang (1):
Documentation: update missing index files in block/00-INDEX

.../ABI/obsolete/sysfs-driver-hid-roccat-savu | 11 +-
.../testing/sysfs-bus-event_source-devices-hv_24x7 | 2 +-
Documentation/ABI/testing/sysfs-driver-hid-picolcd | 2 +-
Documentation/ABI/testing/sysfs-firmware-acpi | 2 +-
Documentation/DocBook/media/v4l/controls.xml | 2 +-
Documentation/DocBook/media/v4l/dev-raw-vbi.xml | 2 +-
.../DocBook/media/v4l/vidioc-g-selection.xml | 2 +-
Documentation/IRQ-domain.txt | 12 +
Documentation/Makefile | 5 +-
Documentation/RCU/RTFP.txt | 6 +-
Documentation/adding-syscalls.txt | 2 +-
Documentation/arm/SA1100/Assabet | 2 +-
Documentation/block/00-INDEX | 4 +
Documentation/cgroup-v1/memory.txt | 14 +-
Documentation/connector/connector.txt | 8 +
Documentation/devicetree/bindings/mfd/arizona.txt | 2 +-
Documentation/driver-model/devres.txt | 3 +
Documentation/filesystems/cifs/README | 2 +-
.../filesystems/pohmelfs/design_notes.txt | 2 +-
Documentation/filesystems/qnx6.txt | 2 +-
Documentation/firmware_class/README | 2 +-
Documentation/hwmon/abituguru | 2 +-
Documentation/infiniband/ipoib.txt | 2 +-
Documentation/ja_JP/HOWTO | 6 -
Documentation/kernel-docs.txt | 29 +-
Documentation/ko_KR/HOWTO | 8 +-
Documentation/laptops/toshiba_haps.txt | 2 +-
Documentation/lzo.txt | 4 +-
Documentation/mmc/00-INDEX | 2 +
Documentation/mmc/mmc-tools.txt | 34 +++
Documentation/networking/altera_tse.txt | 2 +-
Documentation/networking/can.txt | 2 +-
Documentation/networking/filter.txt | 2 +-
Documentation/pps/pps.txt | 2 +-
Documentation/robust-futexes.txt | 6 +-
Documentation/scsi/ChangeLog.megaraid_sas | 48 ++--
Documentation/scsi/bfa.txt | 2 +-
Documentation/security/self-protection.txt | 261 +++++++++++++++++
Documentation/serial/driver | 54 ++--
Documentation/sysrq.txt | 2 +-
Documentation/timers/hrtimers.txt | 6 +-
Documentation/usb/gadget_multi.txt | 2 +-
Documentation/video4linux/README.cx88 | 2 +-
Documentation/video4linux/bttv/Sound-FAQ | 2 +-
Documentation/video4linux/v4l2-framework.txt | 2 +-
Documentation/vm/hugetlbpage.txt | 6 +-
Documentation/vm/pagemap.txt | 2 +-
Documentation/x86/intel_mpx.txt | 4 +-
Documentation/xillybus.txt | 2 +-
Documentation/zh_CN/HOWTO | 4 +-
Documentation/zh_CN/arm64/booting.txt | 20 +-
README | 20 +-
samples/Kconfig | 9 +
samples/Makefile | 2 +-
{Documentation => samples}/connector/.gitignore | 0
{Documentation => samples}/connector/Makefile | 6 +-
{Documentation => samples}/connector/cn_test.c | 0
{Documentation => samples}/connector/ucon.c | 0
.../video4linux => samples/v4l}/Makefile | 0
.../v4l}/v4l2-pci-skeleton.c | 0
scripts/docproc.c | 221 +++++++++++----
scripts/kernel-doc | 315 ++++++++++++++++++---
62 files changed, 926 insertions(+), 258 deletions(-)
create mode 100644 Documentation/mmc/mmc-tools.txt
create mode 100644 Documentation/security/self-protection.txt
rename {Documentation => samples}/connector/.gitignore (100%)
rename {Documentation => samples}/connector/Makefile (76%)
rename {Documentation => samples}/connector/cn_test.c (100%)
rename {Documentation => samples}/connector/ucon.c (100%)
rename {Documentation/video4linux => samples/v4l}/Makefile (100%)
rename {Documentation/video4linux => samples/v4l}/v4l2-pci-skeleton.c (100%)