pybricks.pupdevices.Motor: Document close.

CHANGELOG.md

@@ -6,6 +6,7 @@
 
 ## Added
 - Enabled tilt and orientation config for `MoveHub()`.
+- Documented `Motor.close()`
 
 ## Fixed
 - Fixed missing awaitable for `Remote.light` and LWP3 writes.

doc/main/pupdevices/motor.rst

@@ -62,6 +62,8 @@ Motors with rotation sensors
 
     .. automethod:: pybricks.pupdevices.Motor.settings
 
+    .. automethod:: pybricks.pupdevices.Motor.close
+
     .. rubric:: Control settings
 
     .. pybricks-requirements:: pybricks-common-control

src/pybricks/_common.py

@@ -605,6 +605,16 @@ class Motor(DCMotor):
                 rotate to.
         """
 
+    def close(self) -> None:
+        """close()
+
+        Closes the motor object so you can call ``Motor`` again to initialize
+        a new object.
+
+        This allows advanced users to change properties such as gearing in the
+        middle of the program, which can be useful for removeable attachments.
+        """
+
 
 class Speaker:
     """Plays beeps and sounds using a speaker."""