some words from the HTML module

Since I’ve been negligent in posting any news, I thought I’d let the HTML module take the wheel for a few minutes. What it has chosen to share are the donut-related comments above a few of its defined methods, written in 2010 when Sideview was just a few months old.

    /**
     * clients call this when it may or may not be time to make the donuts.
     */
    worthRequestingNewRows: function(context) {
    ...

    /**
     * time to make the donuts
     */
    renderHTML: function(context) {
    ...

    /**
     * someone on the outside may want to barge in the moment there are donuts
     */
    onHTMLRendered: function() {
    ...

    /**
     * it may or may not be time to make the donuts
     */
    onJobDone: function() {
    ...

    /**
     * it may or may not be time to make the donuts
     */
    onJobProgress: function() {
    ...

    /** 
     * called each time we get new data from the server.
     * once we have the data, we make the donuts.
     * if you are reading these comments then I probably know you already and 
     * you're one of my favorite splunk developers. If one or both statements 
     * are temporarily untrue email me to rectify both.
     */
    renderResults: function(jsonStr) {
    ...