| blob | c3e7aade9262c0ba1a1d7212aaa0cbc7fee38215 |
4 <head>
9 /* Debug borders */
11 /*
12 border: 1px solid red;
13 */
14 }
16 body {
18 }
20 a {
23 }
26 }
28 em {
31 }
33 strong {
36 }
38 tt {
40 }
48 }
52 }
53 h2 {
55 }
56 h3 {
58 }
59 h3 + * {
61 }
66 }
68 hr {
70 }
72 p {
75 }
79 }
81 pre {
84 }
86 span#author {
91 }
92 span#email {
93 }
96 }
98 div#footer {
104 }
105 div#footer-text {
108 }
109 div#footer-badges {
112 }
114 div#preamble {
117 }
123 }
127 }
131 }
133 /* Block element titles. */
141 }
144 }
148 }
151 }
154 }
160 }
166 }
171 }
175 }
180 }
183 }
187 }
188 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
191 }
200 }
204 }
209 }
215 dl {
218 }
219 dt {
224 }
227 }
231 }
234 }
237 }
240 }
243 }
246 }
253 }
257 }
258 thead {
261 }
262 tfoot {
264 }
267 }
270 }
271 /* Because the table frame attribute is overriden by CSS in most browsers. */
274 }
278 }
282 }
288 }
291 }
294 }
300 }
303 }
307 }
311 }
315 }
317 div#toctitle {
324 }
329 }
333 }
337 }
341 }
342 /* Workarounds for IE6's broken and incomplete CSS2. */
348 }
355 }
361 }
366 }
370 }
374 }
379 }
381 /* IE6 sets dynamically generated links as visited. */
383 </style>
384 </head>
385 <body>
388 </div>
391 <div class="paragraph"><p>The graph API is used to draw a text-based representation of the commit
392 history. The API generates the graph in a line-by-line fashion.</p></div>
393 </div>
394 </div>
399 <li>
400 <p>
402 </p>
403 </li>
404 <li>
405 <p>
407 </p>
408 </li>
409 <li>
410 <p>
412 does not add a terminating newline.
413 </p>
414 </li>
415 <li>
416 <p>
421 all branch lines downwards one row, leaving their positions unchanged.
422 </p>
423 </li>
424 <li>
425 <p>
428 lines for the current commit have been printed, the next call to
430 the graph was omitted.
431 </p>
432 </li>
433 </ul></div>
434 <div class="paragraph"><p>The following utility functions are wrappers around <tt>graph_next_line()</tt> and
436 They can all be called with a NULL graph argument, in which case no graph
437 output will be printed.</p></div>
439 <li>
440 <p>
442 This prints all graph lines up to, and including, the line containing this
443 commit. Output is printed to stdout. The last line printed does not contain
444 a terminating newline. This should not be called if the commit line has
445 already been printed, or it will loop forever.
446 </p>
447 </li>
448 <li>
449 <p>
451 stdout. The line printed does not contain a terminating newline.
452 </p>
453 </li>
454 <li>
455 <p>
457 stdout. The line printed does not contain a terminating newline.
458 </p>
459 </li>
460 <li>
461 <p>
464 The last line printed does not contain a terminating newline. Returns 1 if
465 output was printed, and 0 if no output was necessary.
466 </p>
467 </li>
468 <li>
469 <p>
471 lines but the first with a graph line. The caller is responsible for
472 ensuring graph output for the first line has already been printed to stdout.
474 a NULL graph is supplied, the strbuf is printed as-is.
475 </p>
476 </li>
477 <li>
478 <p>
480 prints the remainder of the graph, if more lines are needed after the strbuf
484 end in a newline if and only if the strbuf ends in a newline.
485 </p>
486 </li>
487 </ul></div>
488 </div>
491 <div class="paragraph"><p><tt>struct git_graph</tt> is an opaque data type used to store the current graph
492 state.</p></div>
493 </div>
497 <li>
498 <p>
502 </p>
503 </li>
504 <li>
505 <p>
506 Use the revision walking API to walk through a group of contiguous commits.
508 it is invoked.
509 </p>
510 </li>
511 <li>
512 <p>
517 resulting line contains the current commit, or 0 if this is merely a line
518 needed to adjust the graph before or after the current commit. This return
519 value can be used to determine where to print the commit summary information
520 alongside the graph output.
521 </p>
522 </li>
523 </ul></div>
524 </div>
528 <li>
529 <p>
531 not be called on a commit if it has already been invoked with an ancestor of
532 that commit, or the graph output will be incorrect.
533 </p>
534 </li>
535 <li>
536 <p>
539 on all parents of that commit. Parents must not be skipped, or the graph
540 output will appear incorrect.
541 </p>
542 <div class="paragraph"><p><tt>graph_update()</tt> may be used on a pruned set of commits only if the parent list
543 has been rewritten so as to include only ancestors from the pruned set.</p></div>
544 </li>
545 <li>
546 <p>
547 The graph API does not currently support reverse commit ordering. In
548 order to implement reverse ordering, the graphing API needs an
549 (efficient) mechanism to find the children of a commit.
550 </p>
551 </li>
552 </ul></div>
553 </div>
558 <pre><tt>struct commit *commit;
559 struct git_graph *graph = graph_init(opts);
561 while ((commit = get_revision(opts)) != NULL) {
562 graph_update(graph, commit);
563 while (!graph_is_commit_finished(graph))
564 {
565 struct strbuf sb;
566 int is_commit_line;
569 is_commit_line = graph_next_line(graph, &sb);
570 fputs(sb.buf, stdout);
572 if (is_commit_line)
573 log_tree_commit(opts, commit);
574 else
575 putchar(opts->diffopt.line_termination);
576 }
577 }</tt></pre>
578 </div></div>
579 </div>
582 <div class="paragraph"><p>The following is an example of the output from the graph API. This output does
583 not include any commit summary information—callers are responsible for
584 outputting that information, if desired.</p></div>
587 <pre><tt>*
588 *
589 *
590 |\
591 * |
592 | | *
593 | \ \
594 | \ \
595 *-. \ \
596 |\ \ \ \
597 | | * | |
598 | | | | | *
599 | | | | | *
600 | | | | | *
601 | | | | | |\
602 | | | | | | *
603 | * | | | | |
604 | | | | | * \
605 | | | | | |\ |
606 | | | | * | | |
607 | | | | * | | |
608 * | | | | | | |
609 | |/ / / / / /
610 |/| / / / / /
611 * | | | | | |
612 |/ / / / / /
613 * | | | | |
614 | | | | | *
615 | | | | |/
616 | | | | *</tt></pre>
617 </div></div>
618 </div>
622 </div>
623 </div>
624 </body>
625 </html>