diff --git a/conf.py b/conf.py index 561573dc9..b4dcb85b0 100644 --- a/conf.py +++ b/conf.py @@ -386,6 +386,16 @@ def source_read_replace(app, docname, source): result = result.replace(f"{{{key}}}", app.config.source_read_replace_vals[key]) source[0] = result +def upgrade_util_signature_rewrite(app, domain, objtype, contentnode): + # Same as add_module_names=False but **only** for odoo.upgrade.util functions or classes + signature = contentnode.parent[0] + if objtype == 'function' and signature.astext().startswith('odoo.upgrade.util.'): + # , , <(cr, *modules)> + signature.pop(0) + if objtype == 'class' and signature.astext().startswith('class odoo.upgrade.util.'): + # , , + signature.pop(1) + def setup(app): # Generate all alternate URLs for each document app.add_config_value('project_root', None, 'env') @@ -395,6 +405,7 @@ def setup(app): app.add_config_value('is_remote_build', None, 'env') # Whether the build is remotely deployed app.add_config_value('source_read_replace_vals', {}, 'env') app.connect('source-read', source_read_replace) + app.connect('object-description-transform', upgrade_util_signature_rewrite) # TODO uncomment after moving to >= v7.2.5 to also substitute placeholders in included files. # See https://github.com/sphinx-doc/sphinx/commit/ff1831 # app.connect('include-read', source_read_replace)