Skip to content

Add support to generate ABI documentation at admin-guide

Mauro Carvalho Chehab linux-doc lkml 2 versions In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v2 Latest16 patches 2 repliesIn review
  2. v114 patches 48 repliesSuperseded

Patches in v2 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/16ABI: sysfs-bus-pci-devices-aer_stats uses an invalid tagDocumentation/ABI/testing/sysfs-bus-pci-devices-aer_stats+6 -60 replies
2/16ABI: Fix KernelVersion tagsDocumentation/ABI/testing/pstore Documentation/ABI/testing/sysfs-bus-event_source-devices-format Documentation/ABI/testing/sysfs-bus-i2c-devices-hm6352 +7 more+31 -310 replies
3/16scripts: add an script to parse the ABI filesscripts/get_abi.pl+212 -01 reply
4/16scripts/get_abi.pl: parse files with text at beginningscripts/get_abi.pl+54 -50 replies
5/16scripts/get_abi.pl: avoid use literal blocks when not neededscripts/get_abi.pl+78 -260 replies
6/16scripts/get_abi.pl: split label naming from xref logicscripts/get_abi.pl+53 -410 replies
7/16scripts/get_abi.pl: add support for searching for ABI symbolsscripts/get_abi.pl+103 -90 replies
8/16scripts/get_abi.pl: represent what in tablesscripts/get_abi.pl+36 -50 replies
9/16scripts/get_abi.pl: fix parse issues with some filesscripts/get_abi.pl+2 -20 replies
10/16scripts/get_abi.pl: avoid creating duplicate namesscripts/get_abi.pl+9 -00 replies
11/16scripts/get_abi.pl: add a handler for invalid "where" tagscripts/get_abi.pl+6 -00 replies
12/16scripts/get_abi.pl: add a validate commandscripts/get_abi.pl+9 -70 replies
13/16doc-rst: add ABI documentation to the admin-guide bookDocumentation/admin-guide/abi-obsolete.rst Documentation/admin-guide/abi-removed.rst Documentation/admin-guide/abi-stable.rst +5 more+214 -10 replies
14/16docs: sphinx/kernel_abi.py: fix UTF-8 supportDocumentation/sphinx/kernel_abi.py+7 -130 replies
15/16sphinx/kernel_abi.py: make it compatible with Sphinx 1.7+Documentation/sphinx/kernel_abi.py+27 -120 replies
16/16docs: Kconfig/Makefile: add a check for broken ABI filesDocumentation/Kconfig Documentation/Makefile lib/Kconfig.debug +1 more+29 -30 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v2 yet.

Read the v2 thread

Cover letter [PATCH v2 00/16] Add support to generate ABI documentation at admin-guide

Greg,

In time: forgot to add a 00/16 patch... someone come to my desk while I was sending this... sorry for that.

That's the second version of the doc ABI updated logic.

Changes from version 1:

- I updated my e-mail on older patches;

- Two new ABI fix patches;

- Improved the parser to detect a few more issues I discovered on some ABI files.

- There's now a "validate" command at get_abi.pl. It simply runs the parser without any output, except for warnings;

- It now runs "get_abi.pl validate" during the build (if enabled).

Please notice that the last patch will conflict with another patch merged via docs-next tree, with creates a Documentation/Kconfig and adds a check at Documentation/Makefile for broken documentation links. The conflict is trivial to solve, through: just add the contents on both tress.

This series is based on your driver-core git tree.

-

On this series:

- The first two patches contain two extra ABI fixes;

- The next 10 patches contain the ABI parsing script. I don't mind if you prefer folding them on a single patch, but IMO, preserving the history may help tracking bugs, if any;

- The 13th patch adds the new script to the documentation build system, together with a new python Sphinx extension with calls it;

- The 14th patch fixes the python script when running with newer Sphinx versions (1.7 and upper);

- The 15th patch fixes an UTF-8 troubles;

- The final patch adds a Kconfig var that will check for ABI file problems, if COMPILE_TEST and WARN_ABI_ERRORS are enabled.

Mauro Carvalho Chehab (16):
ABI: sysfs-bus-pci-devices-aer_stats uses an invalid tag
ABI: Fix KernelVersion tags
scripts: add an script to parse the ABI files scripts/get_abi.pl: parse files with text at beginning scripts/get_abi.pl: avoid use literal blocks when not needed scripts/get_abi.pl: split label naming from xref logic scripts/get_abi.pl: add support for searching for ABI symbols scripts/get_abi.pl: represent what in tables scripts/get_abi.pl: fix parse issues with some files scripts/get_abi.pl: avoid creating duplicate names scripts/get_abi.pl: add a handler for invalid "where" tag scripts/get_abi.pl: add a validate command
doc-rst: add ABI documentation to the admin-guide book
docs: sphinx/kernel_abi.py: fix UTF-8 support sphinx/kernel_abi.py: make it compatible with Sphinx 1.7+
docs: Kconfig/Makefile: add a check for broken ABI files

 Documentation/ABI/testing/pstore              |   2 +-
 .../sysfs-bus-event_source-devices-format     |   2 +-
 .../ABI/testing/sysfs-bus-i2c-devices-hm6352  |   6 +-
 .../testing/sysfs-bus-pci-devices-aer_stats   |  24 +-
 .../ABI/testing/sysfs-bus-pci-devices-cciss   |  22 +-
 .../testing/sysfs-bus-usb-devices-usbsevseg   |  10 +-
 .../ABI/testing/sysfs-driver-altera-cvp       |   2 +-
 Documentation/ABI/testing/sysfs-driver-ppi    |   2 +-
 Documentation/ABI/testing/sysfs-driver-st     |   2 +-
 Documentation/ABI/testing/sysfs-driver-wacom  |   2 +-
 Documentation/Kconfig                         |  11 +
 Documentation/Makefile                        |   5 +
 Documentation/admin-guide/abi-obsolete.rst    |  10 +
 Documentation/admin-guide/abi-removed.rst     |   4 +
 Documentation/admin-guide/abi-stable.rst      |  13 +
 Documentation/admin-guide/abi-testing.rst     |  19 +
 Documentation/admin-guide/abi.rst             |  11 +
 Documentation/admin-guide/index.rst           |   1 +
 Documentation/conf.py                         |   2 +-
 Documentation/sphinx/kernel_abi.py            | 164 ++++++
 lib/Kconfig.debug                             |   2 +
 scripts/get_abi.pl                            | 475 ++++++++++++++++++
 22 files changed, 753 insertions(+), 38 deletions(-)
 create mode 100644 Documentation/Kconfig
 create mode 100644 Documentation/admin-guide/abi-obsolete.rst
 create mode 100644 Documentation/admin-guide/abi-removed.rst
 create mode 100644 Documentation/admin-guide/abi-stable.rst
 create mode 100644 Documentation/admin-guide/abi-testing.rst
 create mode 100644 Documentation/admin-guide/abi.rst
 create mode 100644 Documentation/sphinx/kernel_abi.py
 create mode 100755 scripts/get_abi.pl
Signature · 1 line
2.21.0