hdl.ast: clarify docs for Value.rotate_{left,right}.
authorwhitequark <whitequark@whitequark.org>
Tue, 19 May 2020 23:43:25 +0000 (23:43 +0000)
committerLuke Kenneth Casson Leighton <lkcl@lkcl.net>
Fri, 31 Dec 2021 13:31:33 +0000 (13:31 +0000)
"Rotate modulo 2**len(self)" is redundant because that's just how
rotates work.

nmigen/hdl/ast.py

index e5ade8568b283a3051f5cfa52cec8c936f0d7792..a7f77e204ba9fb8096eb15e2f11b5e24fdeb87b3 100644 (file)
@@ -424,7 +424,7 @@ class Value(metaclass=ABCMeta):
             return Cat(*matches).any()
 
     def rotate_left(self, offset):
-        """Rotate left by constant modulo 2**len(self).
+        """Rotate left by constant amount.
 
         Parameters
         ----------
@@ -434,7 +434,7 @@ class Value(metaclass=ABCMeta):
         Returns
         -------
         Value, out
-            The input rotated left by offset if offset is positive, else the input rotated right by -offset.
+            If the offset is positive, the input rotated left. Otherwise, the input rotated right.
         """
         if not isinstance(offset, int):
             raise TypeError("Rotate amount must be an integer, not {!r}".format(offset))
@@ -442,7 +442,7 @@ class Value(metaclass=ABCMeta):
         return Cat(self[-offset:], self[:-offset]) # meow :3
 
     def rotate_right(self, offset):
-        """Rotate right by constant modulo 2**len(self).
+        """Rotate right by constant amount.
 
         Parameters
         ----------
@@ -452,7 +452,7 @@ class Value(metaclass=ABCMeta):
         Returns
         -------
         Value, out
-            The input rotated right by offset if offset is positive, else the input rotated left by -offset.
+            If the offset is positive, the input rotated right. Otherwise, the input rotated right.
         """
         if not isinstance(offset, int):
             raise TypeError("Rotate amount must be an integer, not {!r}".format(offset))