lets-plot 4.7.0rc2__cp311-cp311-macosx_11_0_arm64.whl → 4.7.1rc1__cp311-cp311-macosx_11_0_arm64.whl

lets_plot/plot/geom_extras.py

@@ -27,7 +27,7 @@ def arrow(angle=None, length=None, ends=None, type=None):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Arrow object specification.
 
     Examples

lets_plot/plot/geom_function_.py

@@ -86,11 +86,11 @@ def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=Non
 
     Parameters
     ----------
-    mapping : `FeatureSpec`
-        Set of aesthetic mappings created by `aes()` function.
+    mapping : ``FeatureSpec``
+        Set of aesthetic mappings created by `aes() <https://lets-plot.org/python/pages/api/lets_plot.aes.html>`__ function.
         Aesthetic mappings describe the way that variables in the data are
         mapped to plot "aesthetics".
-    data : dict or Pandas or Polars `DataFrame`
+    data : dict or Pandas or Polars ``DataFrame``
         The data to be used in this layer. Specify to describe the definition area of a function.
         If None, the default, the data will not be used at all.
     stat : str, default='identity'
@@ -100,19 +100,22 @@ def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=Non
         'density2d' (computes and draws 2D kernel density estimate).
     geom : str, default='line'
         The geometry to display the function, as a string.
-    position : str or `FeatureSpec`, default='identity'
+    position : str or ``FeatureSpec``, default='identity'
         Position adjustment.
         Either a position adjustment name: 'dodge', 'jitter', 'nudge', 'jitterdodge', 'fill',
-        'stack' or 'identity', or the result of calling a position adjustment function (e.g., `position_dodge()` etc.).
+        'stack' or 'identity', or the result of calling a position adjustment function
+        (e.g., `position_dodge() <https://lets-plot.org/python/pages/api/lets_plot.position_dodge.html>`__ etc.).
     show_legend : bool, default=True
         False - do not show legend for this layer.
     inherit_aes : bool, default=True
         False - do not combine the layer aesthetic mappings with the plot shared mappings.
-    manual_key : str or `layer_key`
+    manual_key : str or ``layer_key``
         The key to show in the manual legend.
-        Specify text for the legend label or advanced settings using the `layer_key()` function.
-    tooltips : `layer_tooltips`
-        Result of the call to the `layer_tooltips()` function.
+        Specify text for the legend label or advanced settings using the
+        `layer_key() <https://lets-plot.org/python/pages/api/lets_plot.layer_key.html>`__ function.
+    tooltips : ``layer_tooltips``
+        Result of the call to the
+        `layer_tooltips() <https://lets-plot.org/python/pages/api/lets_plot.layer_tooltips.html>`__ function.
         Specify appearance, style and content.
         Set tooltips='none' to hide tooltips from the layer.
     fun : function
@@ -131,12 +134,12 @@ def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=Non
 
     Returns
     -------
-    `LayerSpec`
+    ``LayerSpec``
         Geom object specification.
 
     Notes
     -----
-    `geom_function()` understands the following aesthetics mappings:
+    ``geom_function()`` understands the following aesthetics mappings:
 
     - x : x-axis value.
     - alpha : transparency level of a layer. Accept values between 0 and 1.
@@ -146,8 +149,8 @@ def geom_function(mapping=None, *, data=None, stat=None, geom=None, position=Non
 
     ----
 
-    To hide axis tooltips, set 'blank' or the result of `element_blank()`
-    to the `axis_tooltip`, `axis_tooltip_x` or `axis_tooltip_y` parameter of the `theme()`.
+    To hide axis tooltips, set 'blank' or the result of `element_blank() <https://lets-plot.org/python/pages/api/lets_plot.element_blank.html>`__
+    to the ``axis_tooltip``, ``axis_tooltip_x`` or ``axis_tooltip_y`` parameter of the `theme() <https://lets-plot.org/python/pages/api/lets_plot.theme.html>`__.
 
     Examples
     --------

lets_plot/plot/geom_imshow_.py

@@ -107,7 +107,8 @@ def geom_imshow(image_data, cmap=None, *,
     - (M, N, 3) - color RGB image
     - (M, N, 4) - color RGB image with alpha channel
 
-    This geom is not as flexible as `geom_raster()` or `geom_tile()`
+    This geom is not as flexible as `geom_raster() <https://lets-plot.org/python/pages/api/lets_plot.geom_raster.html>`__
+    or `geom_tile() <https://lets-plot.org/python/pages/api/lets_plot.geom_tile.html>`__
     but vastly superior in the terms of rendering efficiency.   
 
     Parameters
@@ -116,7 +117,7 @@ def geom_imshow(image_data, cmap=None, *,
         Specify image type, size and pixel values.
         Supported array shapes are:
 
-        - (M, N): an image with scalar data. The values are mapped to colors (greys by default) using normalization. See parameters `norm`, `cmap`, `vmin`, `vmax`.
+        - (M, N): an image with scalar data. The values are mapped to colors (greys by default) using normalization. See parameters ``norm``, ``cmap``, ``vmin``, ``vmax``.
         - (M, N, 3): an image with RGB values (0-1 float or 0-255 int).
         - (M, N, 4): an image with RGBA values (0-1 float or 0-255 int).
 
@@ -134,18 +135,18 @@ def geom_imshow(image_data, cmap=None, *,
         The alpha blending value, between 0 (transparent) and 1 (opaque).    
     vmin, vmax : number, optional
         Define the data range used for luminance normalization in grey-scale images.
-        This parameter is ignored for RGB(A) images or if parameter `norm=False`.
+        This parameter is ignored for RGB(A) images or if parameter ``norm=False``.
     extent : list of 4 numbers: [left, right, bottom, top], optional
         Define image's bounding box in terms of the "data coordinates".
 
-        - `left, right`: coordinates of pixels' outer edge along the x-axis for pixels in the 1-st and the last column.
-        - `bottom, top`: coordinates of pixels' outer edge along the y-axis for pixels in the 1-st and the last row.
+        - ``left``, ``right``: coordinates of pixels' outer edge along the x-axis for pixels in the 1-st and the last column.
+        - ``bottom``, ``top``: coordinates of pixels' outer edge along the y-axis for pixels in the 1-st and the last row.
 
         The default is: [-0.5, ncol-0.5, -0.5, nrow-0.5]
     compression : int, optional
         The compression level to be used by the ``zlib`` module.
         Values from 0 (no compression) to 9 (highest).
-        Value `None` means that the `zlib` module uses
+        Value None means that the ``zlib`` module uses
         the default level of compression (which is generally acceptable).
     show_legend : bool, default=True
         Greyscale images only.
@@ -155,7 +156,7 @@ def geom_imshow(image_data, cmap=None, *,
 
     Returns
     -------
-    `LayerSpec`
+    ``LayerSpec``
         Geom object specification.
 
     Notes

lets_plot/plot/geom_livemap_.py

@@ -47,14 +47,14 @@ def geom_livemap(*,
         Zoom of the map in the range 1 - 15.
     projection : str, default='epsg3857'
         The map projection. There are: 'epsg3857' for Mercator projection;
-        'epsg4326' for Equirectangular projection. `projection` only works
+        'epsg4326' for Equirectangular projection. ``projection`` only works
         with vector map tiles (i.e. Lets-Plot map tiles).
     tiles : str
         Tile provider:
 
-        - pass a predefined constant from the `tilesets` module (Lets-Plot's vector tiles, e.g. `LETS_PLOT_COLOR`, or external raster tiles, e.g. `OPEN_TOPO_MAP`);
+        - pass a predefined constant from the ``tilesets`` module (Lets-Plot's vector tiles, e.g. `LETS_PLOT_COLOR <https://lets-plot.org/python/pages/api/lets_plot.tilesets.LETS_PLOT_COLOR.html>`__, or external raster tiles, e.g. `OPEN_TOPO_MAP <https://lets-plot.org/python/pages/api/lets_plot.tilesets.OPEN_TOPO_MAP.html>`__);
         - pass a URL for a standard raster ZXY tile provider with {z}, {x} and {y} wildcards (e.g. 'http://my.tile.com/{z}/{x}/{y}.png') if the required tileset not present in the module;
-        - pass the result of a call to a `maptiles_zxy()` function if further customisation is required (e.g. attribution or zoom).
+        - pass the result of a call to a `maptiles_zxy() <https://lets-plot.org/python/pages/api/lets_plot.maptiles_zxy.html>`__ function if further customisation is required (e.g. attribution or zoom).
 
         More information about tiles can be found here:
         https://lets-plot.org/python/pages/basemap_tiles.html
@@ -62,33 +62,37 @@ def geom_livemap(*,
         Show buttons "copy location" and "draw geometry".
     data_size_zoomin : int, default=0
         Control how zooming-in of the map widget increases size of geometry objects (circles, lines etc.) on map
-        when the size is set by means of mapping between the data and the `size` aesthetic.
-        `0` - size never increases;
-        `-1` - size will be increasing without limits;
-        `n` - a number of zooming-in steps (counting from the initial state of the map widget)
+        when the size is set by means of mapping between the data and the ``size`` aesthetic.
+        0 - size never increases;
+        -1 - size will be increasing without limits;
+        n - a number of zooming-in steps (counting from the initial state of the map widget)
         when size of objects will be increasing. Farther zooming will no longer affect the size.
     const_size_zoomin : int, default=-1
         Control how zooming-in of the map widget increases size of geometry objects (circles, lines etc.) on map
         when the size is not linked to a data (i.e. constant size).
-        `0` - size never increases;
-        `-1` - size will be increasing without limits;
-        `n` - a number of zooming-in steps (counting from the initial state of the map widget)
+        0 - size never increases;
+        -1 - size will be increasing without limits;
+        n - a number of zooming-in steps (counting from the initial state of the map widget)
         when size of objects will be increasing. Farther zooming will no longer affect the size.
     other_args
         Other arguments passed on to the layer.
 
     Returns
     -------
-    `LayerSpec`
+    ``LayerSpec``
         Geom object specification.
 
     Notes
     -----
-    `geom_livemap()` draws a map, which can be dragged and zoomed.
+    ``geom_livemap()`` draws a map, which can be dragged and zoomed.
 
     ----
 
-    By default the livemap area has a non-zero inset. You can get rid of this with the theme: `theme(plot_inset=0)`.
+    By default the livemap area has a non-zero inset. You can get rid of this with the theme: ``theme(plot_inset=0)``.
+
+    ---
+
+    When drawing a path with two points, the shortest route is taken. To create a longer arc, add intermediate points.
 
     Examples
     --------
@@ -120,6 +124,27 @@ def geom_livemap(*,
             geom_point(color='white', tooltips=layer_tooltips().line('@city')) + \\
             ggtitle("The shortest path between New York and Prague")
 
+    |
+
+    .. jupyter-execute::
+        :linenos:
+        :emphasize-lines: 9
+
+        from lets_plot import *
+        LetsPlot.setup_html()
+        data = {
+            'x': [-170, 170, -170, 0, 170],
+            'y': [10, 10, -10, -10, -10],
+            'route': ['A', 'A', 'B', 'B', 'B'],
+        }
+        ggplot(data) + \\
+            geom_livemap(zoom=1, location=[180, 0]) + \\
+            geom_path(aes('x', 'y', color='route'), size=1) + \\
+            scale_color_manual(values=['red', 'green'],
+                               labels={'A': "'x': [-170, 170]",
+                                       'B': "'x': [-170, 0, 170]"}) + \\
+            ggtitle("A path that crosses the antimeridian")
+
     """
     if 'symbol' in other_args:
         print("WARN: The parameter 'symbol' is no longer supported. "

lets_plot/plot/ggbunch_.py

@@ -37,7 +37,7 @@ def ggbunch(plots: List,
 
     Returns
     -------
-    `SupPlotsSpec`
+    ``SupPlotsSpec``
         A specification describing the combined figure with all plots and their layout.
 
     Examples

lets_plot/plot/gggrid_.py

@@ -49,15 +49,15 @@ def gggrid(plots: list, ncol: int = None, *,
     vspace : float, default=4.0
         Cell vertical spacing in px.
     fit : bool, default=True
-        Whether to stretch each plot to match the aspect ratio of its cell (`fit=True`),
-        or to preserve the original aspect ratio of plots (`fit=False`).
+        Whether to stretch each plot to match the aspect ratio of its cell (``fit=True``),
+        or to preserve the original aspect ratio of plots (``fit=False``).
     align : bool, default=False
         If True, align inner areas (i.e. "geom" bounds) of plots.
         However, cells containing other (sub)grids are not participating in the plot "inner areas" layouting.
 
     Returns
     -------
-    `SupPlotsSpec`
+    ``SupPlotsSpec``
         The grid specification.
 
     Examples

lets_plot/plot/ggtb_.py

@@ -33,7 +33,7 @@ def ggtb() -> FeatureSpec:
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Toolbar feature specification.
 
     Examples

lets_plot/plot/guide.py

@@ -28,7 +28,7 @@ def guide_legend(title=None, *, nrow=None, ncol=None, byrow=None, override_aes=N
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Legend guide specification.
 
     Notes
@@ -74,7 +74,7 @@ def guide_colorbar(title=None, *, barwidth=None, barheight=None, nbin=None):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Color guide specification.
 
     Notes
@@ -122,17 +122,17 @@ def guides(**kwargs):
         
         - An aesthetic name
         - 'manual' - a key referring to the default custom legend
-        - A group name referring to a custom legend where the group is defined via the `layer_key()` function
+        - A group name referring to a custom legend where the group is defined via the `layer_key() <https://lets-plot.org/python/pages/api/lets_plot.layer_key.html>`__ function
 
         The value can be either:
 
         - A string ('colorbar', 'legend')
-        - A call to a guide function (`guide_colorbar()`, `guide_legend()`) specifying additional arguments
+        - A call to a guide function (`guide_colorbar() <https://lets-plot.org/python/pages/api/lets_plot.guide_colorbar.html>`__, `guide_legend() <https://lets-plot.org/python/pages/api/lets_plot.guide_legend.html>`__) specifying additional arguments
         - 'none' to hide the guide
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Guides specification.
 
     Examples
@@ -195,12 +195,14 @@ def layer_key(label, group=None, *, index=None, **kwargs):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Custom legend specification.
 
     Notes
     -----
-    The group name specified with the `group` parameter can be used in the `labs()` and `guides()` functions
+    The group name specified with the ``group`` parameter can be used in the
+    `labs() <https://lets-plot.org/python/pages/api/lets_plot.labs.html>`__ and
+    `guides() <https://lets-plot.org/python/pages/api/lets_plot.guides.html>`__ functions
     to further customize the display of this group (e.g. change its name).
     In particular, items in the 'manual' group will be displayed without a title unless you change it manually.
 

lets_plot/plot/label.py

@@ -27,12 +27,12 @@ def ggtitle(label, subtitle=None):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Plot title specification.
 
     Notes
     -----
-    Split a long title/subtitle into two lines or more using `\\\\n` as a text separator.
+    Split a long title/subtitle into two lines or more using ``\\\\n`` as a text separator.
 
     Examples
     --------
@@ -61,7 +61,7 @@ def xlab(label):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Axis label specification.
 
     Examples
@@ -91,7 +91,7 @@ def ylab(label):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Axis label specification.
 
     Examples
@@ -125,15 +125,15 @@ def labs(title=None, subtitle=None, caption=None, **labels):
     labels
         Name-value pairs where the name can be:
 
-        - An aesthetic name
-        - 'manual' - a key referring to the default custom legend
-        - A group name referring to a custom legend where the group is defined via the `layer_key()` function
+        - An aesthetic name.
+        - 'manual' - a key referring to the default custom legend.
+        - A group name referring to a custom legend where the group is defined via the `layer_key() <https://lets-plot.org/python/pages/api/lets_plot.layer_key.html>`__ function.
 
-        The value should be a string, e.g. `color="New Color label"`.
+        The value should be a string, e.g. ``color="New Color label"``.
 
     Returns
     -------
-    `FeatureSpec` or `FeatureSpecArray`
+    ``FeatureSpec`` or ``FeatureSpecArray``
         Labels specification.
 
     Examples

lets_plot/plot/marginal_layer.py

@@ -22,14 +22,14 @@ def ggmarginal(sides: str, *, size=None, layer: Union[LayerSpec, FeatureSpecArra
         Size of marginal geometry (width or height, depending on the margin side) as a fraction of the entire
         plotting area of the plot.
         The value should be in range [0.01..0.95].
-    layer : `LayerSpec`
+    layer : ``LayerSpec``
         A marginal geometry layer.
-        The result of calling of the `geom_xxx()` / `stat_xxx()` function.
-        Marginal plot works best with `density`,`histogram`,`boxplot`,`violin` and `freqpoly` geometry layers.
+        The result of calling of the ``geom_xxx()``/``stat_xxx()`` function.
+        Marginal plot works best with ``density``, ``histogram``, ``boxplot``, ``violin`` and ``freqpoly`` geometry layers.
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         An object specifying a marginal geometry layer or a list of marginal geometry layers.
 
     Notes

lets_plot/plot/plot.py

@@ -20,38 +20,38 @@ def ggplot(data=None, mapping=None):
 
     Parameters
     ----------
-    data : dict or Pandas or Polars `DataFrame`
+    data : dict or Pandas or Polars ``DataFrame``
         Default dataset to use for the plot. If not specified,
         must be supplied in each layer added to the plot.
-    mapping : `FeatureSpec`
+    mapping : ``FeatureSpec``
         Default list of aesthetic mappings to use for the plot.
         If not specified, must be supplied in each layer added to the plot.
 
     Returns
     -------
-    `PlotSpec`
+    ``PlotSpec``
         Plot specification.
 
     Notes
     -----
-    `ggplot()` initializes a ggplot object.
+    ``ggplot()`` initializes a ggplot object.
     It can be used to declare the input data frame for a graphic and
     to specify the set of plot aesthetics intended to be common
     throughout all subsequent layers unless specifically overridden.
 
-    `ggplot()` is typically used to construct a plot incrementally,
+    ``ggplot()`` is typically used to construct a plot incrementally,
     using the + operator to add layers to the existing ggplot object.
     This is advantageous in that the code is explicit about which layers
     are added and the order in which they are added. For complex graphics
-    with multiple layers, initialization with `ggplot()` is recommended.
+    with multiple layers, initialization with ``ggplot()`` is recommended.
 
     There are three common ways to invoke ggplot (see examples below):
 
-    - `ggplot(data, aes(x, y))`: This method is recommended if all layers use the same data and the same set of aesthetics, although this method can also be used to add a layer using data from another data frame.
-    - `ggplot(data)`: This method specifies the default data frame to use for the plot, but no aesthetics are defined up front. This is useful when one data frame is used predominantly as layers are added, but the aesthetics may vary from one layer to another.
-    - `ggplot()`: This method initializes a skeleton ggplot object which is fleshed out as layers are added. This method is useful when multiple data frames are used to produce different layers, as is often the case in complex graphics.
+    - ``ggplot(data, aes(x, y))``: This method is recommended if all layers use the same data and the same set of aesthetics, although this method can also be used to add a layer using data from another data frame.
+    - ``ggplot(data)``: This method specifies the default data frame to use for the plot, but no aesthetics are defined up front. This is useful when one data frame is used predominantly as layers are added, but the aesthetics may vary from one layer to another.
+    - ``ggplot()``: This method initializes a skeleton ggplot object which is fleshed out as layers are added. This method is useful when multiple data frames are used to produce different layers, as is often the case in complex graphics.
 
-    `ggplot()` with no layers defined will produce an error message:
+    ``ggplot()`` with no layers defined will produce an error message:
     "No layers in plot".
 
     Examples
@@ -109,7 +109,7 @@ def ggsize(width, height):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Plot size specification.
 
     Examples
@@ -142,13 +142,14 @@ def ggsize(width, height):
 
 class GGBunch(FeatureSpec):
     """
-    Class `GGBunch` is deprecated and will be removed in future releases.
-    Please, use function `ggbunch()` to combine several plots into a single figure with custom layout.
+    Class ``GGBunch`` is deprecated and will be removed in future releases.
+    Please, use function `ggbunch() <https://lets-plot.org/python/pages/api/lets_plot.ggbunch.html>`__
+    to combine several plots into a single figure with custom layout.
 
     Collection of plots created by ggplot function.
-    Use method `add_plot()` to add plot to 'bunch'.
+    Use method ``add_plot()`` to add plot to 'bunch'.
     Each plot can have arbitrary location and size.
-    Use `show()` to draw all plots in bunch.
+    Use ``show()`` to draw all plots in bunch.
 
     Examples
     --------
@@ -191,7 +192,7 @@ class GGBunch(FeatureSpec):
         Parameters
         ----------
         plot_spec
-            Plot specification created by `ggplot()` function.
+            Plot specification created by ``ggplot()`` function.
         x : int
             x-coordinate of plot origin in px.
         y : int

lets_plot/plot/pos.py

@@ -26,7 +26,7 @@ def position_dodge(width=None):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Geom object position specification.
 
     Notes
@@ -56,7 +56,7 @@ def position_dodge(width=None):
 
 def position_dodgev(height=None):
     """
-    Function `position_dodgev()` is deprecated and will be removed in future releases.
+    Function ``position_dodgev()`` is deprecated and will be removed in future releases.
 
     """
     print("WARN: The function position_dodgev() is deprecated and will be removed in future releases.")
@@ -84,7 +84,7 @@ def position_jitter(width=None, height=None, seed=None):
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Geom object position specification.
 
     Notes
@@ -129,12 +129,12 @@ def position_nudge(x=None, y=None, unit=None):
         Possible values:
 
         - 'identity': a unit of 1 corresponds to a difference of 1 in data space;
-        - 'size': a unit of 1 corresponds to the diameter of a point with `size=1`;
+        - 'size': a unit of 1 corresponds to the diameter of a point with ``size=1``;
         - 'px': the unit is measured in screen pixels.
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Geom object position specification.
 
     Notes
@@ -165,23 +165,23 @@ def position_nudge(x=None, y=None, unit=None):
 
 def position_jitterdodge(dodge_width=None, jitter_width=None, jitter_height=None, seed=None):
     """
-    This is primarily used for aligning points generated through `geom_point()`
-    with dodged boxplots (e.g., a `geom_boxplot()` with a fill aesthetic supplied).
+    This is primarily used for aligning points generated through `geom_point() <https://lets-plot.org/python/pages/api/lets_plot.geom_point.html>`__
+    with dodged boxplots (e.g., a `geom_boxplot() <https://lets-plot.org/python/pages/api/lets_plot.geom_boxplot.html>`__ with a fill aesthetic supplied).
 
     Parameters
     ----------
     dodge_width : float
         Bin width.
-        The value of `dodge_width` is relative and typically ranges between 0 and 1.
+        The value of ``dodge_width`` is relative and typically ranges between 0 and 1.
         Values that are greater than 1 lead to overlapping of the boxes.
         The default value is taken from the width aesthetics of the data point.
     jitter_width : float, default=.4
         Jittering width.
-        The value of `jitter_width` is relative and typically ranges between 0 and 0.5.
+        The value of ``jitter_width`` is relative and typically ranges between 0 and 0.5.
         Values that are greater than 0.5 lead to overlapping of the points.
     jitter_height : float, default=.4
         Jittering height.
-        The value of `jitter_height` is relative and typically ranges between 0 and 0.5.
+        The value of ``jitter_height`` is relative and typically ranges between 0 and 0.5.
         Values that are greater than 0.5 lead to overlapping of the points.
     seed : int
         A random seed to make the jitter reproducible.
@@ -189,7 +189,7 @@ def position_jitterdodge(dodge_width=None, jitter_width=None, jitter_height=None
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Geom object position specification.
 
     Notes
@@ -233,14 +233,14 @@ def position_stack(vjust=None, mode=None):
         not a dimension (like bars or areas).
         Set to 0 to align with the bottom, 0.5 for the middle, and 1 for the top.
     mode : {'groups', 'all'}, default='groups'
-        If 'groups', objects inside one group are positioned as in `position='identity'`,
+        If 'groups', objects inside one group are positioned as in ``position='identity'``,
         but each group is shifted to sum of heights of previous groups
         (where height of a group is a maximum of it's y values).
         If 'all', each object will be shifted.
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Geom object position specification.
 
     Notes
@@ -279,14 +279,14 @@ def position_fill(vjust=None, mode=None):
         not a dimension (like bars or areas).
         Set to 0 to align with the bottom, 0.5 for the middle, and 1 for the top.
     mode : {'groups', 'all'}, default='groups'
-        If 'groups', objects inside one group are positioned as in `position='identity'`,
+        If 'groups', objects inside one group are positioned as in ``position='identity'``,
         but each group is shifted to sum of heights of previous groups
         (where height of a group is a maximum of it's y values).
         If 'all', each object will be shifted.
 
     Returns
     -------
-    `FeatureSpec`
+    ``FeatureSpec``
         Geom object position specification.
 
     Notes