pysidesignal: more trivial fixes

Fix typos and coding style.

Signed-off-by: Paulo Alcantara <pcacjr@gmail.com>
Reviewed-by: Marcelo Lira <marcelo.lira@openbossa.org>

libpyside/pysidesignal.h

@@ -47,12 +47,13 @@ extern "C"
     };
 }; // extern "C"
 
-namespace PySide { namespace Signal {
+namespace PySide {
+namespace Signal {
 
 PYSIDE_API bool checkType(PyObject* type);
 
 /**
- * This function creates a Signal object which stay attached to QObject class
+ * This function creates a Signal object which stays attached to QObject class
  *
  * @param   name of the Signal to be registered on meta object
  * @param   signatures a list of signatures supported by this signal, ended with a NULL pointer
@@ -67,7 +68,7 @@ PYSIDE_DEPRECATED(PYSIDE_API PySideSignal* newObject(const char* name, ...));
 PYSIDE_API void registerSignals(SbkObjectType* pyObj, const QMetaObject* metaObject);
 
 /**
- * This function creates a Signal object which stay attached to QObject class based on a list of QMetaMethod
+ * This function creates a Signal object which stays attached to QObject class based on a list of QMetaMethods
  *
  * @param   source of the Signal to be registered on meta object
  * @param   methods a list of QMetaMethod wich contains the supported signature
@@ -76,7 +77,7 @@ PYSIDE_API void registerSignals(SbkObjectType* pyObj, const QMetaObject* metaObj
 PYSIDE_API PySideSignalInstance* newObjectFromMethod(PyObject* source, const QList<QMetaMethod>& methods);
 
 /**
- * This function initializes the Signal object creating a PySideSignalInstance
+ * This function initializes the Signal object by creating a PySideSignalInstance
  *
  * @param   self a Signal object used as base to PySideSignalInstance
  * @param   name the name to be used on PySideSignalInstance
@@ -86,10 +87,10 @@ PYSIDE_API PySideSignalInstance* newObjectFromMethod(PyObject* source, const QLi
 PYSIDE_API PySideSignalInstance* initialize(PySideSignal* signal, PyObject* name, PyObject* object);
 
 /**
- * This function is used to retrieve the object in which the sigal is attached
+ * This function is used to retrieve the object in which the signal is attached
  *
  * @param   self The Signal object
- * @return  Return the internal reference to parent object of the signal
+ * @return  Return the internal reference to the parent object of the signal
  **/
 PYSIDE_API PyObject* getObject(PySideSignalInstance* signal);
 
@@ -115,35 +116,37 @@ PYSIDE_API void updateSourceObject(PyObject* source);
 PYSIDE_DEPRECATED(PYSIDE_API void addSignalToWrapper(SbkObjectType* wrapperType, const char* signalName, PySideSignal* signal));
 
 /**
- * This function verify if the signature is a QtSignal base on SIGNAL flag
+ * This function verifies if the signature is a QtSignal base on SIGNAL flag
  * @param   signature   The signal signature
- * @return  Return true if this is a Qt Signal of false if not
+ * @return  Return true if this is a Qt Signal, otherwise return false
  **/
 PYSIDE_API bool isQtSignal(const char* signature);
 
 /**
- * This function is similar as isQtSignal but this reaise a Python error if this faisl
+ * This function is similar to isQtSignal, however if it fails, it'll raise a Python error instead.
+ *
  * @param   signature   The signal signature
- * @return  Return true if this is a Qt Signal of false if not
+ * @return  Return true if this is a Qt Signal, otherwise return false
  **/
 PYSIDE_API bool checkQtSignal(const char* signature);
 
 /**
  * This function is used to retrieve the signature base on Signal and receiver callback
  * @param   signature   The signal signature
- * @param   receiver    The QObject which will receiver the signal
+ * @param   receiver    The QObject which will receive the signal
- * @param   callback    Callback function which will connect with signal
+ * @param   callback    Callback function which will connect to the signal
  * @param   encodeName  Used to specify if the returned signature will be encoded with Qt signal/slot style
  * @return  Return the callback signature
  **/
 PYSIDE_API QString getCallbackSignature(const char* signal, QObject* receiver, PyObject* callback, bool encodeName);
 
 /**
- * Function to parese the signature and return a list of argument types
+ * This function parses the signature and then returns a list of argument types.
+ *
  * @param   signature       The signal signature
  * @param   isShortCircuit  If this is a shortCircuit(python<->python) signal
- * @return  Return true if this is a Qt Signal of false if not
+ * @return  Return true if this is a Qt Signal, otherwise return false
- * @todo    replace return type to QList<QByteArray>
+ * @todo    replace return type by QList<QByteArray>
  **/
 QStringList getArgsFromSignature(const char* signature, bool* isShortCircuit = 0);