cleaned up the documentation a bit

panels/histogram/module.js

@@ -108,11 +108,17 @@ angular.module('kibana.histogram', [])
     $scope.panel.interval = interval || '10m';
     $scope.panel.interval = interval || '10m';
     return $scope.panel.interval;
     return $scope.panel.interval;
   };
   };
+
   /**
   /**
    * Fetch the data for a chunk of a queries results. Multiple segments occur when several indicies
    * Fetch the data for a chunk of a queries results. Multiple segments occur when several indicies
    * need to be consulted (like timestamped logstash indicies)
    * need to be consulted (like timestamped logstash indicies)
-   * @param  number   segment   The segment count, (0 based)
-   * @param  number   query_id  The id of the query, generated on the first run and passed back when
+   *
+   * The results of this function are stored on the scope's data property. This property will be an
+   * array of objects with the properties info, time_series, and hits. These objects are used in the
+   * render_panel function to create the historgram.
+   *
+   * @param {number} segment   The segment count, (0 based)
+   * @param {number} query_id  The id of the query, generated on the first run and passed back when
    *                            this call is made recursively for more segments
    *                            this call is made recursively for more segments
    */
    */
   $scope.get_data = function(segment, query_id) {
   $scope.get_data = function(segment, query_id) {
@@ -469,16 +475,16 @@ angular.module('kibana.histogram', [])
    * Certain graphs require 0 entries to be specified for them to render
    * Certain graphs require 0 entries to be specified for them to render
    * properly (like the line graph). So with this we will caluclate all of
    * properly (like the line graph). So with this we will caluclate all of
    * the expected time measurements, and fill the missing ones in with 0
    * the expected time measurements, and fill the missing ones in with 0
-   * @param object  opts  An object specifying some/all of the options
+   * @param {object} opts  An object specifying some/all of the options
    *
    *
    * OPTIONS:
    * OPTIONS:
-   * @opt string  interval    The interval notion describing the expected spacing between
+   * @opt   {string}   interval    The interval notion describing the expected spacing between
    *                                each data point.
    *                                each data point.
-   * @opt date    start_date  (optional) The start point for the time series, setting this and the
+   * @opt   {date}     start_date  (optional) The start point for the time series, setting this and the
    *                                end_date will ensure that the series streches to resemble the entire
    *                                end_date will ensure that the series streches to resemble the entire
    *                                expected result
    *                                expected result
-   * @opt date    end_date    (optional) The end point for the time series, see start_date
-   * @opt string  fill_style  Either "minimal", or "all" describing the strategy used to zero-fill
+   * @opt   {date}     end_date    (optional) The end point for the time series, see start_date
+   * @opt   {string}   fill_style  Either "minimal", or "all" describing the strategy used to zero-fill
    *                                the series.
    *                                the series.
    */
    */
   this.ZeroFilled = function (opts) {
   this.ZeroFilled = function (opts) {