Docstrings on ``Table.read`` and ``Table.write``

Description

= 😢

Additional context

Haven’t tested this, but I think they just need a __doc__ attribute.

[nstarman]

@pllim @taldcroft.

I’ve tried a number of things for fixes:

• setting the __doc__ attribute in UnifiedReadWriteMethod.__init__
• setting the __doc__ attribute on the owner class variable using UnifiedReadWriteMethod.__set_name__

  def __set_name__(self, owner, name):
      # transfer docstring from wrapped function to attribute
      setattr(getattr(owner, name), "__doc__", self.func.__doc__)
  

• Directly setting read.__doc__ and write.__doc__ on the table class.

I wonder if this is actually an automodapi issue. Maybe transfer ?

[taldcroft]

Not clear what’s happening in the sphinx docs. Table.read? in IPython gives proper help, and the fix that @pllim may be thinking of is doing Table.read.help(..) for full help on parameters for any format.