doc: small refinements

KenKundert · Jul 13, 2021 · 84eaad3 · 84eaad3
1 parent 8d2ae4e
commit 84eaad3
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 5 deletions.
diff --git a/doc/basic_use.rst b/doc/basic_use.rst
@@ -32,7 +32,7 @@ a :exc:`NestedTextError` exception is raised.
     ... """
 
     >>> try:
-    ...     data = nt.loads(content, 'dict')
+    ...     data = nt.loads(content, top='dict')
     ... except nt.NestedTextError as e:
     ...     e.terminate()
 
@@ -47,7 +47,7 @@ function.
     >>> from inform import fatal, os_error
 
     >>> try:
-    ...     groceries = nt.load('examples/groceries.nt', 'dict')
+    ...     groceries = nt.load('examples/groceries.nt', top='dict')
     ... except nt.NestedTextError as e:
     ...     e.terminate()
     ... except OSError as e:

diff --git a/nestedtext.py b/nestedtext.py
@@ -994,7 +994,7 @@ def loads(content, top='dict', *, source=None, on_dup=None, keymap=None):
 
     Examples:
 
-        *NestedText* is specified to *loads* in the form of a string:
+        A *NestedText* document is specified to *loads* in the form of a string:
 
         .. code-block:: python
 
@@ -1521,8 +1521,8 @@ def dumps(
             42: unsupported type.
 
         Alternatively, you can specify a function to *default*, which is used
-        to convert values to strings.  It is used if no other converter is
-        available.  Typical values are *str* and *repr*.
+        to convert values to recognized types.  It is used if no suitable
+        converter is available.  Typical values are *str* and *repr*.
 
         .. code-block:: python