Skip to content

Commit 082f17d

Browse files
robtaylorclaude
andcommitted
Fix docstring formatting for Sphinx compatibility
Make all attribute descriptions in IOModelOptions use consistent multi-line formatting to avoid RST definition list parsing issues when building docs with sphinx-autoapi. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 6746230 commit 082f17d

1 file changed

Lines changed: 12 additions & 6 deletions

File tree

chipflow/platform/io/iosignature.py

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -66,12 +66,18 @@ class IOModelOptions(TypedDict):
6666
clock_domain: The name of the I/O's clock domain (see
6767
``amaranth.hdl.ClockDomain``). NB there is only one of these, so IO
6868
with multiple clocks must be split up.
69-
buffer_in: Should the IO pad have an input buffer?
70-
buffer_out: Should the IO pad have an output buffer?
71-
sky130_drive_mode: Drive mode for output buffer on sky130.
72-
trip_point: Trip Point configuration for input buffer.
73-
init: The value for the initial values of the port.
74-
init_oe: The value for the initial values of the output enable(s) of the port.
69+
buffer_in: Should the IO pad have an input buffer? Defaults to True for
70+
ports with input direction.
71+
buffer_out: Should the IO pad have an output buffer? Defaults to True for
72+
ports with output direction.
73+
sky130_drive_mode: Drive mode for output buffer on sky130. See
74+
:class:`Sky130DriveMode` for available options.
75+
trip_point: Trip Point configuration for input buffer. See
76+
:class:`IOTripPoint` for available options.
77+
init: The value for the initial values of the port. Can be an integer or
78+
boolean.
79+
init_oe: The value for the initial values of the output enable(s) of the
80+
port. Can be an integer or boolean.
7581
"""
7682

7783
invert: NotRequired[bool|Tuple[bool, ...]]

0 commit comments

Comments
 (0)