[documentation] Fix hiccups in documentation comments. MER#1749

There are build time warnings due to conflicts between actual source code
and documentation statements in the comments.

Use the actual filenames, correct case for parameters, etc.

Signed-off-by: Simo Piiroinen <simo.piiroinen@jollamobile.com>

adaptors/magnetometeradaptor-evdev/magnetometerevdevadaptor.h

@@ -1,5 +1,5 @@
 /**
-   @file magnetometeradaptor-evdevplugin.cpp
+   @file magnetometerevdevadaptor.h
    @brief Contains MagnetometerAdaptorEvdevPlugin.
 
    <p>

datatypes/lid.h

@@ -49,14 +49,14 @@ class Lid : public QObject
     /**
      * Constructor.
      *
-     * @param LidData Source object.
+     * @param lidData Source object.
      */
     Lid(const LidData& lidData);
 
     /**
      * Copy constructor.
      *
-     * @param Lid Source object.
+     * @param lid Source object.
      */
     Lid(const Lid& lid);
 
@@ -86,7 +86,7 @@ Q_DECLARE_METATYPE( Lid )
  * Marshall the Lid data into a D-Bus argument
  *
  * @param argument dbus argument.
- * @param Lid data to marshall.
+ * @param lid data to marshall.
  * @return dbus argument.
  */
 inline QDBusArgument &operator<<(QDBusArgument &argument, const Lid &lid)
@@ -101,7 +101,7 @@ inline QDBusArgument &operator<<(QDBusArgument &argument, const Lid &lid)
  * Unmarshall Lid data from the D-Bus argument
  *
  * @param argument dbus argument.
- * @param Lid unmarshalled data.
+ * @param lid unmarshalled data.
  * @return dbus argument.
  */
 inline const QDBusArgument &operator>>(const QDBusArgument &argument, Lid &lid)

datatypes/liddata.h

@@ -1,5 +1,5 @@
 /**
-   @file LidData.h
+   @file liddata.h
    @brief Datatype for device tap events
 
    <p>
@@ -57,6 +57,7 @@ class LidData : public TimedData {
      * Constructor.
      * @param timestamp Timestamp of lid event.
      * @param type Type of lid.
+     * @param value Initial value to use
      */
     LidData(const quint64& timestamp, Type type, unsigned value) :
         TimedData(timestamp), type_(type), value_(value) {}