86 import os.path
99 srctree = os.path.abspath(os.environ["srctree"])
100 sys.path.insert(0, os.path.join(srctree, "tools/lib/python"))
155     def read_rawtext(self, path, encoding):  argument
158                 self.state.document.settings.record_dependencies.add(path)
159                 include_file = io.FileInput(source_path=path,
165                                 '(wrong locale?).' % path)
210     def xref_text(self, env, path, tab_width):  argument
221             source_dir = os.path.dirname(os.path.abspath(
224             exceptions_file = os.path.join(source_dir, self.options['exception-file'])
228         parser.parse_file(path, exceptions_file)
232             env._xref_files.add(path)
245             self.state_machine.insert_input(include_lines, path)
254         relpath = os.path.relpath(path, srctree)
260                 result.append(line, path)
276             result.append(f"- {ref}: {relpath}#{realln}", path, ln)
278         self.state_machine.insert_input(result, path)
282     def literal(self, path, tab_width, rawtext):  argument
290         literal_block = nodes.literal_block(rawtext, source=path,
313     def code(self, path, tab_width):  argument
319         self.options["source"] = path
341         srctree = os.path.abspath(os.environ["srctree"])
343         path = os.path.expandvars(self.arguments[0])
344         src_path = os.path.join(srctree, path)
346         if os.path.isfile(src_path):
348             path = src_path
350             raise self.warning(f'File "%s" doesn\'t exist', path)
352         abs_base = os.path.abspath(base)
353         abs_full_path = os.path.abspath(os.path.join(base, path))
356             if os.path.commonpath([abs_full_path, abs_base]) != abs_base:
358                                   (self.name, path))
362                             (self.name, path))
364         self.arguments[0] = path
371         env.note_dependency(os.path.abspath(path))
377         source_dir = os.path.dirname(os.path.abspath(source))
378         path = directives.path(self.arguments[0])
379         if path.startswith("<") and path.endswith(">"):
380             path = os.path.join(self.standard_include_path, path[1:-1])
381         path = os.path.normpath(os.path.join(source_dir, path))
393             return self.xref_text(env, path, tab_width)
395         rawtext = self.read_rawtext(path, encoding)
399             return self.code(path, tab_width, rawtext)
401         return self.literal(path, tab_width, rawtext)