Skip to content

Commit

Permalink
Update syntax.rst
Browse files Browse the repository at this point in the history
  • Loading branch information
vitaut authored Mar 30, 2024
1 parent 3b5f3de commit f5ec5ad
Showing 1 changed file with 10 additions and 9 deletions.
19 changes: 10 additions & 9 deletions doc/syntax.rst
Original file line number Diff line number Diff line change
Expand Up @@ -491,7 +491,7 @@ Range Format Specifications
Format specifications for range types have the following syntax:

.. productionlist:: sf
range_format_spec: [":" ["n"][`range_type`][`range_underlying_spec`]]
range_format_spec: ["n"][`range_type`][`range_underlying_spec`]

The ``'n'`` option formats the range without the opening and closing brackets.

Expand All @@ -500,23 +500,24 @@ The available presentation types for `range_type` are:
+---------+----------------------------------------------------------+
| Type | Meaning |
+=========+==========================================================+
| none | Default format. |
+---------+----------------------------------------------------------+
| ``'s'`` | String format. The range is formatted as a string. |
+---------+----------------------------------------------------------+
| ``'?s'``| Debug format. The range is formatted as an escaped |
| | string. |
+---------+----------------------------------------------------------+
| none | Default format. The range is formatted with a separator. |
+---------+----------------------------------------------------------+

If `range_type` is ``'s'`` or ``'?s'``, the range element type must be a character type. The
``'n'`` option and `range_underlying_spec` are mutually exclusive with ``'s'`` and ``'?s'``.
If `range_type` is ``'s'`` or ``'?s'``, the range element type must be a
character type. The ``'n'`` option and `range_underlying_spec` are mutually
exclusive with ``'s'`` and ``'?s'``.

The `range_underlying_spec` is parsed based on the formatter of the range's
reference type.
element type.

By default, a range of characters or strings is printed escaped and quoted. But
if any `range_underlying_spec` is provided (even if it is empty), then the characters
or strings are printed according to the provided specification.
By default, a range of characters or strings is printed escaped and quoted.
But if any `range_underlying_spec` is provided (even if it is empty), then
the characters or strings are printed according to the provided specification.

Examples::

Expand Down

0 comments on commit f5ec5ad

Please sign in to comment.