X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;ds=sidebyside;f=libs%2Fpbd%2Fpbd%2Fproperty_list.h;h=c43c160684109bdc98f0f50851e3d15bec368c7c;hb=e01d074ad1d1837055437e372e0102fc34a4c257;hp=abb85e77d52dbd1940dd60cd9be11c2097e39517;hpb=9aacefc17010a889222425f97b99050171165038;p=ardour.git

diff --git a/libs/pbd/pbd/property_list.h b/libs/pbd/pbd/property_list.h
index abb85e77d5..c43c160684 100644
--- a/libs/pbd/pbd/property_list.h
+++ b/libs/pbd/pbd/property_list.h
@@ -29,27 +29,31 @@ class XMLNode;
 
 namespace PBD {
 
-/** A list of properties, mapped using their ID */	
+/** A list of properties, mapped using their ID */
 class LIBPBD_API PropertyList : public std::map<PropertyID, PropertyBase*>
 {
 public:
 	PropertyList ();
 	PropertyList (PropertyList const &);
-        
+
 	virtual ~PropertyList();
 
-        void get_changes_as_xml (XMLNode *);
+	void get_changes_as_xml (XMLNode*);
 	void invert ();
 
-        /** Add a property (of some kind) to the list. Used when
-            constructing PropertyLists that describe a change/operation.
-        */
-        bool add (PropertyBase* prop);
+	/** Add a property (of some kind) to the list.
+	 *
+	 * Used when
+	 * constructing PropertyLists that describe a change/operation.
+	 */
+	bool add (PropertyBase* prop);
 
-	/* Code that is constructing a property list for use
+	/** Construct a new Property List
+	 *
+	 * Code that is constructing a property list for use
 	 * in setting the state of an object uses this.
-         *
-         * Defined below, once we have Property<T>
+	 *
+	 * Defined below, once we have Property<T>
 	 */
 	template<typename T, typename V> bool add (PropertyDescriptor<T> pid, const V& v);
 
@@ -57,20 +61,24 @@ protected:
 	bool _property_owner;
 };
 
-/** A variant of PropertyList that does not delete its
- *  property list in its destructor. Objects with their
- *  own Properties store them in an OwnedPropertyList
- *  to avoid having them deleted at the wrong time.
+/** Persistent Property List
+ *
+ * A variant of PropertyList that does not delete its
+ * property list in its destructor. Objects with their
+ * own Properties store them in an OwnedPropertyList
+ * to avoid having them deleted at the wrong time.
  */
 class LIBPBD_API OwnedPropertyList : public PropertyList
 {
 public:
 	OwnedPropertyList();
 
-	/* Classes that own property lists use this to add their
+	/** Add a property to the List
+	 *
+	 * Classes that own property lists use this to add their
 	 * property members to their plists. Note that it takes
-         * a reference argument rather than a pointer like
-         * one of the add() methods in PropertyList.
+	 * a reference argument rather than a pointer like
+	 * one of the add() methods in PropertyList.
 	 */
 	bool add (PropertyBase& p);
 };