Added some documentation

svn path=/branches/KDE4/; revision=2862

diff --git a/src/titlewidget.h b/src/titlewidget.h
index 866d737d55ca316d8ec7b023cbafc45fd171f6c7..9d7770505bc30f1b1263fc2a86eae6a52e3c2d30 100644 (file)
--- a/src/titlewidget.h
+++ b/src/titlewidget.h
@@ -45,10 +45,27 @@ class TitleWidget : public QDialog , public Ui::TitleWidget_UI {
     Q_OBJECT
 
 public:
+    /** \brief Constructor
+     * \param projectPath Path to use when user requests loading or saving of titles as .kdenlivetitle documents */
     TitleWidget(KUrl url, QString projectPath, Render *render, QWidget *parent = 0);
     QDomDocument xml();
     void setXml(QDomDocument doc);
+    
+    /** \brief Find first available filename of the form titleXXX.png in projectUrl + "/titles/" directory
+    * \param projectUrl Url to directory of project. 
+     * \returns A list, with the name in the form of "/path/to/titles/titleXXX" as the first element, the extension
+     * ".png" as the second element.
+     * 
+     * The path "/titles/" is appended to projectUrl to locate the actual directory that contains the title pngs. */
     static QStringList getFreeTitleInfo(const KUrl &projectUrl);
+    
+    /** \brief Build a filename from a projectUrl and a titleName
+     * \param projectUrl Url to directory of project.
+     * \param titleName Name of title, on the form "titleXXX"
+     * 
+     * The path "/titles/" is appended to projectUrl to build the directoryname, then .pgn is appended to
+     * get the filename. It is not checked that the title png actually exists, only the name is build and
+     * returned. */
     static QString getTitleResourceFromName(const KUrl &projectUrl, const QString &titleName);
 
 protected: