docs: Fix some references and RST markup to eliminate Sphinx warnings.

6 files changed, 15 insertions, 15 deletions

diff --git a/docs/library/array.rst b/docs/library/array.rst
index d096c6ec4..f837b0343 100644
--- a/docs/library/array.rst
+++ b/docs/library/array.rst
@@ -16,14 +16,14 @@ Classes
 .. class:: array.array(typecode, [iterable])
 
     Create array with elements of given type. Initial contents of the
-    array are given by an `iterable`. If it is not provided, an empty
+    array are given by *iterable*. If it is not provided, an empty
     array is created.
 
     .. method:: append(val)
 
-        Append new element to the end of array, growing it.
+        Append new element *val* to the end of array, growing it.
 
     .. method:: extend(iterable)
 
-        Append new elements as contained in an iterable to the end of
+        Append new elements as contained in *iterable* to the end of
         array, growing it.
diff --git a/docs/library/lcd160cr.rst b/docs/library/lcd160cr.rst
index 567994640..bb8e6da22 100644
--- a/docs/library/lcd160cr.rst
+++ b/docs/library/lcd160cr.rst
@@ -172,7 +172,7 @@ Drawing text
 ------------
 
 To draw text one sets the position, color and font, and then uses
-`write` to draw the text.
+`LCD160CR.write` to draw the text.
 
 .. method:: LCD160CR.set_pos(x, y)
 
@@ -279,7 +279,7 @@ Touch screen methods
 .. method:: LCD160CR.is_touched()
 
     Returns a boolean: ``True`` if there is currently a touch force on the screen,
-    `False` otherwise.
+    ``False`` otherwise.
 
 .. method:: LCD160CR.get_touch()
 
diff --git a/docs/library/pyb.Switch.rst b/docs/library/pyb.Switch.rst
index e5ab6bd84..1edcbf848 100644
--- a/docs/library/pyb.Switch.rst
+++ b/docs/library/pyb.Switch.rst
@@ -38,7 +38,7 @@ Methods
 
 .. method:: Switch.value()
 
-   Get the switch state.  Returns `True` if pressed down, otherwise `False`.
+   Get the switch state.  Returns ``True`` if pressed down, otherwise ``False``.
 
 .. method:: Switch.callback(fun)
 
diff --git a/docs/library/uio.rst b/docs/library/uio.rst
index 7e6c93228..81420702d 100644
--- a/docs/library/uio.rst
+++ b/docs/library/uio.rst
@@ -81,7 +81,7 @@ Functions
 
     Open a file. Builtin ``open()`` function is aliased to this function.
     All ports (which provide access to file system) are required to support
-    `mode` parameter, but support for other arguments vary by port.
+    *mode* parameter, but support for other arguments vary by port.
 
 Classes
 -------
@@ -103,7 +103,7 @@ Classes
     text-mode I/O (similar to a normal file opened with "t" modifier).
     `BytesIO` is used for binary-mode I/O (similar to a normal file
     opened with "b" modifier). Initial contents of file-like objects
-    can be specified with `string` parameter (should be normal string
+    can be specified with *string* parameter (should be normal string
     for `StringIO` or bytes object for `BytesIO`). All the usual file
     methods like ``read()``, ``write()``, ``seek()``, ``flush()``,
     ``close()`` are available on these objects, and additionally, a
diff --git a/docs/library/uselect.rst b/docs/library/uselect.rst
index fb43f7e63..77d458473 100644
--- a/docs/library/uselect.rst
+++ b/docs/library/uselect.rst
@@ -35,10 +35,10 @@ Methods
 
    Register `stream` *obj* for polling. *eventmask* is logical OR of:
 
-   * `uselect.POLLIN`  - data available for reading
-   * `uselect.POLLOUT` - more data can be written
+   * ``uselect.POLLIN``  - data available for reading
+   * ``uselect.POLLOUT`` - more data can be written
 
-   Note that flags like `uselect.POLLHUP` and `uselect.POLLERR` are
+   Note that flags like ``uselect.POLLHUP`` and ``uselect.POLLERR`` are
    *not* valid as input eventmask (these are unsolicited events which
    will be returned from `poll()` regardless of whether they are asked
    for). This semantics is per POSIX.
@@ -63,7 +63,7 @@ Methods
    tuple, depending on a platform and version, so don't assume that its size is 2.
    The ``event`` element specifies which events happened with a stream and
    is a combination of ``uselect.POLL*`` constants described above. Note that
-   flags `uselect.POLLHUP` and `uselect.POLLERR` can be returned at any time
+   flags ``uselect.POLLHUP`` and ``uselect.POLLERR`` can be returned at any time
    (even if were not asked for), and must be acted on accordingly (the
    corresponding stream unregistered from poll and likely closed), because
    otherwise all further invocations of `poll()` may return immediately with
diff --git a/docs/library/ussl.rst b/docs/library/ussl.rst
index 903a351f4..be84dc054 100644
--- a/docs/library/ussl.rst
+++ b/docs/library/ussl.rst
@@ -18,10 +18,10 @@ Functions
    Takes a `stream` *sock* (usually usocket.socket instance of ``SOCK_STREAM`` type),
    and returns an instance of ssl.SSLSocket, which wraps the underlying stream in
    an SSL context. Returned object has the usual `stream` interface methods like
-   `read()`, `write()`, etc. In MicroPython, the returned object does not expose
-   socket interface and methods like `recv()`, `send()`. In particular, a
+   ``read()``, ``write()``, etc. In MicroPython, the returned object does not expose
+   socket interface and methods like ``recv()``, ``send()``. In particular, a
    server-side SSL socket should be created from a normal socket returned from
-   `accept()` on a non-SSL listening server socket.
+   :meth:`~usocket.socket.accept()` on a non-SSL listening server socket.
 
    Depending on the underlying module implementation in a particular
    `MicroPython port`, some or all keyword arguments above may be not supported.