 
   # Private: Flattens the given menu and submenu items into an single Array.
   #
-  # menu - A complete menu configuration object for atom-shell's menu API.
+  # * menu:
+  #   A complete menu configuration object for atom-shell's menu API.
   #
   # Returns an Array of native menu items.
   allItems: (menu=@menu) ->


  # Private: Determine the accelerator for a given command.
  #
  # command - The name of the command.
  # keystrokesByCommand - An Object where the keys are commands and the values
  #                       are Arrays containing the keystrokes.
  #
  # Returns a String containing the keystroke in a format that can be interpreted
  #   by atom shell to provide nice icons where available.

  # Note: The update menu item's must match 'Install update' exactly otherwise
  # this function will fail to work.
  #
  # * newVersion:
  #   FIXME: Unused.
  # * quitAndUpdateCallback:
  #   Function to call when the install menu item has been clicked.
  showDownloadUpdateItem: (newVersion, quitAndUpdateCallback) ->
    downloadUpdateItem = _.find @allItems(), (item) -> item.label == 'Install update'
    if downloadUpdateItem
