docs: kernel_abi.py: Handle with a lazy Sphinx parser

import subprocess

import sys

import re

import kernellog

from os import path

        "debug"     : directives.flag

    }

    def warn(self, message, **replace):

        replace["fname"]   = self.state.document.current_source

        replace["line_no"] = replace.get("line_no", self.lineno)

        message = ("%(fname)s:%(line_no)s: [kernel-abi WARN] : " + message) % replace

        self.state.document.settings.env.app.warn(message, prefix="")

    def run(self):

        doc = self.state.document

        shell_env["srctree"] = srctree

        lines = self.runCmd(cmd, shell=True, cwd=cwd, env=shell_env)

        nodeList = self.nestedParse(lines, fname)

        nodeList = self.nestedParse(lines, self.arguments[0])

        return nodeList

    def runCmd(self, cmd, **kwargs):

                              % (self.name, ErrorString(exc)))

        return out

    def nestedParse(self, lines, f):

    def nestedParse(self, lines, fname):

        content = ViewList()

        node = nodes.section()

        line_regex = re.compile("^#define LINENO (\S+)\#([0-9]+)$")

        ln = 0

        n = 0

        f = fname

        for line in lines.split("\n"):

            n = n + 1

            match = line_regex.search(line)

            if match:

                f = match.group(1)

                new_f = match.group(1)

                # Sphinx parser is lazy: it stops parsing contents in the

                # middle, if it is too big. So, handle it per input file

                if new_f != f and content:

                    self.do_parse(content, node)

                    content = ViewList()

                f = new_f

                # sphinx counts lines from 0

                ln = int(match.group(2)) - 1

            else:

                content.append(line, f, ln)

        buf  = self.state.memo.title_styles, self.state.memo.section_level, self.state.memo.reporter

        kernellog.info(self.state.document.settings.env.app, "%s: parsed %i lines" % (fname, n))

        if content:

            self.do_parse(content, node)

        return node.children

    def do_parse(self, content, node):

        if Use_SSI:

            with switch_source_input(self.state, content):

                self.state.nested_parse(content, 0, node, match_titles=1)

        else:

            buf  = self.state.memo.title_styles, self.state.memo.section_level, self.state.memo.reporter

            self.state.memo.title_styles  = []

            self.state.memo.section_level = 0

            self.state.memo.reporter      = AutodocReporter(content, self.state.memo.reporter)

                self.state.nested_parse(content, 0, node, match_titles=1)

            finally:

                self.state.memo.title_styles, self.state.memo.section_level, self.state.memo.reporter = buf

        return node.children