-/** Reads a data item from a device that has previously been written by writeDataToDevice().
- * If not enough data bytes are available, the function returns false and the QVariant reference
- * remains untouched.
+//! Take a string and decode it using the specified text codec, recognizing utf8.
+/** This function takes a string and first checks if it is encoded in utf8, in which case it is
+ * decoded appropriately. Otherwise, the specified text codec is used to transform the string.
+ * \param input The input string containing encoded data
+ * \param codec The text codec we use if the input is not utf8
+ * \return The decoded string.