Documentation not clear in `xyzSile.read_geometry` about sisl

[zerothi]

I think sphinx uses the func.__doc__ after import, to catch changes done automatically. Since the wrapped function uses functools.wrap it will retain the doc string.

[zerothi]

Agreed, for now I have added a simple thing. It would be great if the decorator added this automatically. :)

[pfebrer]

The function that appears on the docs is the original one or the one returned by the decorator?

[zerothi]

The function that appears on the docs is the original one or the one returned by the decorator?

The decorator does not change the docs currently, so it is the wrapped functions doc-string.

[pfebrer]

Yes, but I mean what sphinx catches is the wrapped function, not the raw text of the function definition?