Assign a new method name for the port name setting API

* This is more intuitive as it is not setting the port with all its settings
like baud rate, flow control, stop bits, parity, and so forth, but only the port
name.

* This will allow in upcoming change to establish a property for the port name
along with a port name changed signal to be useful from different threads, QML,
and so forth.

* Clean up the documentation not to provide internal information to the end
users, and also make the text a bit more concise and better readable.

* Examples are also changed accordingly, to use the new API.

Change-Id: Idbaa8ee2dee17c63fc0278f687ccc231c5ab670f
Reviewed-by: Denis Shienkov <denis.shienkov@gmail.com>

1 files changed, 3 insertions, 2 deletions

diff --git a/src/serialport/qserialport.h b/src/serialport/qserialport.h
index 213aba9a..aa87eba9 100644
--- a/src/serialport/qserialport.h
+++ b/src/serialport/qserialport.h
@@ -164,10 +164,11 @@ public:
     explicit QSerialPort(const QSerialPortInfo &info, QObject *parent = 0);
     virtual ~QSerialPort();
 
-    void setPort(const QString &port);
-    void setPort(const QSerialPortInfo &info);
+    void setPortName(const QString &name);
     QString portName() const;
 
+    void setPort(const QSerialPortInfo &info);
+
     virtual bool open(OpenMode mode);
     virtual void close();