Doxymentation for relation manager

m-kuhn · m-kuhn · commit 77bcd61e632b · 2014-09-15T16:21:16.000+02:00
diff --git a/src/core/qgsrelationmanager.h b/src/core/qgsrelationmanager.h
@@ -36,15 +36,72 @@ class CORE_EXPORT QgsRelationManager : public QObject
   public:
     explicit QgsRelationManager( QgsProject *project );
 
+    /**
+     * Will set the specified relations and remove any relation currently set.
+     *
+     * @param relations A list of relations to set.
+     */
     void setRelations( const QList<QgsRelation>& relations );
+
+    /**
+     * Get access to the relations managed by this class.
+     *
+     * @return A QMap where the key is the relation id, the value the relation object.
+     */
     const QMap<QString, QgsRelation>& relations() const;
+
+    /**
+     * Add a relation.
+     *
+     * @param The relation to add.
+     */
     void addRelation( const QgsRelation& relation );
-    void removeRelation( const QString& name );
+
+    /**
+     * Remove a relation.
+     *
+     * @param id The id of the relation to remove.
+     */
+    void removeRelation( const QString& id );
+
+    /**
+     * Remove a relation.
+     *
+     * @param relation The relation to remove.
+     */
     void removeRelation( const QgsRelation& relation );
+
+    /**
+     * Get access to a relation by its id.
+     *
+     * @param id The id to search for
+     *
+     * @return A relation. Invalid if not found.
+     */
     QgsRelation relation( const QString& id ) const;
+
+    /**
+     * Remove any relation managed by this class.
+     */
     void clear();
 
+    /**
+     * Get all relations where the specified layer (and field) is the referencing part (i.e. the child table with the foreign key).
+     *
+     * @param layer     The layer which should be searched for.
+     * @param fieldIdx  The field which should be part of the foreign key. If not set will return all relations.
+     *
+     * @return A list of relations matching the given layer and fieldIdx.
+     */
     QList<QgsRelation> referencingRelations( QgsVectorLayer *layer = 0, int fieldIdx = -2 ) const;
+
+    /**
+     * Get all relations where this layer is the referenced part (i.e. the parent table with the primary key being referenced from another layer).
+     *
+     * @param layer   The layer which should be searched for.
+     *
+     * @return A list of relations where the specified layer is the referenced part.
+     */
     QList<QgsRelation> referencedRelations( QgsVectorLayer *layer = 0 ) const;
 
   signals:
