few more little fixes

Author: svlandeg

typer/_click/decorators.py

@@ -24,13 +24,13 @@ def option(
     *param_decls: str, cls: type["TyperOption"] | None = None, **attrs: Any
 ) -> Callable[[Command], Command]:
     """Attaches an option to the command.  All positional arguments are
-    passed as parameter declarations to :class:`Option`; all keyword
+    passed as parameter declarations to `Option`; all keyword
     arguments are forwarded unchanged (except ``cls``).
-    This is equivalent to creating an :class:`Option` instance manually
-    and attaching it to the :attr:`Command.params` list.
+    This is equivalent to creating an `Option` instance manually
+    and attaching it to the `Command.params` list.
 
-    For the default option class, refer to :class:`Option` and
-    :class:`Parameter` for descriptions of parameters.
+    For the default option class, refer to `Option` and
+    `Parameter` for descriptions of parameters.
     """
     if cls is None:
         # avoid circular imports

typer/_click/exceptions.py

@@ -19,7 +19,6 @@ def _join_param_hints(param_hint: Sequence[str] | str | None) -> str | None:
 class ClickException(Exception):
     """An exception that Click can handle and show to the user."""
 
-    #: The exit code for this exception.
     exit_code = 1
 
     def __init__(self, message: str) -> None:

typer/_click/shell_completion.py

@@ -203,11 +203,7 @@ def _start_of_option(ctx: Context, value: str) -> bool:
 
 
 def _is_incomplete_option(ctx: Context, args: list[str], param: Parameter) -> bool:
-    """Determine if the given parameter is an option that needs a value.
-
-    :param args: List of complete args before the incomplete value.
-    :param param: Option object being checked.
-    """
+    """Determine if the given parameter is an option that needs a value."""
     # avoid circular imports
     from ..core import TyperOption
 

typer/core.py

@@ -787,12 +787,12 @@ def resolve_envvar_value(self, ctx: _click.Context) -> str | None:
     def consume_value(
         self, ctx: _click.Context, opts: Mapping[str, _click.Parameter]
     ) -> tuple[Any, _click.core.ParameterSource]:
-        """For :class:`Option`, the value can be collected from an interactive prompt
-        if the option is a flag that needs a value (and the :attr:`prompt` property is
+        """For `Option`, the value can be collected from an interactive prompt
+        if the option is a flag that needs a value (and the `prompt` property is
         set).
 
         Additionally, this method handles flag option that are activated without a
-        value, in which case the :attr:`flag_value` is returned.
+        value, in which case the `flag_value` is returned.
         """
         value, source = super().consume_value(ctx, opts)