Add send_opponent_information() documentation

Author: MarkZH

chess/engine.py

@@ -449,10 +449,18 @@ class Info(enum.IntFlag):
 @dataclasses.dataclass
 class Opponent:
     """Used to store information about an engine's opponent."""
+
     name: Optional[str]
+    """The name of the opponent."""
+
     title: Optional[str]
+    """The opponent's title--for example, GM, IM, or BOT."""
+
     rating: Optional[int]
+    """The opponent's ELO rating."""
+
     is_engine: Optional[bool]
+    """Whether the opponent is a chess engine/computer program."""
 
 
 class PovScore:
@@ -1158,7 +1166,7 @@ async def send_opponent_information(self, *, opponent: Optional[Opponent] = None
         method should be called before the first move of a game--i.e., the
         first call to :func:`chess.engine.Protocol.play()`.
 
-        :param opponent: Optional. The opponent's information.
+        :param opponent: Optional. An instance of :class:`chess.engine.Opponent` that has the opponent's information.
         :param engine_rating: Optional. This engine's own rating. Only used by XBoard engines.
         """
 

docs/engine.rst

@@ -70,6 +70,12 @@ Example: Let Stockfish play against itself, 100 milliseconds per move.
 .. autoclass:: chess.engine.PlayResult
     :members:
 
+.. autoclass:: chess.engine.Protocol
+    :members: send_opponent_information
+
+.. autoclass:: chess.engine.Opponent
+    :members:
+
 Analysing and evaluating a position
 -----------------------------------