Documentation/guilt-add.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
   2     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
   4 <head>
   5 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
   6 <meta name="generator" content="AsciiDoc 8.6.4" />
   7 <title>guilt-add(1)</title>
   8 <style type="text/css">
   9 /* Sans-serif font. */
  10 h1, h2, h3, h4, h5, h6,
  11 div.title, caption.title,
  12 thead, p.table.header,
  13 div#toctitle,
  14 span#author, span#revnumber, span#revdate, span#revremark,
  15 div#footer {
  16   font-family: Arial,Helvetica,sans-serif;
  17 }
  18
  19 /* Serif font. */
  20 div.sectionbody {
  21   font-family: Georgia,"Times New Roman",Times,serif;
  22 }
  23
  24 /* Monospace font. */
  25 tt {
  26   font-size: inherit;
  27 }
  28
  29 body {
  30   margin: 1em 5% 1em 5%;
  31 }
  32
  33 a {
  34   color: blue;
  35   text-decoration: underline;
  36 }
  37 a:visited {
  38   color: fuchsia;
  39 }
  40
  41 em {
  42   font-style: italic;
  43   color: navy;
  44 }
  45
  46 strong {
  47   font-weight: bold;
  48   color: #083194;
  49 }
  50
  51 tt {
  52   font-size: inherit;
  53   color: navy;
  54 }
  55
  56 h1, h2, h3, h4, h5, h6 {
  57   color: #527bbd;
  58   margin-top: 1.2em;
  59   margin-bottom: 0.5em;
  60   line-height: 1.3;
  61 }
  62
  63 h1, h2, h3 {
  64   border-bottom: 2px solid silver;
  65 }
  66 h2 {
  67   padding-top: 0.5em;
  68 }
  69 h3 {
  70   float: left;
  71 }
  72 h3 + * {
  73   clear: left;
  74 }
  75
  76 div.sectionbody {
  77   margin-left: 0;
  78 }
  79
  80 hr {
  81   border: 1px solid silver;
  82 }
  83
  84 p {
  85   margin-top: 0.5em;
  86   margin-bottom: 0.5em;
  87 }
  88
  89 ul, ol, li > p {
  90   margin-top: 0;
  91 }
  92 ul > li     { color: #aaa; }
  93 ul > li > * { color: black; }
  94
  95 pre {
  96   padding: 0;
  97   margin: 0;
  98 }
  99
 100 span#author {
 101   color: #527bbd;
 102   font-weight: bold;
 103   font-size: 1.1em;
 104 }
 105 span#email {
 106 }
 107 span#revnumber, span#revdate, span#revremark {
 108 }
 109
 110 div#footer {
 111   font-size: small;
 112   border-top: 2px solid silver;
 113   padding-top: 0.5em;
 114   margin-top: 4.0em;
 115 }
 116 div#footer-text {
 117   float: left;
 118   padding-bottom: 0.5em;
 119 }
 120 div#footer-badges {
 121   float: right;
 122   padding-bottom: 0.5em;
 123 }
 124
 125 div#preamble {
 126   margin-top: 1.5em;
 127   margin-bottom: 1.5em;
 128 }
 129 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
 130 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
 131 div.admonitionblock {
 132   margin-top: 1.0em;
 133   margin-bottom: 1.5em;
 134 }
 135 div.admonitionblock {
 136   margin-top: 2.0em;
 137   margin-bottom: 2.0em;
 138   margin-right: 10%;
 139   color: #606060;
 140 }
 141
 142 div.content { /* Block element content. */
 143   padding: 0;
 144 }
 145
 146 /* Block element titles. */
 147 div.title, caption.title {
 148   color: #527bbd;
 149   font-weight: bold;
 150   text-align: left;
 151   margin-top: 1.0em;
 152   margin-bottom: 0.5em;
 153 }
 154 div.title + * {
 155   margin-top: 0;
 156 }
 157
 158 td div.title:first-child {
 159   margin-top: 0.0em;
 160 }
 161 div.content div.title:first-child {
 162   margin-top: 0.0em;
 163 }
 164 div.content + div.title {
 165   margin-top: 0.0em;
 166 }
 167
 168 div.sidebarblock > div.content {
 169   background: #ffffee;
 170   border: 1px solid #dddddd;
 171   border-left: 4px solid #f0f0f0;
 172   padding: 0.5em;
 173 }
 174
 175 div.listingblock > div.content {
 176   border: 1px solid #dddddd;
 177   border-left: 5px solid #f0f0f0;
 178   background: #f8f8f8;
 179   padding: 0.5em;
 180 }
 181
 182 div.quoteblock, div.verseblock {
 183   padding-left: 1.0em;
 184   margin-left: 1.0em;
 185   margin-right: 10%;
 186   border-left: 5px solid #f0f0f0;
 187   color: #777777;
 188 }
 189
 190 div.quoteblock > div.attribution {
 191   padding-top: 0.5em;
 192   text-align: right;
 193 }
 194
 195 div.verseblock > pre.content {
 196   font-family: inherit;
 197   font-size: inherit;
 198 }
 199 div.verseblock > div.attribution {
 200   padding-top: 0.75em;
 201   text-align: left;
 202 }
 203 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
 204 div.verseblock + div.attribution {
 205   text-align: left;
 206 }
 207
 208 div.admonitionblock .icon {
 209   vertical-align: top;
 210   font-size: 1.1em;
 211   font-weight: bold;
 212   text-decoration: underline;
 213   color: #527bbd;
 214   padding-right: 0.5em;
 215 }
 216 div.admonitionblock td.content {
 217   padding-left: 0.5em;
 218   border-left: 3px solid #dddddd;
 219 }
 220
 221 div.exampleblock > div.content {
 222   border-left: 3px solid #dddddd;
 223   padding-left: 0.5em;
 224 }
 225
 226 div.imageblock div.content { padding-left: 0; }
 227 span.image img { border-style: none; }
 228 a.image:visited { color: white; }
 229
 230 dl {
 231   margin-top: 0.8em;
 232   margin-bottom: 0.8em;
 233 }
 234 dt {
 235   margin-top: 0.5em;
 236   margin-bottom: 0;
 237   font-style: normal;
 238   color: navy;
 239 }
 240 dd > *:first-child {
 241   margin-top: 0.1em;
 242 }
 243
 244 ul, ol {
 245     list-style-position: outside;
 246 }
 247 ol.arabic {
 248   list-style-type: decimal;
 249 }
 250 ol.loweralpha {
 251   list-style-type: lower-alpha;
 252 }
 253 ol.upperalpha {
 254   list-style-type: upper-alpha;
 255 }
 256 ol.lowerroman {
 257   list-style-type: lower-roman;
 258 }
 259 ol.upperroman {
 260   list-style-type: upper-roman;
 261 }
 262
 263 div.compact ul, div.compact ol,
 264 div.compact p, div.compact p,
 265 div.compact div, div.compact div {
 266   margin-top: 0.1em;
 267   margin-bottom: 0.1em;
 268 }
 269
 270 div.tableblock > table {
 271   border: 3px solid #527bbd;
 272 }
 273 thead, p.table.header {
 274   font-weight: bold;
 275   color: #527bbd;
 276 }
 277 tfoot {
 278   font-weight: bold;
 279 }
 280 td > div.verse {
 281   white-space: pre;
 282 }
 283 p.table {
 284   margin-top: 0;
 285 }
 286 /* Because the table frame attribute is overriden by CSS in most browsers. */
 287 div.tableblock > table[frame="void"] {
 288   border-style: none;
 289 }
 290 div.tableblock > table[frame="hsides"] {
 291   border-left-style: none;
 292   border-right-style: none;
 293 }
 294 div.tableblock > table[frame="vsides"] {
 295   border-top-style: none;
 296   border-bottom-style: none;
 297 }
 298
 299
 300 div.hdlist {
 301   margin-top: 0.8em;
 302   margin-bottom: 0.8em;
 303 }
 304 div.hdlist tr {
 305   padding-bottom: 15px;
 306 }
 307 dt.hdlist1.strong, td.hdlist1.strong {
 308   font-weight: bold;
 309 }
 310 td.hdlist1 {
 311   vertical-align: top;
 312   font-style: normal;
 313   padding-right: 0.8em;
 314   color: navy;
 315 }
 316 td.hdlist2 {
 317   vertical-align: top;
 318 }
 319 div.hdlist.compact tr {
 320   margin: 0;
 321   padding-bottom: 0;
 322 }
 323
 324 .comment {
 325   background: yellow;
 326 }
 327
 328 .footnote, .footnoteref {
 329   font-size: 0.8em;
 330 }
 331
 332 span.footnote, span.footnoteref {
 333   vertical-align: super;
 334 }
 335
 336 #footnotes {
 337   margin: 20px 0 20px 0;
 338   padding: 7px 0 0 0;
 339 }
 340
 341 #footnotes div.footnote {
 342   margin: 0 0 5px 0;
 343 }
 344
 345 #footnotes hr {
 346   border: none;
 347   border-top: 1px solid silver;
 348   height: 1px;
 349   text-align: left;
 350   margin-left: 0;
 351   width: 20%;
 352   min-width: 100px;
 353 }
 354
 355 div.colist td {
 356   padding-right: 0.5em;
 357   padding-bottom: 0.3em;
 358   vertical-align: top;
 359 }
 360 div.colist td img {
 361   margin-top: 0.3em;
 362 }
 363
 364 @media print {
 365   div#footer-badges { display: none; }
 366 }
 367
 368 div#toc {
 369   margin-bottom: 2.5em;
 370 }
 371
 372 div#toctitle {
 373   color: #527bbd;
 374   font-size: 1.1em;
 375   font-weight: bold;
 376   margin-top: 1.0em;
 377   margin-bottom: 0.1em;
 378 }
 379
 380 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
 381   margin-top: 0;
 382   margin-bottom: 0;
 383 }
 384 div.toclevel2 {
 385   margin-left: 2em;
 386   font-size: 0.9em;
 387 }
 388 div.toclevel3 {
 389   margin-left: 4em;
 390   font-size: 0.9em;
 391 }
 392 div.toclevel4 {
 393   margin-left: 6em;
 394   font-size: 0.9em;
 395 }
 396
 397 span.aqua { color: aqua; }
 398 span.black { color: black; }
 399 span.blue { color: blue; }
 400 span.fuchsia { color: fuchsia; }
 401 span.gray { color: gray; }
 402 span.green { color: green; }
 403 span.lime { color: lime; }
 404 span.maroon { color: maroon; }
 405 span.navy { color: navy; }
 406 span.olive { color: olive; }
 407 span.purple { color: purple; }
 408 span.red { color: red; }
 409 span.silver { color: silver; }
 410 span.teal { color: teal; }
 411 span.white { color: white; }
 412 span.yellow { color: yellow; }
 413
 414 span.aqua-background { background: aqua; }
 415 span.black-background { background: black; }
 416 span.blue-background { background: blue; }
 417 span.fuchsia-background { background: fuchsia; }
 418 span.gray-background { background: gray; }
 419 span.green-background { background: green; }
 420 span.lime-background { background: lime; }
 421 span.maroon-background { background: maroon; }
 422 span.navy-background { background: navy; }
 423 span.olive-background { background: olive; }
 424 span.purple-background { background: purple; }
 425 span.red-background { background: red; }
 426 span.silver-background { background: silver; }
 427 span.teal-background { background: teal; }
 428 span.white-background { background: white; }
 429 span.yellow-background { background: yellow; }
 430
 431 span.big { font-size: 2em; }
 432 span.small { font-size: 0.6em; }
 433 /* Overrides for manpage documents */
 434 h1 {
 435   padding-top: 0.5em;
 436   padding-bottom: 0.5em;
 437   border-top: 2px solid silver;
 438   border-bottom: 2px solid silver;
 439 }
 440 h2 {
 441   border-style: none;
 442 }
 443 div.sectionbody {
 444   margin-left: 5%;
 445 }
 446
 447 @media print {
 448   div#toc { display: none; }
 449 }
 450
 451 </style>
 452 <script type="text/javascript">
 453 /*<![CDATA[*/
 454 window.onload = function(){asciidoc.footnotes();}
 455 var asciidoc = {  // Namespace.
 456
 457 /////////////////////////////////////////////////////////////////////
 458 // Table Of Contents generator
 459 /////////////////////////////////////////////////////////////////////
 460
 461 /* Author: Mihai Bazon, September 2002
 462  * http://students.infoiasi.ro/~mishoo
 463  *
 464  * Table Of Content generator
 465  * Version: 0.4
 466  *
 467  * Feel free to use this script under the terms of the GNU General Public
 468  * License, as long as you do not remove or alter this notice.
 469  */
 470
 471  /* modified by Troy D. Hanson, September 2006. License: GPL */
 472  /* modified by Stuart Rackham, 2006, 2009. License: GPL */
 473
 474 // toclevels = 1..4.
 475 toc: function (toclevels) {
 476
 477   function getText(el) {
 478     var text = "";
 479     for (var i = el.firstChild; i != null; i = i.nextSibling) {
 480       if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
 481         text += i.data;
 482       else if (i.firstChild != null)
 483         text += getText(i);
 484     }
 485     return text;
 486   }
 487
 488   function TocEntry(el, text, toclevel) {
 489     this.element = el;
 490     this.text = text;
 491     this.toclevel = toclevel;
 492   }
 493
 494   function tocEntries(el, toclevels) {
 495     var result = new Array;
 496     var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
 497     // Function that scans the DOM tree for header elements (the DOM2
 498     // nodeIterator API would be a better technique but not supported by all
 499     // browsers).
 500     var iterate = function (el) {
 501       for (var i = el.firstChild; i != null; i = i.nextSibling) {
 502         if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
 503           var mo = re.exec(i.tagName);
 504           if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
 505             result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
 506           }
 507           iterate(i);
 508         }
 509       }
 510     }
 511     iterate(el);
 512     return result;
 513   }
 514
 515   var toc = document.getElementById("toc");
 516   var entries = tocEntries(document.getElementById("content"), toclevels);
 517   for (var i = 0; i < entries.length; ++i) {
 518     var entry = entries[i];
 519     if (entry.element.id == "")
 520       entry.element.id = "_toc_" + i;
 521     var a = document.createElement("a");
 522     a.href = "#" + entry.element.id;
 523     a.appendChild(document.createTextNode(entry.text));
 524     var div = document.createElement("div");
 525     div.appendChild(a);
 526     div.className = "toclevel" + entry.toclevel;
 527     toc.appendChild(div);
 528   }
 529   if (entries.length == 0)
 530     toc.parentNode.removeChild(toc);
 531 },
 532
 533
 534 /////////////////////////////////////////////////////////////////////
 535 // Footnotes generator
 536 /////////////////////////////////////////////////////////////////////
 537
 538 /* Based on footnote generation code from:
 539  * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
 540  */
 541
 542 footnotes: function () {
 543   var cont = document.getElementById("content");
 544   var noteholder = document.getElementById("footnotes");
 545   var spans = cont.getElementsByTagName("span");
 546   var refs = {};
 547   var n = 0;
 548   for (i=0; i<spans.length; i++) {
 549     if (spans[i].className == "footnote") {
 550       n++;
 551       // Use [\s\S] in place of . so multi-line matches work.
 552       // Because JavaScript has no s (dotall) regex flag.
 553       note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
 554       noteholder.innerHTML +=
 555         "<div class='footnote' id='_footnote_" + n + "'>" +
 556         "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
 557         n + "</a>. " + note + "</div>";
 558       spans[i].innerHTML =
 559         "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
 560         "' title='View footnote' class='footnote'>" + n + "</a>]";
 561       var id =spans[i].getAttribute("id");
 562       if (id != null) refs["#"+id] = n;
 563     }
 564   }
 565   if (n == 0)
 566     noteholder.parentNode.removeChild(noteholder);
 567   else {
 568     // Process footnoterefs.
 569     for (i=0; i<spans.length; i++) {
 570       if (spans[i].className == "footnoteref") {
 571         var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
 572         href = href.match(/#.*/)[0];  // Because IE return full URL.
 573         n = refs[href];
 574         spans[i].innerHTML =
 575           "[<a href='#_footnote_" + n +
 576           "' title='View footnote' class='footnote'>" + n + "</a>]";
 577       }
 578     }
 579   }
 580 }
 581
 582 }
 583 /*]]>*/
 584 </script>
 585 </head>
 586 <body class="manpage">
 587 <div id="header">
 588 <h1>
 589 guilt-add(1) Manual Page
 590 </h1>
 591 <h2>NAME</h2>
 592 <div class="sectionbody">
 593 <p>guilt-add -
 594    Add a file to git and guilt
 595 </p>
 596 </div>
 597 </div>
 598 <div id="content">
 599 <div class="sect1">
 600 <h2 id="_synopsis">SYNOPSIS</h2>
 601 <div class="sectionbody">
 602 <div class="paragraph"><p><em>guilt-add</em> &lt;file&gt;&#8230;</p></div>
 603 </div>
 604 </div>
 605 <div class="sect1">
 606 <h2 id="_description">DESCRIPTION</h2>
 607 <div class="sectionbody">
 608 <div class="paragraph"><p>Adds the files specified to git using git-add making it available to guilt.</p></div>
 609 </div>
 610 </div>
 611 <div class="sect1">
 612 <h2 id="_options">OPTIONS</h2>
 613 <div class="sectionbody">
 614 <div class="dlist"><dl>
 615 <dt class="hdlist1">
 616 &lt;files&gt;
 617 </dt>
 618 <dd>
 619 <p>
 620         Files to add
 621 </p>
 622 </dd>
 623 </dl></div>
 624 </div>
 625 </div>
 626 <div class="sect1">
 627 <h2 id="_examples">EXAMPLES</h2>
 628 <div class="sectionbody">
 629 <div class="paragraph"><p>Create and add a new file example.c</p></div>
 630 <div class="literalblock">
 631 <div class="content">
 632 <pre><tt>$ touch example.c
 633 $ guilt-add example.c</tt></pre>
 634 </div></div>
 635 </div>
 636 </div>
 637 <div class="sect1">
 638 <h2 id="_author">Author</h2>
 639 <div class="sectionbody">
 640 <div class="paragraph"><p>Written by Josef "Jeff" Sipek &lt;<a href="mailto:jeffpc@josefsipek.net">jeffpc@josefsipek.net</a>&gt;</p></div>
 641 </div>
 642 </div>
 643 <div class="sect1">
 644 <h2 id="_documentation">Documentation</h2>
 645 <div class="sectionbody">
 646 <div class="paragraph"><p>Documentation by Brandon Philips &lt;<a href="mailto:brandon@ifup.org">brandon@ifup.org</a>&gt;</p></div>
 647 </div>
 648 </div>
 649 <div class="sect1">
 650 <h2 id="_guilt">GUILT</h2>
 651 <div class="sectionbody">
 652 <div class="paragraph"><p>Part of the <a href="guilt.html">guilt(7)</a> suite
 653 (Generated for Guilt v0.35)</p></div>
 654 </div>
 655 </div>
 656 </div>
 657 <div id="footnotes"><hr /></div>
 658 <div id="footer">
 659 <div id="footer-text">
 660 Last updated 2010-09-18 16:36:14 EDT
 661 </div>
 662 </div>
 663 </body>
 664 </html>