Updated PinSignature docs with added links to Amaranth Signature class

Author: lanserge

chipflow_lib/platforms/utils.py

@@ -66,7 +66,7 @@ def as_json(self):  # type: ignore
 
 
 class PinSignature(wiring.Signature):
-    """Amaranth Signature used to decorate wires that would usually be brought out onto a port on the package.
+    """An :py:obj:`Amaranth Signature <amaranth.lib.wiring.Signature>` used to decorate wires that would usually be brought out onto a port on the package.
     This class is generally not directly used.
     Instead, you would typically utilize the more specific
     :py:obj:`InputPinSignature`, :py:obj:`OutputPinSignature`, or :py:obj:`BidirPinSignature` for defining pin interfaces.
@@ -133,9 +133,7 @@ def __repr__(self):
 
 
 def OutputPinSignature(width, **kwargs):
-    """This creates Amaranth Signature used to decorate package output wires
-    that would be connected to the pads on the package.
-    This creates an Amaranth Signature which is then used to decorate output signals
+    """This creates an :py:obj:`Amaranth Signature <amaranth.lib.wiring.Signature>` which is then used to decorate package output signals
     intended for connection to the physical pads of the integrated circuit package.
 
     :param width: specifies the number of individual output wires within this port, each of which will correspond to a separate physical pad on the integrated circuit package.
@@ -146,9 +144,7 @@ def OutputPinSignature(width, **kwargs):
 
 
 def InputPinSignature(width, **kwargs):
-    """This creates Amaranth Signature used to decorate package input wires
-    that would be connected to the pads on the package.
-    This creates an Amaranth Signature which is then used to decorate input signals
+    """This creates an :py:obj:`Amaranth Signature <amaranth.lib.wiring.Signature>` which is then used to decorate package input signals
     intended for connection to the physical pads of the integrated circuit package.
 
     :param width: specifies the number of individual input wires within this port, each of which will correspond to a separate physical pad on the integrated circuit package.
@@ -159,9 +155,7 @@ def InputPinSignature(width, **kwargs):
 
 
 def BidirPinSignature(width, **kwargs):
-    """This creates Amaranth Signature used to decorate package bidirectional wires
-    that would be connected to the pads on the package.
-    This creates an Amaranth Signature which is then used to decorate bi-directional signals
+    """This creates an :py:obj:`Amaranth Signature <amaranth.lib.wiring.Signature>` which is then used to decorate package bi-directional signals
     intended for connection to the physical pads of the integrated circuit package.
 
     :param width: specifies the number of individual input/output wires within this port. Each pair of input/output wires will correspond to a separate physical pad on the integrated circuit package.