Fix typos and document callable that returns formatted text (#1186)

* Fix typos * Reword "Processing .inputrc" section * Document that formatted text can be a callable (fix #948) Co-authored-by: Anonymous <you@example.com>

Author: plotski

docs/pages/advanced_topics/key_bindings.rst

@@ -334,6 +334,6 @@ information.
 Processing `.inputrc`
 ---------------------
 
-GNU readline can be configured using an `.inputrc` configuration file. This can
-could key bindings as well as certain settings. Right now, prompt_toolkit
-doesn't support `.inputrc` yet, but it should be possible in the future.
+GNU readline can be configured using an `.inputrc` configuration file. This file
+contains key bindings as well as certain settings. Right now, prompt_toolkit
+doesn't support `.inputrc`, but it should be possible in the future.

docs/pages/full_screen_apps.rst

@@ -66,7 +66,7 @@ I/O objects
 -----------
 
 Every :class:`~prompt_toolkit.application.Application` instance requires an I/O
-objects for input and output:
+object for input and output:
 
  - An :class:`~prompt_toolkit.input.Input` instance, which is an abstraction
  of the input stream (stdin).
@@ -326,7 +326,7 @@ Modal containers
 All container objects, like :class:`~prompt_toolkit.layout.VSplit` and
 :class:`~prompt_toolkit.layout.HSplit` take a ``modal`` argument.
 
-If this flag has been set, then key bindings from the parent account are not
+If this flag has been set, then key bindings from the parent are not
 taken into account if one of the children windows has the focus.
 
 This is useful in a complex layout, where many controls have their own key

docs/pages/printing_text.rst

@@ -60,7 +60,7 @@ There are several ways to display colors:
 
 An instance of any of these four kinds of objects is called "formatted text".
 There are various places in prompt toolkit, where we accept not just plain text
-(as a strings), but also formatted text.
+(as a string), but also formatted text.
 
 HTML
 ^^^^

prompt_toolkit/application/application.py

@@ -161,7 +161,7 @@ class Application(Generic[_AppResult]):
  don't want this for the implementation of a REPL. By default, this is
  enabled if `full_screen` is set.
 
- Callbacks (all of these should accept a
+ Callbacks (all of these should accept an
  :class:`~prompt_toolkit.application.Application` object as input.)
 
  :param on_reset: Called during reset.

prompt_toolkit/formatted_text/base.py

@@ -55,8 +55,9 @@ def to_formatted_text(
  fragments. (Which is the canonical form of formatted text.) The outcome is
  always a `FormattedText` instance, which is a list of (style, text) tuples.
 
- It can take an `HTML` object, a plain text string, or anything that
- implements `__pt_formatted_text__`.
+ It can take a plain text string, an `HTML` or `ANSI` object, anything that
+ implements `__pt_formatted_text__` or a callable that takes no arguments and
+ returns one of those.
 
  :param style: An additional style string which is applied to all text
  fragments.

prompt_toolkit/layout/containers.py

@@ -1108,7 +1108,7 @@ def __repr__(self) -> str:
 
 class WindowRenderInfo:
  """
- Render information, for the last render time of this control.
+ Render information for the last render time of this control.
  It stores mapping information between the input buffers (in case of a
  :class:`~prompt_toolkit.layout.controls.BufferControl`) and the actual
  render position on the output screen.

prompt_toolkit/layout/controls.py

@@ -270,10 +270,10 @@ class FormattedTextControl(UIControl):
  """
  Control that displays formatted text. This can be either plain text, an
  :class:`~prompt_toolkit.formatted_text.HTML` object an
- :class:`~prompt_toolkit.formatted_text.ANSI` object or a list of
- ``(style_str, text)`` tuples, depending on how you prefer to do the
- formatting. See ``prompt_toolkit.layout.formatted_text`` for more
- information.
+ :class:`~prompt_toolkit.formatted_text.ANSI` object, a list of ``(style_str,
+ text)`` tuples or a callable that takes no argument and returns one of
+ those, depending on how you prefer to do the formatting. See
+ ``prompt_toolkit.layout.formatted_text`` for more information.
 
  (It's mostly optimized for rather small widgets, like toolbars, menus, etc...)
 

prompt_toolkit/layout/dimension.py

@@ -27,8 +27,8 @@ class Dimension:
  :param max: Maximum size.
  :param weight: For a VSplit/HSplit, the actual size will be determined
  by taking the proportion of weights from all the children.
- E.g. When there are two children, one width a weight of 1,
- and the other with a weight of 2. The second will always be
+ E.g. When there are two children, one with a weight of 1,
+ and the other with a weight of 2, the second will always be
  twice as big as the first, if the min/max values allow it.
  :param preferred: Preferred size.
  """