[PULL] Docs for 4.13

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



The following changes since commit
2ea659a9ef488125eb46da6eb571de5eae5c43f6:

  Linux 4.12-rc1 (2017-05-13 13:19:49 -0700)

are available in the git repository at:

  git://git.lwn.net/linux.git tags/docs-4.13

for you to fetch changes up to 1cb566ba5634d7593b8b2a0a5c83f1c9e14b2e09:

  scripts/kernel-doc: handle DECLARE_HASHTABLE (2017-07-03 06:57:09 -0600)

----------------------------------------------------------------
There has been a fair amount of activity in the docs tree this time
around.  Highlights include:

 - Conversion of a bunch of security documentation into RST

 - The conversion of the remaining DocBook templates by The Amazing
   Mauro Machine.  We can now drop the entire DocBook build chain.

 - The usual collection of fixes and minor updates.

NOTES: this is a somewhat messy-looking pull, unfortunately, due to the
       nature of the changes.  Mauro's work, in particular, involved fixing
       lots of kerneldoc comments elsewhere in the tree; there are no code
       changes in the non-docs stuff.

       You'll also encounter more than the usual number of conflicts, which
       is saying something.  The tip tree tweaked kernel-hacking.tmpl,
       which got converted to RST; the change just needs to be carried
       over.  There is a similar situation with w1.tmpl being changed in
       the char-misc tree.  Kbuild wants to change the shebang line in the
       kernel-doc-xml-ref tool, but that tool is just not needed anymore.

       Hopefully, as the transition settles down we'll see less of this
       kind of stuff.  Meanwhile thanks to Stephen for flagging and
       managing all of these.

----------------------------------------------------------------
Ayan Shafqat (1):
      Doc: fix a markup error in coding-style.rst

Jakub Kicinski (1):
      scripts/kernel-doc: handle DECLARE_HASHTABLE

Jonathan Corbet (7):
      Merge tag 'v4.12-rc1' into docs-next
      docs: Fix some formatting issues in request-key.rst
      Merge remote-tracking branch 'mauro-exp/docbook3' into death-to-docbook
      Docs: Include the Latex "ifthen" package
      Docs: fix table problems in ras.rst
      Docs: Use kernel-figure in vidioc-g-selection.rst
      Docs: clean up some DocBook loose ends

Kees Cook (17):
      doc: ReSTify seccomp_filter.txt
      doc: ReSTify no_new_privs.txt
      doc: ReSTify IMA-templates.txt
      doc: ReSTify credentials.txt
      doc: ReSTify self-protection.txt
      doc: security: minor cleanups to build kernel-doc
      doc: ReSTify and split LSM.txt
      doc: ReSTify SELinux.txt
      doc: ReSTify apparmor.txt
      doc: ReSTify tomoyo.txt
      doc: ReSTify Yama.txt
      doc: ReSTify LoadPin.txt
      doc: ReSTify Smack.txt
      doc: ReSTify keys.txt
      doc: ReSTify keys-ecryptfs.txt
      doc: ReSTify keys-request-key.txt
      doc: ReSTify keys-trusted-encrypted.txt

Konstantin Ryabitsev (1):
      Make the main documentation title less Geocities

Markus Heiser (2):
      core-api: remove an unexpected unident
      doc-rst: fix inline emphasis in unshare.rst

Mauro Carvalho Chehab (54):
      docs-rst: convert kernel-hacking to ReST
      kernel-hacking: update document
      docs-rst: convert kernel-locking to ReST
      mutex, futex: adjust kernel-doc markups to generate ReST
      locking.rst: reformat locking table
      locking.rst: add captions to two tables
      locking.rst: Update some ReST markups
      docs-rst: convert kgdb DocBook to ReST
      kgdb.rst: Adjust ReST markups
      conf.py: define a color for important markup on PDF output
      docs-rst: conf.py: sort LaTeX documents in alphabetical order
      docs-rst: conf.py: remove kernel-documentation from LaTeX
      docs-rst: add crypto API book to pdf output
      docs-rst: add dev-tools book to pdf output
      docs-rst: add sound book to pdf output
      docs-rst: add userspace API book to pdf output
      docs-rst: convert filesystems book to ReST
      docs-rst: filesystems: use c domain references where needed
      fs: jbd2: make jbd2_journal_start() kernel-doc parseable
      docs-rst: don't ignore internal functions for jbd2 docs
      fs: add a blank lines on some kernel-doc comments
      fs: eventfd: fix identation on kernel-doc
      fs: jbd2: escape a string with special chars on a kernel-doc
      docs-rst: convert libata book to ReST
      libata.rst: add c function and struct cross-references
      libata: fix identation on a kernel-doc markup
      docs-rst: convert s390-drivers DocBook to ReST
      docs-rst: convert networking book to ReST
      net: skbuff.h: properly escape a macro name on kernel-doc
      net: fix some identation issues at kernel-doc markups
      docs-rst: convert z8530book DocBook to ReST
      docs-rst: convert scsi DocBook to ReST
      scsi: fix some kernel-doc markups
      docs-rst: convert w1 book to ReST
      docs-rst: convert rapidio book to ReST
      docs-rst: convert librs book to ReST
      docs-rst: convert mtdnand book to ReST
      mtdnand.rst: group the "::" with previous line
      mtd: adjust kernel-docs to avoid Sphinx/kerneldoc warnings
      docs-rst: convert sh book to ReST
      docs-rst: convert lsm from DocBook to ReST
      docs: remove DocBook from the building system
      docs: update old references for DocBook from the documentation
      MAINTAINERS: update old references for DocBook directory
      ata: update references for libata documentation
      ia64, scsi: update references for the device-io book
      irq: update genericirq book location
      fs: update location of filesystems documentation
      lib: update location of kgdb documentation
      fs: fix the location of the kernel-api book
      usb: fix the comment with regards to DocBook
      docs-rst: get rid of Documentation/sphinx/tmplcvt script
      kernel-doc: describe the ``literal`` syntax
      Docs: Fix breakage with Sphinx 1.5 and upper

Palmer Dabbelt (1):
      Documentation: atomic_ops.txt is core-api/atomic_ops.rst

Sanjeev Gupta (1):
      Docs: Insert missing space to separate link from text

SeongJae Park (2):
      doc/ko_KR/memory-barriers: Update control-dependencies example
      doc/kokr/howto: Only send regression fixes after -rc1

Steffen Maier (1):
      docs-rst: fix broken links to dynamic-debug-howto in kernel-parameters

Stewart Smith (1):
      doc: Document suitability of IBM Verse for kernel development

Tobias Klauser (1):
      Documentation, kbuild: fix typo "minimun" -> "minimum"

Wolfram Sang (2):
      Documentation: DMA API: fix a typo in a function name
      docs: driver-api: i2c: remove some outdated information

 Documentation/00-INDEX                             |    6 +-
 Documentation/DMA-API.txt                          |    2 +-
 Documentation/DocBook/.gitignore                   |   17 -
 Documentation/DocBook/Makefile                     |  282 ---
 Documentation/DocBook/filesystems.tmpl             |  381 ----
 Documentation/DocBook/kernel-hacking.tmpl          | 1312 ------------
 Documentation/DocBook/kernel-locking.tmpl          | 2151 --------------------
 Documentation/DocBook/kgdb.tmpl                    |  918 ---------
 Documentation/DocBook/libata.tmpl                  | 1625 ---------------
 Documentation/DocBook/librs.tmpl                   |  289 ---
 Documentation/DocBook/lsm.tmpl                     |  265 ---
 Documentation/DocBook/mtdnand.tmpl                 | 1291 ------------
 Documentation/DocBook/networking.tmpl              |  111 -
 Documentation/DocBook/rapidio.tmpl                 |  155 --
 Documentation/DocBook/s390-drivers.tmpl            |  161 --
 Documentation/DocBook/scsi.tmpl                    |  409 ----
 Documentation/DocBook/sh.tmpl                      |  105 -
 Documentation/DocBook/stylesheet.xsl               |   11 -
 Documentation/DocBook/w1.tmpl                      |  101 -
 Documentation/DocBook/z8530book.tmpl               |  371 ----
 Documentation/Makefile                             |  125 ++
 Documentation/Makefile.sphinx                      |  130 --
 Documentation/PCI/MSI-HOWTO.txt                    |    2 +-
 .../LoadPin.txt => admin-guide/LSM/LoadPin.rst}    |   12 +-
 .../SELinux.txt => admin-guide/LSM/SELinux.rst}    |   18 +-
 .../Smack.txt => admin-guide/LSM/Smack.rst}        |  273 ++-
 .../Yama.txt => admin-guide/LSM/Yama.rst}          |   55 +-
 .../apparmor.txt => admin-guide/LSM/apparmor.rst}  |   36 +-
 .../LSM.txt => admin-guide/LSM/index.rst}          |   28 +-
 .../tomoyo.txt => admin-guide/LSM/tomoyo.rst}      |   22 +-
 Documentation/admin-guide/README.rst               |    6 -
 Documentation/admin-guide/index.rst                |    1 +
 Documentation/admin-guide/kernel-parameters.txt    |    6 +-
 Documentation/admin-guide/ras.rst                  |   10 +-
 Documentation/conf.py                              |   44 +-
 Documentation/core-api/assoc_array.rst             |    5 +-
 Documentation/core-api/index.rst                   |    1 +
 Documentation/core-api/librs.rst                   |  212 ++
 Documentation/crypto/asymmetric-keys.txt           |    2 +-
 Documentation/crypto/conf.py                       |   10 +
 Documentation/dev-tools/index.rst                  |    1 +
 Documentation/dev-tools/kgdb.rst                   |  907 +++++++++
 Documentation/doc-guide/docbook.rst                |   90 -
 Documentation/doc-guide/index.rst                  |    1 -
 Documentation/doc-guide/kernel-doc.rst             |   10 +
 Documentation/doc-guide/sphinx.rst                 |    5 -
 Documentation/dontdiff                             |    1 -
 Documentation/driver-api/i2c.rst                   |    9 +-
 Documentation/driver-api/index.rst                 |    6 +
 Documentation/driver-api/libata.rst                | 1031 ++++++++++
 Documentation/driver-api/mtdnand.rst               | 1007 +++++++++
 Documentation/driver-api/rapidio.rst               |  107 +
 Documentation/driver-api/s390-drivers.rst          |  111 +
 Documentation/driver-api/scsi.rst                  |  344 ++++
 Documentation/driver-api/w1.rst                    |   70 +
 Documentation/fb/api.txt                           |    4 +-
 Documentation/filesystems/conf.py                  |   10 +
 Documentation/filesystems/index.rst                |  317 +++
 Documentation/filesystems/nfs/idmapper.txt         |    2 +-
 Documentation/gpu/todo.rst                         |    2 +-
 Documentation/index.rst                            |   18 +-
 Documentation/kbuild/makefiles.txt                 |    2 +-
 Documentation/kernel-doc-nano-HOWTO.txt            |   65 +-
 Documentation/kernel-hacking/conf.py               |   10 +
 Documentation/kernel-hacking/hacking.rst           |  811 ++++++++
 Documentation/kernel-hacking/index.rst             |    9 +
 Documentation/kernel-hacking/locking.rst           | 1446 +++++++++++++
 Documentation/lsm.txt                              |  201 ++
 .../media/uapi/v4l/vidioc-g-selection.rst          |    4 +-
 Documentation/memory-barriers.txt                  |   10 +-
 Documentation/networking/conf.py                   |   10 +
 Documentation/networking/dns_resolver.txt          |    2 +-
 Documentation/networking/index.rst                 |   18 +
 Documentation/networking/kapi.rst                  |  147 ++
 Documentation/networking/z8530book.rst             |  256 +++
 Documentation/process/changes.rst                  |   26 +-
 Documentation/process/coding-style.rst             |    4 +-
 Documentation/process/email-clients.rst            |    5 +
 Documentation/process/howto.rst                    |    8 -
 Documentation/process/kernel-docs.rst              |   34 +-
 Documentation/security/00-INDEX                    |   26 -
 .../{IMA-templates.txt => IMA-templates.rst}       |   46 +-
 Documentation/security/LSM.rst                     |   14 +
 Documentation/security/conf.py                     |    8 -
 .../security/{credentials.txt => credentials.rst}  |  275 ++-
 Documentation/security/index.rst                   |    8 +-
 Documentation/security/{keys.txt => keys/core.rst} |  314 ++-
 .../{keys-ecryptfs.txt => keys/ecryptfs.rst}       |   19 +-
 Documentation/security/keys/index.rst              |   11 +
 .../{keys-request-key.txt => keys/request-key.rst} |   73 +-
 .../trusted-encrypted.rst}                         |   32 +-
 .../{self-protection.txt => self-protection.rst}   |   99 +-
 Documentation/sh/conf.py                           |   10 +
 Documentation/sh/index.rst                         |   59 +
 Documentation/sound/conf.py                        |   10 +
 Documentation/sphinx/convert_template.sed          |   18 -
 Documentation/sphinx/post_convert.sed              |   23 -
 Documentation/sphinx/tmplcvt                       |   28 -
 Documentation/translations/ja_JP/howto.rst         |    7 -
 Documentation/translations/ko_KR/howto.rst         |   27 +-
 .../translations/ko_KR/memory-barriers.txt         |    2 +-
 Documentation/userspace-api/index.rst              |    2 +
 .../no_new_privs.rst}                              |   44 +-
 .../seccomp_filter.rst}                            |  116 +-
 Documentation/userspace-api/unshare.rst            |    2 +-
 MAINTAINERS                                        |   21 +-
 Makefile                                           |   10 +-
 arch/ia64/include/asm/io.h                         |    2 +-
 arch/ia64/sn/kernel/iomv.c                         |    2 +-
 drivers/ata/acard-ahci.c                           |    2 +-
 drivers/ata/ahci.c                                 |    2 +-
 drivers/ata/ahci.h                                 |    2 +-
 drivers/ata/ata_piix.c                             |    2 +-
 drivers/ata/libahci.c                              |    2 +-
 drivers/ata/libata-core.c                          |    2 +-
 drivers/ata/libata-eh.c                            |    2 +-
 drivers/ata/libata-scsi.c                          |    9 +-
 drivers/ata/libata-sff.c                           |    2 +-
 drivers/ata/libata.h                               |    2 +-
 drivers/ata/pata_pdc2027x.c                        |    2 +-
 drivers/ata/pdc_adma.c                             |    2 +-
 drivers/ata/sata_nv.c                              |    2 +-
 drivers/ata/sata_promise.c                         |    2 +-
 drivers/ata/sata_promise.h                         |    2 +-
 drivers/ata/sata_qstor.c                           |    2 +-
 drivers/ata/sata_sil.c                             |    2 +-
 drivers/ata/sata_sis.c                             |    2 +-
 drivers/ata/sata_svw.c                             |    2 +-
 drivers/ata/sata_sx4.c                             |    2 +-
 drivers/ata/sata_uli.c                             |    2 +-
 drivers/ata/sata_via.c                             |    2 +-
 drivers/ata/sata_vsc.c                             |    2 +-
 drivers/mtd/nand/nand_base.c                       |    7 +-
 drivers/net/phy/phy.c                              |    1 +
 drivers/scsi/qla1280.c                             |    2 +-
 drivers/scsi/scsi_scan.c                           |    7 +-
 drivers/scsi/scsi_transport_fc.c                   |   18 +-
 drivers/scsi/scsicam.c                             |    4 +-
 drivers/usb/gadget/Kconfig                         |    2 +-
 fs/debugfs/file.c                                  |    2 +-
 fs/debugfs/inode.c                                 |    2 +-
 fs/eventfd.c                                       |    4 +-
 fs/fs-writeback.c                                  |   12 +-
 fs/jbd2/transaction.c                              |   42 +-
 fs/mpage.c                                         |    1 +
 fs/namei.c                                         |    1 +
 include/linux/ata.h                                |    2 +-
 include/linux/cred.h                               |    2 +-
 include/linux/debugfs.h                            |    2 +-
 include/linux/key.h                                |    2 +-
 include/linux/libata.h                             |    2 +-
 include/linux/lsm_hooks.h                          |   25 +-
 include/linux/mtd/nand.h                           |    2 +-
 include/linux/mutex.h                              |    6 +-
 include/linux/netdevice.h                          |    9 +-
 include/linux/skbuff.h                             |    2 +-
 include/net/sock.h                                 |    9 +-
 kernel/cred.c                                      |    2 +-
 kernel/futex.c                                     |   40 +-
 kernel/irq/chip.c                                  |    2 +-
 kernel/irq/handle.c                                |    2 +-
 kernel/irq/irqdesc.c                               |    2 +-
 kernel/locking/mutex.c                             |    6 +-
 lib/Kconfig.debug                                  |    2 +-
 lib/Kconfig.kgdb                                   |    2 +-
 net/core/datagram.c                                |    2 +-
 net/core/sock.c                                    |    7 +-
 scripts/.gitignore                                 |    1 -
 scripts/Makefile                                   |   10 +-
 scripts/check-lc_ctype.c                           |   11 -
 scripts/docproc.c                                  |  681 -------
 scripts/kernel-doc                                 |    2 +
 scripts/kernel-doc-xml-ref                         |  198 --
 scripts/selinux/README                             |    2 +-
 security/apparmor/match.c                          |    2 +-
 security/apparmor/policy_unpack.c                  |    2 +-
 security/keys/encrypted-keys/encrypted.c           |    2 +-
 security/keys/encrypted-keys/masterkey_trusted.c   |    2 +-
 security/keys/request_key.c                        |    2 +-
 security/keys/request_key_auth.c                   |    2 +-
 security/keys/trusted.c                            |    2 +-
 security/yama/Kconfig                              |    3 +-
 182 files changed, 8404 insertions(+), 12196 deletions(-)
 delete mode 100644 Documentation/DocBook/.gitignore
 delete mode 100644 Documentation/DocBook/Makefile
 delete mode 100644 Documentation/DocBook/filesystems.tmpl
 delete mode 100644 Documentation/DocBook/kernel-hacking.tmpl
 delete mode 100644 Documentation/DocBook/kernel-locking.tmpl
 delete mode 100644 Documentation/DocBook/kgdb.tmpl
 delete mode 100644 Documentation/DocBook/libata.tmpl
 delete mode 100644 Documentation/DocBook/librs.tmpl
 delete mode 100644 Documentation/DocBook/lsm.tmpl
 delete mode 100644 Documentation/DocBook/mtdnand.tmpl
 delete mode 100644 Documentation/DocBook/networking.tmpl
 delete mode 100644 Documentation/DocBook/rapidio.tmpl
 delete mode 100644 Documentation/DocBook/s390-drivers.tmpl
 delete mode 100644 Documentation/DocBook/scsi.tmpl
 delete mode 100644 Documentation/DocBook/sh.tmpl
 delete mode 100644 Documentation/DocBook/stylesheet.xsl
 delete mode 100644 Documentation/DocBook/w1.tmpl
 delete mode 100644 Documentation/DocBook/z8530book.tmpl
 delete mode 100644 Documentation/Makefile.sphinx
 rename Documentation/{security/LoadPin.txt => admin-guide/LSM/LoadPin.rst} (73%)
 rename Documentation/{security/SELinux.txt => admin-guide/LSM/SELinux.rst} (71%)
 rename Documentation/{security/Smack.txt => admin-guide/LSM/Smack.rst} (85%)
 rename Documentation/{security/Yama.txt => admin-guide/LSM/Yama.rst} (60%)
 rename Documentation/{security/apparmor.txt => admin-guide/LSM/apparmor.rst} (65%)
 rename Documentation/{security/LSM.txt => admin-guide/LSM/index.rst} (62%)
 rename Documentation/{security/tomoyo.txt => admin-guide/LSM/tomoyo.rst} (85%)
 create mode 100644 Documentation/core-api/librs.rst
 create mode 100644 Documentation/crypto/conf.py
 create mode 100644 Documentation/dev-tools/kgdb.rst
 delete mode 100644 Documentation/doc-guide/docbook.rst
 create mode 100644 Documentation/driver-api/libata.rst
 create mode 100644 Documentation/driver-api/mtdnand.rst
 create mode 100644 Documentation/driver-api/rapidio.rst
 create mode 100644 Documentation/driver-api/s390-drivers.rst
 create mode 100644 Documentation/driver-api/scsi.rst
 create mode 100644 Documentation/driver-api/w1.rst
 create mode 100644 Documentation/filesystems/conf.py
 create mode 100644 Documentation/filesystems/index.rst
 create mode 100644 Documentation/kernel-hacking/conf.py
 create mode 100644 Documentation/kernel-hacking/hacking.rst
 create mode 100644 Documentation/kernel-hacking/index.rst
 create mode 100644 Documentation/kernel-hacking/locking.rst
 create mode 100644 Documentation/lsm.txt
 create mode 100644 Documentation/networking/conf.py
 create mode 100644 Documentation/networking/index.rst
 create mode 100644 Documentation/networking/kapi.rst
 create mode 100644 Documentation/networking/z8530book.rst
 delete mode 100644 Documentation/security/00-INDEX
 rename Documentation/security/{IMA-templates.txt => IMA-templates.rst} (72%)
 create mode 100644 Documentation/security/LSM.rst
 delete mode 100644 Documentation/security/conf.py
 rename Documentation/security/{credentials.txt => credentials.rst} (72%)
 rename Documentation/security/{keys.txt => keys/core.rst} (89%)
 rename Documentation/security/{keys-ecryptfs.txt => keys/ecryptfs.rst} (91%)
 create mode 100644 Documentation/security/keys/index.rst
 rename Documentation/security/{keys-request-key.txt => keys/request-key.rst} (77%)
 rename Documentation/security/{keys-trusted-encrypted.txt => keys/trusted-encrypted.rst} (93%)
 rename Documentation/security/{self-protection.txt => self-protection.rst} (83%)
 create mode 100644 Documentation/sh/conf.py
 create mode 100644 Documentation/sh/index.rst
 create mode 100644 Documentation/sound/conf.py
 delete mode 100644 Documentation/sphinx/convert_template.sed
 delete mode 100644 Documentation/sphinx/post_convert.sed
 delete mode 100755 Documentation/sphinx/tmplcvt
 rename Documentation/{prctl/no_new_privs.txt => userspace-api/no_new_privs.rst} (54%)
 rename Documentation/{prctl/seccomp_filter.txt => userspace-api/seccomp_filter.rst} (71%)
 delete mode 100644 scripts/check-lc_ctype.c
 delete mode 100644 scripts/docproc.c
 delete mode 100755 scripts/kernel-doc-xml-ref
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux