Repository: matplotlib/matplotlib
File: lib/mpl_toolkits/mplot3d/axes3d.py (Python)

Code before:
    @_api.delete_parameter("3.11", "share")
    @_api.delete_parameter("3.11", "anchor")
    def set_aspect(self, aspect, adjustable=None, anchor=None, share=False):
        """
        Set the aspect ratios.

        Parameters
        ----------
        aspect : {'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
            Possible values:

            =========   ==================================================
            value       description
            =========   ==================================================
            'auto'      automatic; fill the position rectangle with data.
            'equal'     adapt all the axes to have equal aspect ratios.
            'equalxy'   adapt the x and y axes to have equal aspect ratios.
            'equalxz'   adapt the x and z axes to have equal aspect ratios.
            'equalyz'   adapt the y and z axes to have equal aspect ratios.
            =========   ==================================================

        adjustable : {'box', 'datalim'}, default: 'box'
           Defines Which parameter to adjust to meet the aspect ratio.

        - 'box': Change the physical dimensions of the axes bounding box.
        - 'datalim': Change the x, y, or z data limits.

        anchor : None or str or 2-tuple of float, optional
            .. deprecated:: 3.11
                This parameter has no effect.

        share : bool, default: False
            .. deprecated:: 3.11
                This parameter has no effect.

        See Also
        --------
        mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect
        """
        if adjustable is None:
            adjustable = 'box'
        _api.check_in_list(['box', 'datalim'], adjustable=adjustable)
        _api.check_in_list(('auto', 'equal', 'equalxy', 'equalyz', 'equalxz'),
                           aspect=aspect)

        self.set_adjustable(adjustable)
        self._aspect = aspect

        if aspect in ('equal', 'equalxy', 'equalxz', 'equalyz'):
            ax_indices = self._equal_aspect_axis_indices(aspect)


Review comment (suggestion):
```suggestion
            Defines which parameter to adjust to meet the aspect ratio.

            - 'box': Change the physical dimensions of the axes bounding box.
            - 'datalim': Change the x, y, or z data limits.
```
What I meant is not indented with respect to the adjacent text block. The whole description is of course indented with respect to the parameter name. (and we use 4 spaces for indent there, which is fixed in this suggestion.)

Code after:
    @_api.delete_parameter("3.11", "share")
    @_api.delete_parameter("3.11", "anchor")
    def set_aspect(self, aspect, adjustable=None, anchor=None, share=False):
        """
        Set the aspect ratios.

        Parameters
        ----------
        aspect : {'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
            Possible values:

            =========   ==================================================
            value       description
            =========   ==================================================
            'auto'      automatic; fill the position rectangle with data.
            'equal'     adapt all the axes to have equal aspect ratios.
            'equalxy'   adapt the x and y axes to have equal aspect ratios.
            'equalxz'   adapt the x and z axes to have equal aspect ratios.
            'equalyz'   adapt the y and z axes to have equal aspect ratios.
            =========   ==================================================

        adjustable : {'box', 'datalim'}, default: 'box'
            Defines which parameter to adjust to meet the aspect ratio.

            - 'box': Change the physical dimensions of the axes bounding box.
            - 'datalim': Change the x, y, or z data limits.

        anchor : None or str or 2-tuple of float, optional
            .. deprecated:: 3.11
                This parameter has no effect.

        share : bool, default: False
            .. deprecated:: 3.11
                This parameter has no effect.

        See Also
        --------
        mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect
        """
        if adjustable is None:
            adjustable = 'box'
        _api.check_in_list(['box', 'datalim'], adjustable=adjustable)
        _api.check_in_list(('auto', 'equal', 'equalxy', 'equalyz', 'equalxz'),
                           aspect=aspect)

        self.set_adjustable(adjustable)
        self._aspect = aspect

        if aspect in ('equal', 'equalxy', 'equalxz', 'equalyz'):
            ax_indices = self._equal_aspect_axis_indices(aspect)