code style, documentation

src/lib/ebus/data.h

@@ -722,7 +722,7 @@ class LoadableDataFieldSet : public DataFieldSet, public MappedFileReader {
   /**
    * Constructs a new instance.
    * @param name the field name.
-   * @param fields the @a vector of @a SingleDataField instances part of this set.
+   * @param templates the @a DataFieldTemplates instance to use.
    */
   LoadableDataFieldSet(const string& name, DataFieldTemplates* templates)
     : DataFieldSet(name, vector<const SingleDataField*>()), MappedFileReader(false), m_templates(templates) {
@@ -736,6 +736,7 @@ class LoadableDataFieldSet : public DataFieldSet, public MappedFileReader {
       vector< map<string, string> >* subRows, string* errorDescription, bool replace) override;
 
  private:
+  /** the @a DataFieldTemplates instance to use. */
   DataFieldTemplates* m_templates;
 };
 

src/lib/ebus/message.h

@@ -195,6 +195,7 @@ class Message : public AttributedItem {
   /**
    * Create a new scan @a Message instance.
    * @param broadcast true for broadcast scan message, false for scan message to be sent to a slave address.
+   * @param deleteData whether to delete the @a DataField during @a Message destruction.
    * @return the new scan @a Message instance.
    */
   static Message* createScanMessage(bool broadcast = false, bool deleteData = true);
@@ -1217,6 +1218,7 @@ class MessageMap : public MappedFileReader {
    * Construct a new instance.
    * @param addAll whether to add all messages, even if duplicate.
    * @param preferLanguage the preferred language to use, or empty.
+   * @param deleteData whether to delete the scan message @a DataField during @a Message destruction.
    */
   explicit MessageMap(bool addAll = false, const string& preferLanguage = "", bool deleteData = true)
   : MappedFileReader::MappedFileReader(true),