bpo-10379: Add %char examples to locale.format() docs (GH-1145)
diff --git a/Doc/library/locale.rst b/Doc/library/locale.rst
index 181f534..69959a3 100644
--- a/Doc/library/locale.rst
+++ b/Doc/library/locale.rst
@@ -371,13 +371,14 @@
.. function:: format(format, val, grouping=False, monetary=False)
- Please note that this function works like format_string but will only work
- for exactly one %char specifier.
+ Please note that this function works like :meth:`format_string` but will
+ only work for exactly one ``%char`` specifier. For example, ``'%f'`` and
+ ``'%.0f'`` are both valid specifiers, but ``'%f kB'`` is not.
For whole format strings, use :func:`format_string`.
.. deprecated:: 3.7
- Use :meth:`format_string` instead
+ Use :meth:`format_string` instead.
.. function:: currency(val, symbol=True, grouping=False, international=False)