Merge remote-tracking branch 'origin/5.7' into 5.8

Change-Id: I4f2c44fa70f4f0905daf22c619c597a4a1972c85

1 files changed, 15 insertions, 1 deletions

diff --git a/src/serialport/qserialport.cpp b/src/serialport/qserialport.cpp
index e62cf69..d23e3b6 100644
--- a/src/serialport/qserialport.cpp
+++ b/src/serialport/qserialport.cpp
@@ -158,6 +158,8 @@ void QSerialPortPrivate::setError(const QSerialPortErrorInfo &errorInfo)
     \note The serial port is always opened with exclusive access
     (that is, no other process or thread can access an already opened serial port).
 
+    Use the close() method to close the port and cancel the I/O operations.
+
     Having successfully opened, QSerialPort tries to determine the current
     configuration of the port and initializes itself. You can reconfigure the
     port to the desired setting using the setBaudRate(), setDataBits(),
@@ -176,7 +178,19 @@ void QSerialPortPrivate::setError(const QSerialPortErrorInfo &errorInfo)
     QSerialPort's internal read buffer. You can limit the size of the read
     buffer using setReadBufferSize().
 
-    Use the close() method to close the port and cancel the I/O operations.
+    QSerialPort provides a set of functions that suspend the
+    calling thread until certain signals are emitted. These functions
+    can be used to implement blocking serial ports:
+
+    \list
+
+    \li waitForReadyRead() blocks calls until new data is available for
+    reading.
+
+    \li waitForBytesWritten() blocks calls until one payload of data has
+    been written to the serial port.
+
+    \endlist
 
     See the following example: