Guilt v0.35
[guilt.git] / Documentation / guilt-pop.html
blob6ade7d96b38bf52775df70f65024e82b400d5dfc
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-pop(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;
19 /* Serif font. */
20 div.sectionbody {
21 font-family: Georgia,"Times New Roman",Times,serif;
24 /* Monospace font. */
25 tt {
26 font-size: inherit;
29 body {
30 margin: 1em 5% 1em 5%;
33 a {
34 color: blue;
35 text-decoration: underline;
37 a:visited {
38 color: fuchsia;
41 em {
42 font-style: italic;
43 color: navy;
46 strong {
47 font-weight: bold;
48 color: #083194;
51 tt {
52 font-size: inherit;
53 color: navy;
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;
63 h1, h2, h3 {
64 border-bottom: 2px solid silver;
66 h2 {
67 padding-top: 0.5em;
69 h3 {
70 float: left;
72 h3 + * {
73 clear: left;
76 div.sectionbody {
77 margin-left: 0;
80 hr {
81 border: 1px solid silver;
84 p {
85 margin-top: 0.5em;
86 margin-bottom: 0.5em;
89 ul, ol, li > p {
90 margin-top: 0;
92 ul > li { color: #aaa; }
93 ul > li > * { color: black; }
95 pre {
96 padding: 0;
97 margin: 0;
100 span#author {
101 color: #527bbd;
102 font-weight: bold;
103 font-size: 1.1em;
105 span#email {
107 span#revnumber, span#revdate, span#revremark {
110 div#footer {
111 font-size: small;
112 border-top: 2px solid silver;
113 padding-top: 0.5em;
114 margin-top: 4.0em;
116 div#footer-text {
117 float: left;
118 padding-bottom: 0.5em;
120 div#footer-badges {
121 float: right;
122 padding-bottom: 0.5em;
125 div#preamble {
126 margin-top: 1.5em;
127 margin-bottom: 1.5em;
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;
135 div.admonitionblock {
136 margin-top: 2.0em;
137 margin-bottom: 2.0em;
138 margin-right: 10%;
139 color: #606060;
142 div.content { /* Block element content. */
143 padding: 0;
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;
154 div.title + * {
155 margin-top: 0;
158 td div.title:first-child {
159 margin-top: 0.0em;
161 div.content div.title:first-child {
162 margin-top: 0.0em;
164 div.content + div.title {
165 margin-top: 0.0em;
168 div.sidebarblock > div.content {
169 background: #ffffee;
170 border: 1px solid #dddddd;
171 border-left: 4px solid #f0f0f0;
172 padding: 0.5em;
175 div.listingblock > div.content {
176 border: 1px solid #dddddd;
177 border-left: 5px solid #f0f0f0;
178 background: #f8f8f8;
179 padding: 0.5em;
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;
190 div.quoteblock > div.attribution {
191 padding-top: 0.5em;
192 text-align: right;
195 div.verseblock > pre.content {
196 font-family: inherit;
197 font-size: inherit;
199 div.verseblock > div.attribution {
200 padding-top: 0.75em;
201 text-align: left;
203 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
204 div.verseblock + div.attribution {
205 text-align: left;
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;
216 div.admonitionblock td.content {
217 padding-left: 0.5em;
218 border-left: 3px solid #dddddd;
221 div.exampleblock > div.content {
222 border-left: 3px solid #dddddd;
223 padding-left: 0.5em;
226 div.imageblock div.content { padding-left: 0; }
227 span.image img { border-style: none; }
228 a.image:visited { color: white; }
230 dl {
231 margin-top: 0.8em;
232 margin-bottom: 0.8em;
234 dt {
235 margin-top: 0.5em;
236 margin-bottom: 0;
237 font-style: normal;
238 color: navy;
240 dd > *:first-child {
241 margin-top: 0.1em;
244 ul, ol {
245 list-style-position: outside;
247 ol.arabic {
248 list-style-type: decimal;
250 ol.loweralpha {
251 list-style-type: lower-alpha;
253 ol.upperalpha {
254 list-style-type: upper-alpha;
256 ol.lowerroman {
257 list-style-type: lower-roman;
259 ol.upperroman {
260 list-style-type: upper-roman;
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;
270 div.tableblock > table {
271 border: 3px solid #527bbd;
273 thead, p.table.header {
274 font-weight: bold;
275 color: #527bbd;
277 tfoot {
278 font-weight: bold;
280 td > div.verse {
281 white-space: pre;
283 p.table {
284 margin-top: 0;
286 /* Because the table frame attribute is overriden by CSS in most browsers. */
287 div.tableblock > table[frame="void"] {
288 border-style: none;
290 div.tableblock > table[frame="hsides"] {
291 border-left-style: none;
292 border-right-style: none;
294 div.tableblock > table[frame="vsides"] {
295 border-top-style: none;
296 border-bottom-style: none;
300 div.hdlist {
301 margin-top: 0.8em;
302 margin-bottom: 0.8em;
304 div.hdlist tr {
305 padding-bottom: 15px;
307 dt.hdlist1.strong, td.hdlist1.strong {
308 font-weight: bold;
310 td.hdlist1 {
311 vertical-align: top;
312 font-style: normal;
313 padding-right: 0.8em;
314 color: navy;
316 td.hdlist2 {
317 vertical-align: top;
319 div.hdlist.compact tr {
320 margin: 0;
321 padding-bottom: 0;
324 .comment {
325 background: yellow;
328 .footnote, .footnoteref {
329 font-size: 0.8em;
332 span.footnote, span.footnoteref {
333 vertical-align: super;
336 #footnotes {
337 margin: 20px 0 20px 0;
338 padding: 7px 0 0 0;
341 #footnotes div.footnote {
342 margin: 0 0 5px 0;
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;
355 div.colist td {
356 padding-right: 0.5em;
357 padding-bottom: 0.3em;
358 vertical-align: top;
360 div.colist td img {
361 margin-top: 0.3em;
364 @media print {
365 div#footer-badges { display: none; }
368 div#toc {
369 margin-bottom: 2.5em;
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;
380 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
381 margin-top: 0;
382 margin-bottom: 0;
384 div.toclevel2 {
385 margin-left: 2em;
386 font-size: 0.9em;
388 div.toclevel3 {
389 margin-left: 4em;
390 font-size: 0.9em;
392 div.toclevel4 {
393 margin-left: 6em;
394 font-size: 0.9em;
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; }
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; }
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;
440 h2 {
441 border-style: none;
443 div.sectionbody {
444 margin-left: 5%;
447 @media print {
448 div#toc { display: none; }
451 </style>
452 <script type="text/javascript">
453 /*<![CDATA[*/
454 window.onload = function(){asciidoc.footnotes();}
455 var asciidoc = { // Namespace.
457 /////////////////////////////////////////////////////////////////////
458 // Table Of Contents generator
459 /////////////////////////////////////////////////////////////////////
461 /* Author: Mihai Bazon, September 2002
462 * http://students.infoiasi.ro/~mishoo
464 * Table Of Content generator
465 * Version: 0.4
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.
471 /* modified by Troy D. Hanson, September 2006. License: GPL */
472 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
474 // toclevels = 1..4.
475 toc: function (toclevels) {
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);
485 return text;
488 function TocEntry(el, text, toclevel) {
489 this.element = el;
490 this.text = text;
491 this.toclevel = toclevel;
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);
507 iterate(i);
511 iterate(el);
512 return result;
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);
529 if (entries.length == 0)
530 toc.parentNode.removeChild(toc);
534 /////////////////////////////////////////////////////////////////////
535 // Footnotes generator
536 /////////////////////////////////////////////////////////////////////
538 /* Based on footnote generation code from:
539 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
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;
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>]";
583 /*]]>*/
584 </script>
585 </head>
586 <body class="manpage">
587 <div id="header">
588 <h1>
589 guilt-pop(1) Manual Page
590 </h1>
591 <h2>NAME</h2>
592 <div class="sectionbody">
593 <p>guilt-pop -
594 Pop patches from the tree
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-pop</em> [-f] [-a | --all | -n &lt;num&gt; | &lt;patchname&gt;]</p></div>
603 </div>
604 </div>
605 <div class="sect1">
606 <h2 id="_options">OPTIONS</h2>
607 <div class="sectionbody">
608 <div class="dlist"><dl>
609 <dt class="hdlist1">
610 --all
611 </dt>
612 <dt class="hdlist1">
614 </dt>
615 <dd>
617 Pop all patches off the tree
618 </p>
619 </dd>
620 <dt class="hdlist1">
622 </dt>
623 <dd>
625 Force; discards any unrefreshed changes
626 </p>
627 </dd>
628 <dt class="hdlist1">
629 -n &lt;num&gt;
630 </dt>
631 <dd>
633 Push specified number of patches
634 </p>
635 </dd>
636 <dt class="hdlist1">
637 &lt;patchname&gt;
638 </dt>
639 <dd>
641 Pop all patches up to and including this patch off the tree
642 </p>
643 </dd>
644 </dl></div>
645 <div class="paragraph"><p>If no patchname is given, pop the top-most patch.</p></div>
646 </div>
647 </div>
648 <div class="sect1">
649 <h2 id="_author">Author</h2>
650 <div class="sectionbody">
651 <div class="paragraph"><p>Written by Josef "Jeff" Sipek &lt;<a href="mailto:jeffpc@josefsipek.net">jeffpc@josefsipek.net</a>&gt;</p></div>
652 </div>
653 </div>
654 <div class="sect1">
655 <h2 id="_documentation">Documentation</h2>
656 <div class="sectionbody">
657 <div class="paragraph"><p>Documentation by Brandon Philips &lt;<a href="mailto:brandon@ifup.org">brandon@ifup.org</a>&gt;</p></div>
658 </div>
659 </div>
660 <div class="sect1">
661 <h2 id="_guilt">GUILT</h2>
662 <div class="sectionbody">
663 <div class="paragraph"><p>Part of the <a href="guilt.html">guilt(7)</a> suite
664 (Generated for Guilt v0.35)</p></div>
665 </div>
666 </div>
667 </div>
668 <div id="footnotes"><hr /></div>
669 <div id="footer">
670 <div id="footer-text">
671 Last updated 2010-09-18 16:36:15 EDT
672 </div>
673 </div>
674 </body>
675 </html>