Python API docs corrupted where last argument is device=core::Device("CPU:0")

[joseph-sch]

Originally posted by @timohl in #7136 (comment)

The last three lines in the Python API docs are corrupted in several functions e.g. for open3d.t.geometry.TriangleMesh.create_sphere:

This can be traced to cases where the last argument of the function has a default value which contains a string, and there is no explicit docstring, e.g.:

            .def_static("create_sphere", &TriangleMesh::CreateSphere,
                        "Create a sphere mesh centered at (0, 0, 0).",
                        "radius"_a = 1.0, "resolution"_a = 20,
                        "float_dtype"_a = core::Float32,
                        "int_dtype"_a = core::Int64,
                        "device"_a = core::Device("CPU:0"))

See analysis at #7136 (comment)

[timohl]

Thanks for opening this issue.

It might also get messed up by the parsing in docstring::ClassMethodDocInject().
This has been the source of previous bugs.
I will check it this weekend.

Another (not directly related) thought of mine would be to change the __repr__ method of Device to output open3d.core.Device("CPU:0") instead of CPU:0 directly.
Currently, vscode displays the default value with stubs from pybind-stubgen as ..., since CPU:0 is not valid in Python.
The same goes for open3d.core.Dtype.

[timohl]

I could not really find a fix on the Sphinx side, but I opened #7148 changing CPU:0 to Device("CPU", 0) in order to avoid the : character.