Merge tag 'docs-6.19' of git://git.lwn.net/linux

Pull documentation updates from Jonathan Corbet:
 "This has been another busy cycle for documentation, with a lot of
  build-system thrashing. That work should slow down from here on out.

   - The various scripts and tools for documentation were spread out in
     several directories; now they are (almost) all coalesced under
     tools/docs/. The holdout is the kernel-doc script, which cannot be
     easily moved without some further thought.

   - As the amount of Python code increases, we are accumulating modules
     that are imported by multiple programs. These modules have been
     pulled together under tools/lib/python/ -- at least, for
     documentation-related programs. There is other Python code in the
     tree that might eventually want to move toward this organization.

   - The Perl kernel-doc.pl script has been removed. It is no longer
     used by default, and nobody has missed it, least of all anybody who
     actually had to look at it.

   - The docs build was controlled by a complex mess of makefilese that
     few dared to touch. Mauro has moved that logic into a new program
     (tools/docs/sphinx-build-wrapper) that, with any luck at all, will
     be far easier to understand and maintain.

   - The get_feat.pl program, used to access information under
     Documentation/features/, has been rewritten in Python, bringing an
     end to the use of Perl in the docs subsystem.

   - The top-level README file has been reorganized into a more
     reader-friendly presentation.

   - A lot of Chinese translation additions

   - Typo fixes and documentation updates as usual"

* tag 'docs-6.19' of git://git.lwn.net/linux: (164 commits)
  docs: makefile: move rustdoc check to the build wrapper
  README: restructure with role-based documentation and guidelines
  docs: kdoc: various fixes for grammar, spelling, punctuation
  docs: kdoc_parser: use '@' for Excess enum value
  docs: submitting-patches: Clarify that removal of Acks needs explanation too
  docs: kdoc_parser: add data/function attributes to ignore
  docs: MAINTAINERS: update Mauro's files/paths
  docs/zh_CN: Add wd719x.rst translation
  docs/zh_CN: Add libsas.rst translation
  get_feat.pl: remove it, as it got replaced by get_feat.py
  Documentation/sphinx/kernel_feat.py: use class directly
  tools/docs/get_feat.py: convert get_feat.pl to Python
  Documentation/admin-guide: fix typo and comment in cscope example
  docs/zh_CN: Add data-integrity.rst translation
  docs/zh_CN: Add blk-mq.rst translation
  docs/zh_CN: Add block/index.rst translation
  docs/zh_CN: Update the Chinese translation of kbuild.rst
  docs: bring some order to our Python module hierarchy
  docs: Move the python libraries to tools/lib/python
  Documentation/kernel-parameters: Move the kernel build options
  ...

1 files changed, 0 insertions, 214 deletions

diff --git a/scripts/get_abi.py b/scripts/get_abi.py
deleted file mode 100755
index 7ce4748a46d2..000000000000
--- a/scripts/get_abi.py
+++ /dev/null
@@ -1,214 +0,0 @@
-#!/usr/bin/env python3
-# pylint: disable=R0903
-# Copyright(c) 2025: Mauro Carvalho Chehab <mchehab@kernel.org>.
-# SPDX-License-Identifier: GPL-2.0
-
-"""
-Parse ABI documentation and produce results from it.
-"""
-
-import argparse
-import logging
-import os
-import sys
-
-# Import Python modules
-
-LIB_DIR = "lib/abi"
-SRC_DIR = os.path.dirname(os.path.realpath(__file__))
-
-sys.path.insert(0, os.path.join(SRC_DIR, LIB_DIR))
-
-from abi_parser import AbiParser                # pylint: disable=C0413
-from abi_regex import AbiRegex                  # pylint: disable=C0413
-from helpers import ABI_DIR, DEBUG_HELP         # pylint: disable=C0413
-from system_symbols import SystemSymbols        # pylint: disable=C0413
-
-# Command line classes
-
-
-REST_DESC = """
-Produce output in ReST format.
-
-The output is done on two sections:
-
-- Symbols: show all parsed symbols in alphabetic order;
-- Files: cross reference the content of each file with the symbols on it.
-"""
-
-class AbiRest:
-    """Initialize an argparse subparser for rest output"""
-
-    def __init__(self, subparsers):
-        """Initialize argparse subparsers"""
-
-        parser = subparsers.add_parser("rest",
-                                       formatter_class=argparse.RawTextHelpFormatter,
-                                       description=REST_DESC)
-
-        parser.add_argument("--enable-lineno",  action="store_true",
-                            help="enable lineno")
-        parser.add_argument("--raw", action="store_true",
-                            help="output text as contained in the ABI files. "
-                                 "It not used, output will contain dynamically"
-                                 " generated cross references when possible.")
-        parser.add_argument("--no-file", action="store_true",
-                            help="Don't the files section")
-        parser.add_argument("--show-hints", help="Show-hints")
-
-        parser.set_defaults(func=self.run)
-
-    def run(self, args):
-        """Run subparser"""
-
-        parser = AbiParser(args.dir, debug=args.debug)
-        parser.parse_abi()
-        parser.check_issues()
-
-        for t in parser.doc(args.raw, not args.no_file):
-            if args.enable_lineno:
-                print (f".. LINENO {t[1]}#{t[2]}\n\n")
-
-            print(t[0])
-
-class AbiValidate:
-    """Initialize an argparse subparser for ABI validation"""
-
-    def __init__(self, subparsers):
-        """Initialize argparse subparsers"""
-
-        parser = subparsers.add_parser("validate",
-                                       formatter_class=argparse.ArgumentDefaultsHelpFormatter,
-                                       description="list events")
-
-        parser.set_defaults(func=self.run)
-
-    def run(self, args):
-        """Run subparser"""
-
-        parser = AbiParser(args.dir, debug=args.debug)
-        parser.parse_abi()
-        parser.check_issues()
-
-
-class AbiSearch:
-    """Initialize an argparse subparser for ABI search"""
-
-    def __init__(self, subparsers):
-        """Initialize argparse subparsers"""
-
-        parser = subparsers.add_parser("search",
-                                       formatter_class=argparse.ArgumentDefaultsHelpFormatter,
-                                       description="Search ABI using a regular expression")
-
-        parser.add_argument("expression",
-                            help="Case-insensitive search pattern for the ABI symbol")
-
-        parser.set_defaults(func=self.run)
-
-    def run(self, args):
-        """Run subparser"""
-
-        parser = AbiParser(args.dir, debug=args.debug)
-        parser.parse_abi()
-        parser.search_symbols(args.expression)
-
-UNDEFINED_DESC="""
-Check undefined ABIs on local machine.
-
-Read sysfs devnodes and check if the devnodes there are defined inside
-ABI documentation.
-
-The search logic tries to minimize the number of regular expressions to
-search per each symbol.
-
-By default, it runs on a single CPU, as Python support for CPU threads
-is still experimental, and multi-process runs on Python is very slow.
-
-On experimental tests, if the number of ABI symbols to search per devnode
-is contained on a limit of ~150 regular expressions, using a single CPU
-is a lot faster than using multiple processes. However, if the number of
-regular expressions to check is at the order of ~30000, using multiple
-CPUs speeds up the check.
-"""
-
-class AbiUndefined:
-    """
-    Initialize an argparse subparser for logic to check undefined ABI at
-    the current machine's sysfs
-    """
-
-    def __init__(self, subparsers):
-        """Initialize argparse subparsers"""
-
-        parser = subparsers.add_parser("undefined",
-                                       formatter_class=argparse.RawTextHelpFormatter,
-                                       description=UNDEFINED_DESC)
-
-        parser.add_argument("-S", "--sysfs-dir", default="/sys",
-                            help="directory where sysfs is mounted")
-        parser.add_argument("-s", "--search-string",
-                            help="search string regular expression to limit symbol search")
-        parser.add_argument("-H", "--show-hints", action="store_true",
-                            help="Hints about definitions for missing ABI symbols.")
-        parser.add_argument("-j", "--jobs", "--max-workers", type=int, default=1,
-                            help="If bigger than one, enables multiprocessing.")
-        parser.add_argument("-c", "--max-chunk-size", type=int, default=50,
-                            help="Maximum number of chunk size")
-        parser.add_argument("-f", "--found", action="store_true",
-                            help="Also show found items. "
-                                 "Helpful to debug the parser."),
-        parser.add_argument("-d", "--dry-run", action="store_true",
-                            help="Don't actually search for undefined. "
-                                 "Helpful to debug the parser."),
-
-        parser.set_defaults(func=self.run)
-
-    def run(self, args):
-        """Run subparser"""
-
-        abi = AbiRegex(args.dir, debug=args.debug,
-                       search_string=args.search_string)
-
-        abi_symbols = SystemSymbols(abi=abi, hints=args.show_hints,
-                                    sysfs=args.sysfs_dir)
-
-        abi_symbols.check_undefined_symbols(dry_run=args.dry_run,
-                                            found=args.found,
-                                            max_workers=args.jobs,
-                                            chunk_size=args.max_chunk_size)
-
-
-def main():
-    """Main program"""
-
-    parser = argparse.ArgumentParser(formatter_class=argparse.RawTextHelpFormatter)
-
-    parser.add_argument("-d", "--debug", type=int, default=0, help="debug level")
-    parser.add_argument("-D", "--dir", default=ABI_DIR, help=DEBUG_HELP)
-
-    subparsers = parser.add_subparsers()
-
-    AbiRest(subparsers)
-    AbiValidate(subparsers)
-    AbiSearch(subparsers)
-    AbiUndefined(subparsers)
-
-    args = parser.parse_args()
-
-    if args.debug:
-        level = logging.DEBUG
-    else:
-        level = logging.INFO
-
-    logging.basicConfig(level=level, format="[%(levelname)s] %(message)s")
-
-    if "func" in args:
-        args.func(args)
-    else:
-        sys.exit(f"Please specify a valid command for {sys.argv[0]}")
-
-
-# Call main method
-if __name__ == "__main__":
-    main()