Merge pull request #16560 from ctrlaltdavid/DOC-237

DOC-237: DialogsManager JSDoc

interface/src/scripting/DialogsManagerScriptingInterface.h

@@ -14,19 +14,56 @@
 
 #include <QObject>
 
+/**jsdoc
+ * The <code>DialogsMamnager</code> API provides facilities to work with some key dialogs.
+ *
+ * @namespace DialogsManager
+ *
+ * @hifi-interface
+ * @hifi-client-entity
+ * @hifi-avatar
+ */
+
 class DialogsManagerScriptingInterface : public QObject {
     Q_OBJECT
 public:
     DialogsManagerScriptingInterface();
     static DialogsManagerScriptingInterface* getInstance();
+
+    /**jsdoc
+     * <em>Currently performs no action.</em>
+     * @function DialogsManager.showFeed
+     */
     Q_INVOKABLE void showFeed();
 
 public slots:
+    /**jsdoc
+     * Shows the "Goto" dialog.
+     * @function DialogsManager.showAddressBar
+     */
     void showAddressBar();
+
+    /**jsdoc
+     * Hides the "Goto" dialog.
+     * @function DialogsManager.hideAddressBar
+     */
     void hideAddressBar();
+
+    /**jsdoc
+     * Shows the login dialog.
+     * @function DialogsManager.showLoginDialog
+     */
     void showLoginDialog();
 
 signals:
+    /**jsdoc
+     * Triggered when the "Goto" dialog is opened or closed.
+     * <p><strong>Warning:</strong> Currently isn't always triggered.</p>
+     * @function DialogsManager.addressBarShown
+     * @param {boolean} visible - <code>true</code> if the Goto dialog has been opened, <code>false</code> if it has been 
+     *     closed.
+     * @returns {Signal}
+     */
     void addressBarShown(bool visible);
 };