131 def setup(app):  argument
133     app.connect('builder-inited', setupTools)
136     app.add_directive("kernel-image",  KernelImage)
137     app.add_node(kernel_image,
145     app.add_directive("kernel-figure", KernelFigure)
146     app.add_node(kernel_figure,
154     app.add_directive('kernel-render', KernelRender)
155     app.add_node(kernel_render,
162     app.connect('doctree-read', add_kernel_figure_to_std_domain)
171 def setupTools(app):  argument
179     kernellog.verbose(app, "kfigure: check installed tools ...")
187         kernellog.verbose(app, "use dot(1) from: " + dot_cmd)
199         kernellog.warn(app, "dot(1) not found, for better output quality install "
202         kernellog.verbose(app, "use inkscape(1) from: " + inkscape_cmd)
213             kernellog.verbose(app, "use convert(1) from: " + convert_cmd)
215             kernellog.verbose(app,
222             kernellog.verbose(app, "use rsvg-convert(1) from: " + rsvg_convert_cmd)
223             kernellog.verbose(app, "use 'dot -Tsvg' and rsvg-convert(1) for DOT -> PDF conversion")
226             kernellog.verbose(app,
230                 kernellog.verbose(app, "use 'dot -Tpdf' for DOT -> PDF conversion")
232                 kernellog.verbose(app, "use 'dot -Tsvg' and convert(1) for DOT -> PDF conversion")
254     app = translator.builder.app
266     kernellog.verbose(app, 'assert best format for: ' + img_node['uri'])
271             kernellog.verbose(app,
299                 kernellog.warn(app,
315             kernellog.verbose(app,
323                 kernellog.verbose(app, 'convert DOT to: {out}/' + _name)
326                     ok1 = dot2format(app, src_fname, svg_fname)
327                     ok2 = svg2pdf_by_rsvg(app, svg_fname, dst_fname)
331                     ok = dot2format(app, src_fname, dst_fname)
334                 kernellog.verbose(app, 'convert SVG to: {out}/' + _name)
335                 ok = svg2pdf(app, src_fname, dst_fname)
341 def dot2format(app, dot_fname, out_fname):  argument
363             kernellog.warn(app,
367 def svg2pdf(app, svg_fname, pdf_fname):  argument
397         kernellog.warn(app, "Error #%d when calling: %s" % (exit_code, " ".join(cmd)))
399             kernellog.warn(app, "Warning msg from %s: %s"
402         kernellog.verbose(app, "Warning msg from %s (likely harmless):\n%s"
407 def svg2pdf_by_rsvg(app, svg_fname, pdf_fname):  argument
421         ok = svg2pdf(app, svg_fname, pdf_fname)
427             kernellog.warn(app, "Error #%d when calling: %s" % (exit_code, " ".join(cmd)))
519     app = self.builder.app
522     kernellog.verbose(app, 'visit kernel-render node lang: "%s"' % (srclang))
526         kernellog.warn(app, 'kernel-render: "%s" unknown / include raw.' % (srclang))
530         kernellog.verbose(app, "dot from graphviz not available / include raw.")
626 def add_kernel_figure_to_std_domain(app, doctree):  argument
637     std = app.env.domains["std"]
638     docname = app.env.docname