sync code with last improvements from OpenBSD
This commit is contained in:
commit
88965415ff
GPG key ID:
F42C07F07E2E35B7
26235 changed files with 29195616 additions and 0 deletions
33
lib/mesa/docs/_exts/formatting.py
Normal file
33
lib/mesa/docs/_exts/formatting.py
Normal file
|
|
@ -0,0 +1,33 @@
|
|||
# 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)
|
||||
151
lib/mesa/docs/_exts/nir.py
Normal file
151
lib/mesa/docs/_exts/nir.py
Normal file
|
|
@ -0,0 +1,151 @@
|
|||
# Copyright © 2021 Intel Corporation
|
||||
#
|
||||
# Permission is hereby granted, free of charge, to any person obtaining a
|
||||
# copy of this software and associated documentation files (the
|
||||
# "Software"), to deal in the Software without restriction, including
|
||||
# without limitation the rights to use, copy, modify, merge, publish,
|
||||
# distribute, sub license, and/or sell copies of the Software, and to
|
||||
# permit persons to whom the Software is furnished to do so, subject to
|
||||
# the following conditions:
|
||||
#
|
||||
# The above copyright notice and this permission notice (including the
|
||||
# next paragraph) shall be included in all copies or substantial portions
|
||||
# of the Software.
|
||||
#
|
||||
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
||||
# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
|
||||
# IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
|
||||
# ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
||||
# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
||||
# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
|
||||
import docutils.nodes
|
||||
import mako.template
|
||||
import os
|
||||
import sphinx
|
||||
from sphinx.directives import SphinxDirective
|
||||
from sphinx.domains import Domain
|
||||
from sphinx.util.nodes import make_refnode
|
||||
import sys
|
||||
import textwrap
|
||||
|
||||
THIS_DIR = os.path.dirname(os.path.abspath(__file__))
|
||||
MESA_DIR = os.path.join(THIS_DIR, '..', '..')
|
||||
NIR_PATH = os.path.join(MESA_DIR, 'src', 'compiler', 'nir')
|
||||
sys.path.append(NIR_PATH)
|
||||
|
||||
import nir_opcodes
|
||||
|
||||
OP_DESC_TEMPLATE = mako.template.Template("""
|
||||
<%
|
||||
def src_decl_list(num_srcs):
|
||||
return ', '.join('nir_ssa_def *src' + str(i) for i in range(num_srcs))
|
||||
|
||||
def to_yn(b):
|
||||
return 'Y' if b else 'N'
|
||||
%>
|
||||
|
||||
**Properties:**
|
||||
|
||||
.. list-table::
|
||||
:header-rows: 1
|
||||
|
||||
* - Per-component
|
||||
- Associative
|
||||
- 2-src commutative
|
||||
* - ${to_yn(op.output_size == 0)}
|
||||
- ${to_yn('associative' in op.algebraic_properties)}
|
||||
- ${to_yn('2src_commutative' in op.algebraic_properties)}
|
||||
|
||||
**Constant-folding:**
|
||||
|
||||
.. code-block:: c
|
||||
|
||||
${textwrap.indent(op.const_expr, ' ')}
|
||||
|
||||
**Builder function:**
|
||||
|
||||
.. c:function:: nir_ssa_def *nir_${op.name}(nir_builder *, ${src_decl_list(op.num_inputs)})
|
||||
""")
|
||||
|
||||
def parse_rst(state, parent, rst):
|
||||
vl = docutils.statemachine.ViewList(rst.splitlines())
|
||||
state.nested_parse(vl, 0, parent)
|
||||
|
||||
def nir_alu_type_name(t, s):
|
||||
if s:
|
||||
return '{}[{}]'.format(t, s)
|
||||
else:
|
||||
return '{}[N]'.format(t)
|
||||
|
||||
def build_alu_op_desc(state, env, op):
|
||||
desc = sphinx.addnodes.desc(domain='nir', objtype='aluop')
|
||||
|
||||
# Add the signature
|
||||
sig = sphinx.addnodes.desc_signature()
|
||||
desc.append(sig)
|
||||
sig += sphinx.addnodes.desc_name(op.name, op.name)
|
||||
|
||||
params = sphinx.addnodes.desc_parameterlist()
|
||||
for i, t, s in zip(range(100), op.input_types, op.input_sizes):
|
||||
params += docutils.nodes.Text(nir_alu_type_name(t, s) + ' ')
|
||||
params += sphinx.addnodes.desc_parameter('', 'src' + str(i))
|
||||
sig += params
|
||||
|
||||
sig += sphinx.addnodes.desc_returns('',
|
||||
nir_alu_type_name(op.output_type, op.output_size))
|
||||
|
||||
nir_domain = env.get_domain('nir')
|
||||
sig['ids'].append(nir_domain.add_alu_op_ref(op))
|
||||
|
||||
# Build the description
|
||||
content = sphinx.addnodes.desc_content()
|
||||
desc.append(content)
|
||||
parse_rst(state, content, OP_DESC_TEMPLATE.render(op=op, textwrap=textwrap))
|
||||
|
||||
return desc
|
||||
|
||||
class NIRALUOpcodesDirective(SphinxDirective):
|
||||
def run(self):
|
||||
return [build_alu_op_desc(self.state, self.env, op)
|
||||
for op in nir_opcodes.opcodes.values()]
|
||||
|
||||
class NIRDomain(Domain):
|
||||
"""A new NIR directive
|
||||
|
||||
To list all NIR ALU opcodes with their descriptions:
|
||||
```rst
|
||||
.. nir:alu-opcodes::
|
||||
```
|
||||
|
||||
To reference a NIR opcode, ``:nir:alu-op:`fadd```
|
||||
"""
|
||||
name = 'nir'
|
||||
roles = {
|
||||
'alu-op' : sphinx.roles.XRefRole(),
|
||||
}
|
||||
directives = {
|
||||
'alu-opcodes' : NIRALUOpcodesDirective,
|
||||
}
|
||||
initial_data = {
|
||||
'alu-op-refs': [],
|
||||
}
|
||||
|
||||
def add_alu_op_ref(self, op):
|
||||
"""Add reference to an ALU op."""
|
||||
self.data['alu-op-refs'].append((op.name, self.env.docname))
|
||||
return 'nir-alu-op-' + op.name
|
||||
|
||||
def resolve_xref(self, env, fromdocname, builder, typ, target, node,
|
||||
contnode):
|
||||
for opname, todocname in self.data['alu-op-refs']:
|
||||
if target == opname:
|
||||
targ = 'nir-alu-op-' + opname
|
||||
return make_refnode(builder, fromdocname, todocname, targ,
|
||||
contnode, targ)
|
||||
|
||||
return None
|
||||
|
||||
def setup(app):
|
||||
app.add_domain(NIRDomain)
|
||||
47
lib/mesa/docs/_exts/redirects.py
Normal file
47
lib/mesa/docs/_exts/redirects.py
Normal file
|
|
@ -0,0 +1,47 @@
|
|||
# Copyright © 2020-2021 Collabora Ltd
|
||||
#
|
||||
# Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
# of this software and associated documentation files (the "Software"), to deal
|
||||
# in the Software without restriction, including without limitation the rights
|
||||
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
# copies of the Software, and to permit persons to whom the Software is
|
||||
# furnished to do so, subject to the following conditions:
|
||||
#
|
||||
# The above copyright notice and this permission notice shall be included in
|
||||
# all copies or substantial portions of the Software.
|
||||
#
|
||||
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
# SOFTWARE.
|
||||
|
||||
import os
|
||||
import pathlib
|
||||
from urllib.parse import urlparse
|
||||
|
||||
def create_redirect(dst):
|
||||
tpl = '<html><head><meta http-equiv="refresh" content="0; url={0}"><script>window.location.replace("{0}")</script></head></html>'
|
||||
return tpl.format(dst)
|
||||
|
||||
def create_redirects(app, exception):
|
||||
if exception is not None or not app.builder.name == 'html':
|
||||
return
|
||||
for src, dst in app.config.html_redirects:
|
||||
path = os.path.join(app.outdir, '{0}.html'.format(src))
|
||||
|
||||
os.makedirs(os.path.dirname(path), exist_ok=True)
|
||||
|
||||
if urlparse(dst).scheme == "":
|
||||
dst = pathlib.posixpath.relpath(dst, start=os.path.dirname(src))
|
||||
if not os.path.isfile(os.path.join(os.path.dirname(path), dst)):
|
||||
raise Exception('{0} does not exitst'.format(dst))
|
||||
|
||||
with open(path, 'w') as f:
|
||||
f.write(create_redirect(dst))
|
||||
|
||||
def setup(app):
|
||||
app.add_config_value('html_redirects', [], '')
|
||||
app.connect('build-finished', create_redirects)
|
||||
Loading…
Add table
Add a link
Reference in a new issue