Skip to content

[rfile] Add python documentation - #23816

Draft
muntasir-396 wants to merge 1 commit into
root-project:masterfrom
muntasir-396:doc/rfile-python-docs
Draft

muntasir-396 wants to merge 1 commit into
root-project:masterfrom
muntasir-396:doc/rfile-python-docs

Conversation

@muntasir-396

@muntasir-396 muntasir-396 commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Summary

This PR addresses #22541 by providing documentation for ROOT::Experimental::RFile in Python:

  • Documented all pythonizations of RFile under \pythondoc ROOT::Experimental::RFile in _rfile.py (replacing the previous TODO placeholder).
  • Added Doxygen commands (\ingroup Py_RFile, \brief, \param, \return, \exception) across docstrings in _rfile.py.
  • Created a dedicated Doxygen group and documentation page: bindings/pyroot/pythonizations/python/ROOT/_pythonization/rfile.md (\defgroup Py_RFile RFile under \ingroup Python).
  • Linked the new RFile Python interface in bindings/pyroot/pythonizations/doc/index.md and added an RFile example to the quickstart section.

Fixes #22541

AI-assisted coding disclosure

The initial draft of the documentation and docstrings was prepared with an LLM coding assistant and thoroughly reviewed, tested, and validated by the author.

Document ROOT::Experimental::RFile pythonizations and add Doxygen
commands across docstrings. Create a dedicated Doxygen group and
documentation page for RFile in the Python interface, and link it
from the Python interface index.

Fixes root-project#22541
@dpiparo

dpiparo commented Oct 24, 2026

Copy link
Copy Markdown
Member

Is this complementary to #23633 ?

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[rfile] Add python documentation

2 participants