From efafd7fe871bc368b91db78bb132abb027141a24 Mon Sep 17 00:00:00 2001
From: Petr Vobornik <pvoborni@redhat.com>
Date: Fri, 6 Sep 2013 15:27:06 +0200
Subject: Web UI source code annotation

Part of ongoing Web UI documentation effort. Source code is annotated in a way that it can be processed by documentation generator.
---
 install/ui/src/freeipa/menu.js | 31 +++++++++++++++++++------------
 1 file changed, 19 insertions(+), 12 deletions(-)

(limited to 'install/ui/src/freeipa/menu.js')

diff --git a/install/ui/src/freeipa/menu.js b/install/ui/src/freeipa/menu.js
index c903e16d..3da64389 100644
--- a/install/ui/src/freeipa/menu.js
+++ b/install/ui/src/freeipa/menu.js
@@ -18,11 +18,7 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/**
- * Menu proxy.
- *
- * Exports public interface for dealing with menu items.
- */
+
 define([
         'dojo/_base/lang',
         './app', // creates circular dependency
@@ -36,13 +32,21 @@ define([
             return app.app.menu;
         },
 
+        /**
+        * Menu proxy.
+        *
+        * Exports public interface for dealing with menu items.
+        * @class menu
+        */
+
         /**
          * Adds menu item.
          * Takes a spec of menu item.
          * Normalizes item's name, parent, adds children if specified
          *
-         * @param {menu_item} items
-         * @param {String|menu_item} parent
+         * @method add_item
+         * @param {navigation.MenuItem} item
+         * @param {string|navigation.MenuItem} parent
          * @param {Object} options
          */
         add_item = function(item, parent, options) {
@@ -53,8 +57,8 @@ define([
         /**
          * Removes menu item
          *
-         * @param {String|menu_item} name or menu item to remove
-         *
+         * @method remove_item
+         * @param {string|navigation.MenuItem} name or menu item to remove
          */
         remove_item = function(item) {
 
@@ -66,9 +70,10 @@ define([
          * Query internal data store by using default search options or supplied
          * search options.
          *
-         * @param Object Query filter
-         * @param ?Object Search options, overrides default
-         * @return QueryResult
+         * @method query
+         * @param {Object} query
+         * @param {Object} [search_options] Search options, overrides default
+         * @return {QueryResult}
          */
         query = function(query, search_options) {
 
@@ -83,6 +88,8 @@ define([
 
         /**
          * Get current instance of menu
+         * @method get
+         * @return {navigation.Menu}
          */
         get = function() {
             return get_menu();
-- 
cgit