IABSD.fr/xenocara/lib/mesa/docs/_exts/formatting.py

Branch : - branch - master - tag -

• Show log

  Commit

• Author : jsg
  Date : 2021-07-22 09:57:37
  Hash : f849497a
  Message : Import Mesa 21.1.5

• lib/mesa/docs/_exts/formatting.py

• # formatting.py
  # Sphinx extension providing formatting for Gallium-specific data
  # (c) Corbin Simpson 2010
  # Public domain to the extent permitted; contact author for special licensing
  
  import docutils.nodes
  import sphinx.addnodes
  
  def parse_envvar(env, sig, signode):
      envvar, t, default = sig.split(" ", 2)
      envvar = envvar.strip().upper()
      t = "Type: %s" % t.strip(" <>").lower()
      default = "Default: %s" % default.strip(" ()")
      signode += sphinx.addnodes.desc_name(envvar, envvar)
      signode += docutils.nodes.Text(' ')
      signode += sphinx.addnodes.desc_type(t, t)
      signode += docutils.nodes.Text(', ')
      signode += sphinx.addnodes.desc_annotation(default, default)
      return envvar
  
  def parse_opcode(env, sig, signode):
      opcode, desc = sig.split("-", 1)
      opcode = opcode.strip().upper()
      desc = " (%s)" % desc.strip()
      signode += sphinx.addnodes.desc_name(opcode, opcode)
      signode += sphinx.addnodes.desc_annotation(desc, desc)
      return opcode
  
  def setup(app):
      app.add_object_type("envvar", "envvar", "%s (environment variable)",
          parse_envvar)
      app.add_object_type("opcode", "opcode", "%s (TGSI opcode)",
          parse_opcode)