gitweb / static / gitweb.json commit i18n: git-submodule "blob" and "submodule" messages (b3e7344)
   1// Copyright (C) 2007, Fredrik Kuivinen <frekui@gmail.com>
   2//               2007, Petr Baudis <pasky@suse.cz>
   3//          2008-2009, Jakub Narebski <jnareb@gmail.com>
   4
   5/**
   6 * @fileOverview JavaScript code for gitweb (git web interface).
   7 * @license GPLv2 or later
   8 */
   9
  10/* ============================================================ */
  11/* functions for generic gitweb actions and views */
  12
  13/**
  14 * used to check if link has 'js' query parameter already (at end),
  15 * and other reasons to not add 'js=1' param at the end of link
  16 * @constant
  17 */
  18var jsExceptionsRe = /[;?]js=[01]$/;
  19
  20/**
  21 * Add '?js=1' or ';js=1' to the end of every link in the document
  22 * that doesn't have 'js' query parameter set already.
  23 *
  24 * Links with 'js=1' lead to JavaScript version of given action, if it
  25 * exists (currently there is only 'blame_incremental' for 'blame')
  26 *
  27 * @globals jsExceptionsRe
  28 */
  29function fixLinks() {
  30        var allLinks = document.getElementsByTagName("a") || document.links;
  31        for (var i = 0, len = allLinks.length; i < len; i++) {
  32                var link = allLinks[i];
  33                if (!jsExceptionsRe.test(link)) { // =~ /[;?]js=[01]$/;
  34                        link.href +=
  35                                (link.href.indexOf('?') === -1 ? '?' : ';') + 'js=1';
  36                }
  37        }
  38}
  39
  40
  41/* ============================================================ */
  42
  43/*
  44 * This code uses DOM methods instead of (nonstandard) innerHTML
  45 * to modify page.
  46 *
  47 * innerHTML is non-standard IE extension, though supported by most
  48 * browsers; however Firefox up to version 1.5 didn't implement it in
  49 * a strict mode (application/xml+xhtml mimetype).
  50 *
  51 * Also my simple benchmarks show that using elem.firstChild.data =
  52 * 'content' is slightly faster than elem.innerHTML = 'content'.  It
  53 * is however more fragile (text element fragment must exists), and
  54 * less feature-rich (we cannot add HTML).
  55 *
  56 * Note that DOM 2 HTML is preferred over generic DOM 2 Core; the
  57 * equivalent using DOM 2 Core is usually shown in comments.
  58 */
  59
  60
  61/* ============================================================ */
  62/* generic utility functions */
  63
  64
  65/**
  66 * pad number N with nonbreakable spaces on the left, to WIDTH characters
  67 * example: padLeftStr(12, 3, '\u00A0') == '\u00A012'
  68 *          ('\u00A0' is nonbreakable space)
  69 *
  70 * @param {Number|String} input: number to pad
  71 * @param {Number} width: visible width of output
  72 * @param {String} str: string to prefix to string, e.g. '\u00A0'
  73 * @returns {String} INPUT prefixed with (WIDTH - INPUT.length) x STR
  74 */
  75function padLeftStr(input, width, str) {
  76        var prefix = '';
  77
  78        width -= input.toString().length;
  79        while (width > 0) {
  80                prefix += str;
  81                width--;
  82        }
  83        return prefix + input;
  84}
  85
  86/**
  87 * Pad INPUT on the left to SIZE width, using given padding character CH,
  88 * for example padLeft('a', 3, '_') is '__a'.
  89 *
  90 * @param {String} input: input value converted to string.
  91 * @param {Number} width: desired length of output.
  92 * @param {String} ch: single character to prefix to string.
  93 *
  94 * @returns {String} Modified string, at least SIZE length.
  95 */
  96function padLeft(input, width, ch) {
  97        var s = input + "";
  98        while (s.length < width) {
  99                s = ch + s;
 100        }
 101        return s;
 102}
 103
 104/**
 105 * Create XMLHttpRequest object in cross-browser way
 106 * @returns XMLHttpRequest object, or null
 107 */
 108function createRequestObject() {
 109        try {
 110                return new XMLHttpRequest();
 111        } catch (e) {}
 112        try {
 113                return window.createRequest();
 114        } catch (e) {}
 115        try {
 116                return new ActiveXObject("Msxml2.XMLHTTP");
 117        } catch (e) {}
 118        try {
 119                return new ActiveXObject("Microsoft.XMLHTTP");
 120        } catch (e) {}
 121
 122        return null;
 123}
 124
 125
 126/* ============================================================ */
 127/* utility/helper functions (and variables) */
 128
 129var xhr;        // XMLHttpRequest object
 130var projectUrl; // partial query + separator ('?' or ';')
 131
 132// 'commits' is an associative map. It maps SHA1s to Commit objects.
 133var commits = {};
 134
 135/**
 136 * constructor for Commit objects, used in 'blame'
 137 * @class Represents a blamed commit
 138 * @param {String} sha1: SHA-1 identifier of a commit
 139 */
 140function Commit(sha1) {
 141        if (this instanceof Commit) {
 142                this.sha1 = sha1;
 143                this.nprevious = 0; /* number of 'previous', effective parents */
 144        } else {
 145                return new Commit(sha1);
 146        }
 147}
 148
 149/* ............................................................ */
 150/* progress info, timing, error reporting */
 151
 152var blamedLines = 0;
 153var totalLines  = '???';
 154var div_progress_bar;
 155var div_progress_info;
 156
 157/**
 158 * Detects how many lines does a blamed file have,
 159 * This information is used in progress info
 160 *
 161 * @returns {Number|String} Number of lines in file, or string '...'
 162 */
 163function countLines() {
 164        var table =
 165                document.getElementById('blame_table') ||
 166                document.getElementsByTagName('table')[0];
 167
 168        if (table) {
 169                return table.getElementsByTagName('tr').length - 1; // for header
 170        } else {
 171                return '...';
 172        }
 173}
 174
 175/**
 176 * update progress info and length (width) of progress bar
 177 *
 178 * @globals div_progress_info, div_progress_bar, blamedLines, totalLines
 179 */
 180function updateProgressInfo() {
 181        if (!div_progress_info) {
 182                div_progress_info = document.getElementById('progress_info');
 183        }
 184        if (!div_progress_bar) {
 185                div_progress_bar = document.getElementById('progress_bar');
 186        }
 187        if (!div_progress_info && !div_progress_bar) {
 188                return;
 189        }
 190
 191        var percentage = Math.floor(100.0*blamedLines/totalLines);
 192
 193        if (div_progress_info) {
 194                div_progress_info.firstChild.data  = blamedLines + ' / ' + totalLines +
 195                        ' (' + padLeftStr(percentage, 3, '\u00A0') + '%)';
 196        }
 197
 198        if (div_progress_bar) {
 199                //div_progress_bar.setAttribute('style', 'width: '+percentage+'%;');
 200                div_progress_bar.style.width = percentage + '%';
 201        }
 202}
 203
 204
 205var t_interval_server = '';
 206var cmds_server = '';
 207var t0 = new Date();
 208
 209/**
 210 * write how much it took to generate data, and to run script
 211 *
 212 * @globals t0, t_interval_server, cmds_server
 213 */
 214function writeTimeInterval() {
 215        var info_time = document.getElementById('generating_time');
 216        if (!info_time || !t_interval_server) {
 217                return;
 218        }
 219        var t1 = new Date();
 220        info_time.firstChild.data += ' + (' +
 221                t_interval_server + ' sec server blame_data / ' +
 222                (t1.getTime() - t0.getTime())/1000 + ' sec client JavaScript)';
 223
 224        var info_cmds = document.getElementById('generating_cmd');
 225        if (!info_time || !cmds_server) {
 226                return;
 227        }
 228        info_cmds.firstChild.data += ' + ' + cmds_server;
 229}
 230
 231/**
 232 * show an error message alert to user within page (in prohress info area)
 233 * @param {String} str: plain text error message (no HTML)
 234 *
 235 * @globals div_progress_info
 236 */
 237function errorInfo(str) {
 238        if (!div_progress_info) {
 239                div_progress_info = document.getElementById('progress_info');
 240        }
 241        if (div_progress_info) {
 242                div_progress_info.className = 'error';
 243                div_progress_info.firstChild.data = str;
 244        }
 245}
 246
 247/* ............................................................ */
 248/* coloring rows during blame_data (git blame --incremental) run */
 249
 250/**
 251 * used to extract N from 'colorN', where N is a number,
 252 * @constant
 253 */
 254var colorRe = /\bcolor([0-9]*)\b/;
 255
 256/**
 257 * return N if <tr class="colorN">, otherwise return null
 258 * (some browsers require CSS class names to begin with letter)
 259 *
 260 * @param {HTMLElement} tr: table row element to check
 261 * @param {String} tr.className: 'class' attribute of tr element
 262 * @returns {Number|null} N if tr.className == 'colorN', otherwise null
 263 *
 264 * @globals colorRe
 265 */
 266function getColorNo(tr) {
 267        if (!tr) {
 268                return null;
 269        }
 270        var className = tr.className;
 271        if (className) {
 272                var match = colorRe.exec(className);
 273                if (match) {
 274                        return parseInt(match[1], 10);
 275                }
 276        }
 277        return null;
 278}
 279
 280var colorsFreq = [0, 0, 0];
 281/**
 282 * return one of given possible colors (curently least used one)
 283 * example: chooseColorNoFrom(2, 3) returns 2 or 3
 284 *
 285 * @param {Number[]} arguments: one or more numbers
 286 *        assumes that  1 <= arguments[i] <= colorsFreq.length
 287 * @returns {Number} Least used color number from arguments
 288 * @globals colorsFreq
 289 */
 290function chooseColorNoFrom() {
 291        // choose the color which is least used
 292        var colorNo = arguments[0];
 293        for (var i = 1; i < arguments.length; i++) {
 294                if (colorsFreq[arguments[i]-1] < colorsFreq[colorNo-1]) {
 295                        colorNo = arguments[i];
 296                }
 297        }
 298        colorsFreq[colorNo-1]++;
 299        return colorNo;
 300}
 301
 302/**
 303 * given two neigbour <tr> elements, find color which would be different
 304 * from color of both of neighbours; used to 3-color blame table
 305 *
 306 * @param {HTMLElement} tr_prev
 307 * @param {HTMLElement} tr_next
 308 * @returns {Number} color number N such that
 309 * colorN != tr_prev.className && colorN != tr_next.className
 310 */
 311function findColorNo(tr_prev, tr_next) {
 312        var color_prev = getColorNo(tr_prev);
 313        var color_next = getColorNo(tr_next);
 314
 315
 316        // neither of neighbours has color set
 317        // THEN we can use any of 3 possible colors
 318        if (!color_prev && !color_next) {
 319                return chooseColorNoFrom(1,2,3);
 320        }
 321
 322        // either both neighbours have the same color,
 323        // or only one of neighbours have color set
 324        // THEN we can use any color except given
 325        var color;
 326        if (color_prev === color_next) {
 327                color = color_prev; // = color_next;
 328        } else if (!color_prev) {
 329                color = color_next;
 330        } else if (!color_next) {
 331                color = color_prev;
 332        }
 333        if (color) {
 334                return chooseColorNoFrom((color % 3) + 1, ((color+1) % 3) + 1);
 335        }
 336
 337        // neighbours have different colors
 338        // THEN there is only one color left
 339        return (3 - ((color_prev + color_next) % 3));
 340}
 341
 342/* ............................................................ */
 343/* coloring rows like 'blame' after 'blame_data' finishes */
 344
 345/**
 346 * returns true if given row element (tr) is first in commit group
 347 * to be used only after 'blame_data' finishes (after processing)
 348 *
 349 * @param {HTMLElement} tr: table row
 350 * @returns {Boolean} true if TR is first in commit group
 351 */
 352function isStartOfGroup(tr) {
 353        return tr.firstChild.className === 'sha1';
 354}
 355
 356/**
 357 * change colors to use zebra coloring (2 colors) instead of 3 colors
 358 * concatenate neighbour commit groups belonging to the same commit
 359 *
 360 * @globals colorRe
 361 */
 362function fixColorsAndGroups() {
 363        var colorClasses = ['light', 'dark'];
 364        var linenum = 1;
 365        var tr, prev_group;
 366        var colorClass = 0;
 367        var table =
 368                document.getElementById('blame_table') ||
 369                document.getElementsByTagName('table')[0];
 370
 371        while ((tr = document.getElementById('l'+linenum))) {
 372        // index origin is 0, which is table header; start from 1
 373        //while ((tr = table.rows[linenum])) { // <- it is slower
 374                if (isStartOfGroup(tr, linenum, document)) {
 375                        if (prev_group &&
 376                            prev_group.firstChild.firstChild.href ===
 377                                    tr.firstChild.firstChild.href) {
 378                                // we have to concatenate groups
 379                                var prev_rows = prev_group.firstChild.rowSpan || 1;
 380                                var curr_rows =         tr.firstChild.rowSpan || 1;
 381                                prev_group.firstChild.rowSpan = prev_rows + curr_rows;
 382                                //tr.removeChild(tr.firstChild);
 383                                tr.deleteCell(0); // DOM2 HTML way
 384                        } else {
 385                                colorClass = (colorClass + 1) % 2;
 386                                prev_group = tr;
 387                        }
 388                }
 389                var tr_class = tr.className;
 390                tr.className = tr_class.replace(colorRe, colorClasses[colorClass]);
 391                linenum++;
 392        }
 393}
 394
 395/* ............................................................ */
 396/* time and data */
 397
 398/**
 399 * used to extract hours and minutes from timezone info, e.g '-0900'
 400 * @constant
 401 */
 402var tzRe = /^([+-])([0-9][0-9])([0-9][0-9])$/;
 403
 404/**
 405 * convert numeric timezone +/-ZZZZ to offset from UTC in seconds
 406 *
 407 * @param {String} timezoneInfo: numeric timezone '(+|-)HHMM'
 408 * @returns {Number} offset from UTC in seconds for timezone
 409 *
 410 * @globals tzRe
 411 */
 412function timezoneOffset(timezoneInfo) {
 413        var match = tzRe.exec(timezoneInfo);
 414        var tz_sign = (match[1] === '-' ? -1 : +1);
 415        var tz_hour = parseInt(match[2],10);
 416        var tz_min  = parseInt(match[3],10);
 417
 418        return tz_sign*(((tz_hour*60) + tz_min)*60);
 419}
 420
 421/**
 422 * return date in local time formatted in iso-8601 like format
 423 * 'yyyy-mm-dd HH:MM:SS +/-ZZZZ' e.g. '2005-08-07 21:49:46 +0200'
 424 *
 425 * @param {Number} epoch: seconds since '00:00:00 1970-01-01 UTC'
 426 * @param {String} timezoneInfo: numeric timezone '(+|-)HHMM'
 427 * @returns {String} date in local time in iso-8601 like format
 428 */
 429function formatDateISOLocal(epoch, timezoneInfo) {
 430        // date corrected by timezone
 431        var localDate = new Date(1000 * (epoch +
 432                timezoneOffset(timezoneInfo)));
 433        var localDateStr = // e.g. '2005-08-07'
 434                localDate.getUTCFullYear()                 + '-' +
 435                padLeft(localDate.getUTCMonth()+1, 2, '0') + '-' +
 436                padLeft(localDate.getUTCDate(),    2, '0');
 437        var localTimeStr = // e.g. '21:49:46'
 438                padLeft(localDate.getUTCHours(),   2, '0') + ':' +
 439                padLeft(localDate.getUTCMinutes(), 2, '0') + ':' +
 440                padLeft(localDate.getUTCSeconds(), 2, '0');
 441
 442        return localDateStr + ' ' + localTimeStr + ' ' + timezoneInfo;
 443}
 444
 445/* ............................................................ */
 446/* unquoting/unescaping filenames */
 447
 448/**#@+
 449 * @constant
 450 */
 451var escCodeRe = /\\([^0-7]|[0-7]{1,3})/g;
 452var octEscRe = /^[0-7]{1,3}$/;
 453var maybeQuotedRe = /^\"(.*)\"$/;
 454/**#@-*/
 455
 456/**
 457 * unquote maybe git-quoted filename
 458 * e.g. 'aa' -> 'aa', '"a\ta"' -> 'a    a'
 459 *
 460 * @param {String} str: git-quoted string
 461 * @returns {String} Unquoted and unescaped string
 462 *
 463 * @globals escCodeRe, octEscRe, maybeQuotedRe
 464 */
 465function unquote(str) {
 466        function unq(seq) {
 467                var es = {
 468                        // character escape codes, aka escape sequences (from C)
 469                        // replacements are to some extent JavaScript specific
 470                        t: "\t",   // tab            (HT, TAB)
 471                        n: "\n",   // newline        (NL)
 472                        r: "\r",   // return         (CR)
 473                        f: "\f",   // form feed      (FF)
 474                        b: "\b",   // backspace      (BS)
 475                        a: "\x07", // alarm (bell)   (BEL)
 476                        e: "\x1B", // escape         (ESC)
 477                        v: "\v"    // vertical tab   (VT)
 478                };
 479
 480                if (seq.search(octEscRe) !== -1) {
 481                        // octal char sequence
 482                        return String.fromCharCode(parseInt(seq, 8));
 483                } else if (seq in es) {
 484                        // C escape sequence, aka character escape code
 485                        return es[seq];
 486                }
 487                // quoted ordinary character
 488                return seq;
 489        }
 490
 491        var match = str.match(maybeQuotedRe);
 492        if (match) {
 493                str = match[1];
 494                // perhaps str = eval('"'+str+'"'); would be enough?
 495                str = str.replace(escCodeRe,
 496                        function (substr, p1, offset, s) { return unq(p1); });
 497        }
 498        return str;
 499}
 500
 501/* ============================================================ */
 502/* main part: parsing response */
 503
 504/**
 505 * Function called for each blame entry, as soon as it finishes.
 506 * It updates page via DOM manipulation, adding sha1 info, etc.
 507 *
 508 * @param {Commit} commit: blamed commit
 509 * @param {Object} group: object representing group of lines,
 510 *                        which blame the same commit (blame entry)
 511 *
 512 * @globals blamedLines
 513 */
 514function handleLine(commit, group) {
 515        /*
 516           This is the structure of the HTML fragment we are working
 517           with:
 518
 519           <tr id="l123" class="">
 520             <td class="sha1" title=""><a href=""> </a></td>
 521             <td class="linenr"><a class="linenr" href="">123</a></td>
 522             <td class="pre"># times (my ext3 doesn&#39;t).</td>
 523           </tr>
 524        */
 525
 526        var resline = group.resline;
 527
 528        // format date and time string only once per commit
 529        if (!commit.info) {
 530                /* e.g. 'Kay Sievers, 2005-08-07 21:49:46 +0200' */
 531                commit.info = commit.author + ', ' +
 532                        formatDateISOLocal(commit.authorTime, commit.authorTimezone);
 533        }
 534
 535        // color depends on group of lines, not only on blamed commit
 536        var colorNo = findColorNo(
 537                document.getElementById('l'+(resline-1)),
 538                document.getElementById('l'+(resline+group.numlines))
 539        );
 540
 541        // loop over lines in commit group
 542        for (var i = 0; i < group.numlines; i++, resline++) {
 543                var tr = document.getElementById('l'+resline);
 544                if (!tr) {
 545                        break;
 546                }
 547                /*
 548                        <tr id="l123" class="">
 549                          <td class="sha1" title=""><a href=""> </a></td>
 550                          <td class="linenr"><a class="linenr" href="">123</a></td>
 551                          <td class="pre"># times (my ext3 doesn&#39;t).</td>
 552                        </tr>
 553                */
 554                var td_sha1  = tr.firstChild;
 555                var a_sha1   = td_sha1.firstChild;
 556                var a_linenr = td_sha1.nextSibling.firstChild;
 557
 558                /* <tr id="l123" class=""> */
 559                var tr_class = '';
 560                if (colorNo !== null) {
 561                        tr_class = 'color'+colorNo;
 562                }
 563                if (commit.boundary) {
 564                        tr_class += ' boundary';
 565                }
 566                if (commit.nprevious === 0) {
 567                        tr_class += ' no-previous';
 568                } else if (commit.nprevious > 1) {
 569                        tr_class += ' multiple-previous';
 570                }
 571                tr.className = tr_class;
 572
 573                /* <td class="sha1" title="?" rowspan="?"><a href="?">?</a></td> */
 574                if (i === 0) {
 575                        td_sha1.title = commit.info;
 576                        td_sha1.rowSpan = group.numlines;
 577
 578                        a_sha1.href = projectUrl + 'a=commit;h=' + commit.sha1;
 579                        if (a_sha1.firstChild) {
 580                                a_sha1.firstChild.data = commit.sha1.substr(0, 8);
 581                        } else {
 582                                a_sha1.appendChild(
 583                                        document.createTextNode(commit.sha1.substr(0, 8)));
 584                        }
 585                        if (group.numlines >= 2) {
 586                                var fragment = document.createDocumentFragment();
 587                                var br   = document.createElement("br");
 588                                var match = commit.author.match(/\b([A-Z])\B/g);
 589                                if (match) {
 590                                        var text = document.createTextNode(
 591                                                        match.join(''));
 592                                }
 593                                if (br && text) {
 594                                        var elem = fragment || td_sha1;
 595                                        elem.appendChild(br);
 596                                        elem.appendChild(text);
 597                                        if (fragment) {
 598                                                td_sha1.appendChild(fragment);
 599                                        }
 600                                }
 601                        }
 602                } else {
 603                        //tr.removeChild(td_sha1); // DOM2 Core way
 604                        tr.deleteCell(0); // DOM2 HTML way
 605                }
 606
 607                /* <td class="linenr"><a class="linenr" href="?">123</a></td> */
 608                var linenr_commit =
 609                        ('previous' in commit ? commit.previous : commit.sha1);
 610                var linenr_filename =
 611                        ('file_parent' in commit ? commit.file_parent : commit.filename);
 612                a_linenr.href = projectUrl + 'a=blame_incremental' +
 613                        ';hb=' + linenr_commit +
 614                        ';f='  + encodeURIComponent(linenr_filename) +
 615                        '#l' + (group.srcline + i);
 616
 617                blamedLines++;
 618
 619                //updateProgressInfo();
 620        }
 621}
 622
 623// ----------------------------------------------------------------------
 624
 625var inProgress = false;   // are we processing response
 626
 627/**#@+
 628 * @constant
 629 */
 630var sha1Re = /^([0-9a-f]{40}) ([0-9]+) ([0-9]+) ([0-9]+)/;
 631var infoRe = /^([a-z-]+) ?(.*)/;
 632var endRe  = /^END ?([^ ]*) ?(.*)/;
 633/**@-*/
 634
 635var curCommit = new Commit();
 636var curGroup  = {};
 637
 638var pollTimer = null;
 639
 640/**
 641 * Parse output from 'git blame --incremental [...]', received via
 642 * XMLHttpRequest from server (blamedataUrl), and call handleLine
 643 * (which updates page) as soon as blame entry is completed.
 644 *
 645 * @param {String[]} lines: new complete lines from blamedata server
 646 *
 647 * @globals commits, curCommit, curGroup, t_interval_server, cmds_server
 648 * @globals sha1Re, infoRe, endRe
 649 */
 650function processBlameLines(lines) {
 651        var match;
 652
 653        for (var i = 0, len = lines.length; i < len; i++) {
 654
 655                if ((match = sha1Re.exec(lines[i]))) {
 656                        var sha1 = match[1];
 657                        var srcline  = parseInt(match[2], 10);
 658                        var resline  = parseInt(match[3], 10);
 659                        var numlines = parseInt(match[4], 10);
 660
 661                        var c = commits[sha1];
 662                        if (!c) {
 663                                c = new Commit(sha1);
 664                                commits[sha1] = c;
 665                        }
 666                        curCommit = c;
 667
 668                        curGroup.srcline = srcline;
 669                        curGroup.resline = resline;
 670                        curGroup.numlines = numlines;
 671
 672                } else if ((match = infoRe.exec(lines[i]))) {
 673                        var info = match[1];
 674                        var data = match[2];
 675                        switch (info) {
 676                        case 'filename':
 677                                curCommit.filename = unquote(data);
 678                                // 'filename' information terminates the entry
 679                                handleLine(curCommit, curGroup);
 680                                updateProgressInfo();
 681                                break;
 682                        case 'author':
 683                                curCommit.author = data;
 684                                break;
 685                        case 'author-time':
 686                                curCommit.authorTime = parseInt(data, 10);
 687                                break;
 688                        case 'author-tz':
 689                                curCommit.authorTimezone = data;
 690                                break;
 691                        case 'previous':
 692                                curCommit.nprevious++;
 693                                // store only first 'previous' header
 694                                if (!'previous' in curCommit) {
 695                                        var parts = data.split(' ', 2);
 696                                        curCommit.previous    = parts[0];
 697                                        curCommit.file_parent = unquote(parts[1]);
 698                                }
 699                                break;
 700                        case 'boundary':
 701                                curCommit.boundary = true;
 702                                break;
 703                        } // end switch
 704
 705                } else if ((match = endRe.exec(lines[i]))) {
 706                        t_interval_server = match[1];
 707                        cmds_server = match[2];
 708
 709                } else if (lines[i] !== '') {
 710                        // malformed line
 711
 712                } // end if (match)
 713
 714        } // end for (lines)
 715}
 716
 717/**
 718 * Process new data and return pointer to end of processed part
 719 *
 720 * @param {String} unprocessed: new data (from nextReadPos)
 721 * @param {Number} nextReadPos: end of last processed data
 722 * @return {Number} end of processed data (new value for nextReadPos)
 723 */
 724function processData(unprocessed, nextReadPos) {
 725        var lastLineEnd = unprocessed.lastIndexOf('\n');
 726        if (lastLineEnd !== -1) {
 727                var lines = unprocessed.substring(0, lastLineEnd).split('\n');
 728                nextReadPos += lastLineEnd + 1 /* 1 == '\n'.length */;
 729
 730                processBlameLines(lines);
 731        } // end if
 732
 733        return nextReadPos;
 734}
 735
 736/**
 737 * Handle XMLHttpRequest errors
 738 *
 739 * @param {XMLHttpRequest} xhr: XMLHttpRequest object
 740 *
 741 * @globals pollTimer, commits, inProgress
 742 */
 743function handleError(xhr) {
 744        errorInfo('Server error: ' +
 745                xhr.status + ' - ' + (xhr.statusText || 'Error contacting server'));
 746
 747        clearInterval(pollTimer);
 748        commits = {}; // free memory
 749
 750        inProgress = false;
 751}
 752
 753/**
 754 * Called after XMLHttpRequest finishes (loads)
 755 *
 756 * @param {XMLHttpRequest} xhr: XMLHttpRequest object (unused)
 757 *
 758 * @globals pollTimer, commits, inProgress
 759 */
 760function responseLoaded(xhr) {
 761        clearInterval(pollTimer);
 762
 763        fixColorsAndGroups();
 764        writeTimeInterval();
 765        commits = {}; // free memory
 766
 767        inProgress = false;
 768}
 769
 770/**
 771 * handler for XMLHttpRequest onreadystatechange event
 772 * @see startBlame
 773 *
 774 * @globals xhr, inProgress
 775 */
 776function handleResponse() {
 777
 778        /*
 779         * xhr.readyState
 780         *
 781         *  Value  Constant (W3C)    Description
 782         *  -------------------------------------------------------------------
 783         *  0      UNSENT            open() has not been called yet.
 784         *  1      OPENED            send() has not been called yet.
 785         *  2      HEADERS_RECEIVED  send() has been called, and headers
 786         *                           and status are available.
 787         *  3      LOADING           Downloading; responseText holds partial data.
 788         *  4      DONE              The operation is complete.
 789         */
 790
 791        if (xhr.readyState !== 4 && xhr.readyState !== 3) {
 792                return;
 793        }
 794
 795        // the server returned error
 796        // try ... catch block is to work around bug in IE8
 797        try {
 798                if (xhr.readyState === 3 && xhr.status !== 200) {
 799                        return;
 800                }
 801        } catch (e) {
 802                return;
 803        }
 804        if (xhr.readyState === 4 && xhr.status !== 200) {
 805                handleError(xhr);
 806                return;
 807        }
 808
 809        // In konqueror xhr.responseText is sometimes null here...
 810        if (xhr.responseText === null) {
 811                return;
 812        }
 813
 814        // in case we were called before finished processing
 815        if (inProgress) {
 816                return;
 817        } else {
 818                inProgress = true;
 819        }
 820
 821        // extract new whole (complete) lines, and process them
 822        while (xhr.prevDataLength !== xhr.responseText.length) {
 823                if (xhr.readyState === 4 &&
 824                    xhr.prevDataLength === xhr.responseText.length) {
 825                        break;
 826                }
 827
 828                xhr.prevDataLength = xhr.responseText.length;
 829                var unprocessed = xhr.responseText.substring(xhr.nextReadPos);
 830                xhr.nextReadPos = processData(unprocessed, xhr.nextReadPos);
 831        } // end while
 832
 833        // did we finish work?
 834        if (xhr.readyState === 4 &&
 835            xhr.prevDataLength === xhr.responseText.length) {
 836                responseLoaded(xhr);
 837        }
 838
 839        inProgress = false;
 840}
 841
 842// ============================================================
 843// ------------------------------------------------------------
 844
 845/**
 846 * Incrementally update line data in blame_incremental view in gitweb.
 847 *
 848 * @param {String} blamedataUrl: URL to server script generating blame data.
 849 * @param {String} bUrl: partial URL to project, used to generate links.
 850 *
 851 * Called from 'blame_incremental' view after loading table with
 852 * file contents, a base for blame view.
 853 *
 854 * @globals xhr, t0, projectUrl, div_progress_bar, totalLines, pollTimer
 855*/
 856function startBlame(blamedataUrl, bUrl) {
 857
 858        xhr = createRequestObject();
 859        if (!xhr) {
 860                errorInfo('ERROR: XMLHttpRequest not supported');
 861                return;
 862        }
 863
 864        t0 = new Date();
 865        projectUrl = bUrl + (bUrl.indexOf('?') === -1 ? '?' : ';');
 866        if ((div_progress_bar = document.getElementById('progress_bar'))) {
 867                //div_progress_bar.setAttribute('style', 'width: 100%;');
 868                div_progress_bar.style.cssText = 'width: 100%;';
 869        }
 870        totalLines = countLines();
 871        updateProgressInfo();
 872
 873        /* add extra properties to xhr object to help processing response */
 874        xhr.prevDataLength = -1;  // used to detect if we have new data
 875        xhr.nextReadPos = 0;      // where unread part of response starts
 876
 877        xhr.onreadystatechange = handleResponse;
 878        //xhr.onreadystatechange = function () { handleResponse(xhr); };
 879
 880        xhr.open('GET', blamedataUrl);
 881        xhr.setRequestHeader('Accept', 'text/plain');
 882        xhr.send(null);
 883
 884        // not all browsers call onreadystatechange event on each server flush
 885        // poll response using timer every second to handle this issue
 886        pollTimer = setInterval(xhr.onreadystatechange, 1000);
 887}
 888
 889// end of gitweb.js