From 88b3ef9b5f73130c29c4d9201377a92c48df5d38 Mon Sep 17 00:00:00 2001
From: Kovid Goyal <kovid@kovidgoyal.net>
Date: Fri, 11 Dec 2020 08:07:05 +0530
Subject: [PATCH] Add a note about limitations of browsers

---
 manual/viewer.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/manual/viewer.rst b/manual/viewer.rst
index 5af7a74d1a..6e04c1e836 100644
--- a/manual/viewer.rst
+++ b/manual/viewer.rst
@@ -141,6 +141,13 @@ the selection bar in the viewer preferences under :guilabel:`Selection
 behavior`.
 
 
+.. note:: Support for text-to-speech in browsers is very incomplete and
+   bug-ridden so how well :guilabel:`Read aloud` will work in the in-browser
+   viewer is dependent on how well the underlying browser supports
+   text-to-speech. In particular, highlighting of current word does not work,
+   and changing speed or voice will cause reading to start again from the
+   beginning.
+
 .. note:: On Linux, :guilabel:`Read aloud` requires `Speech Dispatcher
    <https://freebsoft.org/speechd>`_ to be installed and working.