125 def setup(app):  argument
127     app.connect('builder-inited', setupTools)
130     app.add_directive("kernel-image",  KernelImage)
131     app.add_node(kernel_image,
139     app.add_directive("kernel-figure", KernelFigure)
140     app.add_node(kernel_figure,
148     app.add_directive('kernel-render', KernelRender)
149     app.add_node(kernel_render,
156     app.connect('doctree-read', add_kernel_figure_to_std_domain)
165 def setupTools(app):  argument
173     kernellog.verbose(app, "kfigure: check installed tools ...")
181         kernellog.verbose(app, "use dot(1) from: " + dot_cmd)
193         kernellog.warn(app, "dot(1) not found, for better output quality install "
196         kernellog.verbose(app, "use inkscape(1) from: " + inkscape_cmd)
207             kernellog.verbose(app, "use convert(1) from: " + convert_cmd)
209             kernellog.verbose(app,
216             kernellog.verbose(app, "use rsvg-convert(1) from: " + rsvg_convert_cmd)
217             kernellog.verbose(app, "use 'dot -Tsvg' and rsvg-convert(1) for DOT -> PDF conversion")
220             kernellog.verbose(app,
224                 kernellog.verbose(app, "use 'dot -Tpdf' for DOT -> PDF conversion")
226                 kernellog.verbose(app, "use 'dot -Tsvg' and convert(1) for DOT -> PDF conversion")
248     app = translator.builder.app
260     kernellog.verbose(app, 'assert best format for: ' + img_node['uri'])
265             kernellog.verbose(app,
293                 kernellog.warn(app,
309             kernellog.verbose(app,
317                 kernellog.verbose(app, 'convert DOT to: {out}/' + _name)
320                     ok1 = dot2format(app, src_fname, svg_fname)
321                     ok2 = svg2pdf_by_rsvg(app, svg_fname, dst_fname)
325                     ok = dot2format(app, src_fname, dst_fname)
328                 kernellog.verbose(app, 'convert SVG to: {out}/' + _name)
329                 ok = svg2pdf(app, src_fname, dst_fname)
335 def dot2format(app, dot_fname, out_fname):  argument
357             kernellog.warn(app,
361 def svg2pdf(app, svg_fname, pdf_fname):  argument
391         kernellog.warn(app, "Error #%d when calling: %s" % (exit_code, " ".join(cmd)))
393             kernellog.warn(app, "Warning msg from %s: %s"
396         kernellog.verbose(app, "Warning msg from %s (likely harmless):\n%s"
401 def svg2pdf_by_rsvg(app, svg_fname, pdf_fname):  argument
415         ok = svg2pdf(app, svg_fname, pdf_fname)
421             kernellog.warn(app, "Error #%d when calling: %s" % (exit_code, " ".join(cmd)))
513     app = self.builder.app
516     kernellog.verbose(app, 'visit kernel-render node lang: "%s"' % (srclang))
520         kernellog.warn(app, 'kernel-render: "%s" unknown / include raw.' % (srclang))
524         kernellog.verbose(app, "dot from graphviz not available / include raw.")
620 def add_kernel_figure_to_std_domain(app, doctree):  argument
631     std = app.env.domains["std"]
632     docname = app.env.docname