blob: bd9a28db7839284e1b4d1d2c880a4a50edf47a29 [file] [log] [blame]
Junio C Hamano1a4e8412005-12-27 08:17:231<!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>
Junio C Hamano9d971152012-12-19 00:43:115<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
Junio C Hamanoc14e6ad2014-10-31 20:25:536<meta name="generator" content="AsciiDoc 8.6.9" />
Junio C Hamano68cf15a2010-11-06 01:01:597<title>git-reset(1)</title>
Junio C Hamano1a4e8412005-12-27 08:17:238<style type="text/css">
Junio C Hamano9d971152012-12-19 00:43:119/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
10
11/* Default font. */
12body {
13 font-family: Georgia,serif;
14}
15
16/* Title font. */
17h1, h2, h3, h4, h5, h6,
18div.title, caption.title,
19thead, p.table.header,
20#toctitle,
21#author, #revnumber, #revdate, #revremark,
22#footer {
23 font-family: Arial,Helvetica,sans-serif;
Junio C Hamano1a4e8412005-12-27 08:17:2324}
25
26body {
27 margin: 1em 5% 1em 5%;
28}
29
Junio C Hamanoba4b9282008-07-06 05:20:3130a {
31 color: blue;
32 text-decoration: underline;
33}
34a:visited {
35 color: fuchsia;
36}
Junio C Hamano1a4e8412005-12-27 08:17:2337
38em {
39 font-style: italic;
Junio C Hamano68cf15a2010-11-06 01:01:5940 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:2341}
42
43strong {
44 font-weight: bold;
Junio C Hamano68cf15a2010-11-06 01:01:5945 color: #083194;
Junio C Hamano1a4e8412005-12-27 08:17:2346}
47
Junio C Hamano1a4e8412005-12-27 08:17:2348h1, h2, h3, h4, h5, h6 {
49 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:2350 margin-top: 1.2em;
51 margin-bottom: 0.5em;
52 line-height: 1.3;
53}
54
Junio C Hamanoba4b9282008-07-06 05:20:3155h1, h2, h3 {
Junio C Hamano1a4e8412005-12-27 08:17:2356 border-bottom: 2px solid silver;
57}
58h2 {
Junio C Hamano1a4e8412005-12-27 08:17:2359 padding-top: 0.5em;
60}
Junio C Hamanoba4b9282008-07-06 05:20:3161h3 {
62 float: left;
63}
64h3 + * {
65 clear: left;
66}
Junio C Hamano9d971152012-12-19 00:43:1167h5 {
68 font-size: 1.0em;
69}
Junio C Hamano1a4e8412005-12-27 08:17:2370
71div.sectionbody {
Junio C Hamano1a4e8412005-12-27 08:17:2372 margin-left: 0;
73}
74
75hr {
76 border: 1px solid silver;
77}
78
79p {
80 margin-top: 0.5em;
81 margin-bottom: 0.5em;
82}
83
Junio C Hamano68cf15a2010-11-06 01:01:5984ul, ol, li > p {
85 margin-top: 0;
86}
Junio C Hamano9d971152012-12-19 00:43:1187ul > li { color: #aaa; }
88ul > li > * { color: black; }
Junio C Hamano68cf15a2010-11-06 01:01:5989
Junio C Hamanoc14e6ad2014-10-31 20:25:5390.monospaced, code, pre {
91 font-family: "Courier New", Courier, monospace;
92 font-size: inherit;
93 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:2394 padding: 0;
95 margin: 0;
96}
Junio C Hamanoc14e6ad2014-10-31 20:25:5397pre {
98 white-space: pre-wrap;
99}
Junio C Hamano1a4e8412005-12-27 08:17:23100
Junio C Hamano9d971152012-12-19 00:43:11101#author {
Junio C Hamano1a4e8412005-12-27 08:17:23102 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23103 font-weight: bold;
Junio C Hamanoba4b9282008-07-06 05:20:31104 font-size: 1.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23105}
Junio C Hamano9d971152012-12-19 00:43:11106#email {
Junio C Hamano1a4e8412005-12-27 08:17:23107}
Junio C Hamano9d971152012-12-19 00:43:11108#revnumber, #revdate, #revremark {
Junio C Hamano1a4e8412005-12-27 08:17:23109}
110
Junio C Hamano9d971152012-12-19 00:43:11111#footer {
Junio C Hamano1a4e8412005-12-27 08:17:23112 font-size: small;
113 border-top: 2px solid silver;
114 padding-top: 0.5em;
115 margin-top: 4.0em;
116}
Junio C Hamano9d971152012-12-19 00:43:11117#footer-text {
Junio C Hamano1a4e8412005-12-27 08:17:23118 float: left;
119 padding-bottom: 0.5em;
120}
Junio C Hamano9d971152012-12-19 00:43:11121#footer-badges {
Junio C Hamano1a4e8412005-12-27 08:17:23122 float: right;
123 padding-bottom: 0.5em;
124}
125
Junio C Hamano9d971152012-12-19 00:43:11126#preamble {
Junio C Hamano68cf15a2010-11-06 01:01:59127 margin-top: 1.5em;
128 margin-bottom: 1.5em;
129}
Junio C Hamano9d971152012-12-19 00:43:11130div.imageblock, div.exampleblock, div.verseblock,
Junio C Hamano1a4e8412005-12-27 08:17:23131div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
132div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22133 margin-top: 1.0em;
Junio C Hamano1a4e8412005-12-27 08:17:23134 margin-bottom: 1.5em;
135}
136div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22137 margin-top: 2.0em;
138 margin-bottom: 2.0em;
139 margin-right: 10%;
140 color: #606060;
Junio C Hamano1a4e8412005-12-27 08:17:23141}
142
143div.content { /* Block element content. */
144 padding: 0;
145}
146
147/* Block element titles. */
148div.title, caption.title {
Junio C Hamano68cf15a2010-11-06 01:01:59149 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23150 font-weight: bold;
151 text-align: left;
152 margin-top: 1.0em;
153 margin-bottom: 0.5em;
154}
155div.title + * {
156 margin-top: 0;
157}
158
159td div.title:first-child {
160 margin-top: 0.0em;
161}
162div.content div.title:first-child {
163 margin-top: 0.0em;
164}
165div.content + div.title {
166 margin-top: 0.0em;
167}
168
169div.sidebarblock > div.content {
170 background: #ffffee;
Junio C Hamano9d971152012-12-19 00:43:11171 border: 1px solid #dddddd;
172 border-left: 4px solid #f0f0f0;
Junio C Hamano1a4e8412005-12-27 08:17:23173 padding: 0.5em;
174}
175
176div.listingblock > div.content {
Junio C Hamano9d971152012-12-19 00:43:11177 border: 1px solid #dddddd;
178 border-left: 5px solid #f0f0f0;
179 background: #f8f8f8;
Junio C Hamano1a4e8412005-12-27 08:17:23180 padding: 0.5em;
181}
182
Junio C Hamano7bd050f2011-09-22 06:32:22183div.quoteblock, div.verseblock {
184 padding-left: 1.0em;
185 margin-left: 1.0em;
Junio C Hamano68cf15a2010-11-06 01:01:59186 margin-right: 10%;
Junio C Hamano9d971152012-12-19 00:43:11187 border-left: 5px solid #f0f0f0;
188 color: #888;
Junio C Hamano1a4e8412005-12-27 08:17:23189}
Junio C Hamano7bd050f2011-09-22 06:32:22190
Junio C Hamano68cf15a2010-11-06 01:01:59191div.quoteblock > div.attribution {
192 padding-top: 0.5em;
Junio C Hamano1a4e8412005-12-27 08:17:23193 text-align: right;
194}
Junio C Hamano68cf15a2010-11-06 01:01:59195
Junio C Hamano9d971152012-12-19 00:43:11196div.verseblock > pre.content {
197 font-family: inherit;
198 font-size: inherit;
Junio C Hamano68cf15a2010-11-06 01:01:59199}
200div.verseblock > div.attribution {
201 padding-top: 0.75em;
202 text-align: left;
203}
204/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
Junio C Hamanoba4b9282008-07-06 05:20:31205div.verseblock + div.attribution {
206 text-align: left;
207}
Junio C Hamano1a4e8412005-12-27 08:17:23208
209div.admonitionblock .icon {
210 vertical-align: top;
211 font-size: 1.1em;
212 font-weight: bold;
213 text-decoration: underline;
214 color: #527bbd;
215 padding-right: 0.5em;
216}
217div.admonitionblock td.content {
218 padding-left: 0.5em;
Junio C Hamano7bd050f2011-09-22 06:32:22219 border-left: 3px solid #dddddd;
Junio C Hamano1a4e8412005-12-27 08:17:23220}
221
222div.exampleblock > div.content {
Junio C Hamano7bd050f2011-09-22 06:32:22223 border-left: 3px solid #dddddd;
224 padding-left: 0.5em;
Junio C Hamano1a4e8412005-12-27 08:17:23225}
226
Junio C Hamano1a4e8412005-12-27 08:17:23227div.imageblock div.content { padding-left: 0; }
Junio C Hamanoc14e6ad2014-10-31 20:25:53228span.image img { border-style: none; vertical-align: text-bottom; }
Junio C Hamano68cf15a2010-11-06 01:01:59229a.image:visited { color: white; }
Junio C Hamano1a4e8412005-12-27 08:17:23230
231dl {
232 margin-top: 0.8em;
233 margin-bottom: 0.8em;
234}
235dt {
236 margin-top: 0.5em;
237 margin-bottom: 0;
Junio C Hamano68cf15a2010-11-06 01:01:59238 font-style: normal;
239 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23240}
241dd > *:first-child {
Junio C Hamano68cf15a2010-11-06 01:01:59242 margin-top: 0.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23243}
244
245ul, ol {
246 list-style-position: outside;
247}
Junio C Hamano68cf15a2010-11-06 01:01:59248ol.arabic {
249 list-style-type: decimal;
250}
251ol.loweralpha {
Junio C Hamano1a4e8412005-12-27 08:17:23252 list-style-type: lower-alpha;
253}
Junio C Hamano68cf15a2010-11-06 01:01:59254ol.upperalpha {
255 list-style-type: upper-alpha;
256}
257ol.lowerroman {
258 list-style-type: lower-roman;
259}
260ol.upperroman {
261 list-style-type: upper-roman;
262}
263
264div.compact ul, div.compact ol,
265div.compact p, div.compact p,
266div.compact div, div.compact div {
267 margin-top: 0.1em;
268 margin-bottom: 0.1em;
269}
Junio C Hamano1a4e8412005-12-27 08:17:23270
Junio C Hamano1a4e8412005-12-27 08:17:23271tfoot {
272 font-weight: bold;
273}
Junio C Hamano68cf15a2010-11-06 01:01:59274td > div.verse {
275 white-space: pre;
276}
Junio C Hamano68cf15a2010-11-06 01:01:59277
278div.hdlist {
Junio C Hamano1a4e8412005-12-27 08:17:23279 margin-top: 0.8em;
280 margin-bottom: 0.8em;
281}
Junio C Hamano68cf15a2010-11-06 01:01:59282div.hdlist tr {
283 padding-bottom: 15px;
Junio C Hamanoba4b9282008-07-06 05:20:31284}
Junio C Hamano68cf15a2010-11-06 01:01:59285dt.hdlist1.strong, td.hdlist1.strong {
286 font-weight: bold;
287}
288td.hdlist1 {
Junio C Hamano1a4e8412005-12-27 08:17:23289 vertical-align: top;
Junio C Hamano68cf15a2010-11-06 01:01:59290 font-style: normal;
Junio C Hamano1a4e8412005-12-27 08:17:23291 padding-right: 0.8em;
Junio C Hamano68cf15a2010-11-06 01:01:59292 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23293}
Junio C Hamano68cf15a2010-11-06 01:01:59294td.hdlist2 {
Junio C Hamano1a4e8412005-12-27 08:17:23295 vertical-align: top;
296}
Junio C Hamano68cf15a2010-11-06 01:01:59297div.hdlist.compact tr {
298 margin: 0;
299 padding-bottom: 0;
300}
301
302.comment {
303 background: yellow;
304}
Junio C Hamano1a4e8412005-12-27 08:17:23305
Junio C Hamano7bd050f2011-09-22 06:32:22306.footnote, .footnoteref {
307 font-size: 0.8em;
308}
309
310span.footnote, span.footnoteref {
311 vertical-align: super;
312}
313
314#footnotes {
315 margin: 20px 0 20px 0;
316 padding: 7px 0 0 0;
317}
318
319#footnotes div.footnote {
320 margin: 0 0 5px 0;
321}
322
323#footnotes hr {
324 border: none;
325 border-top: 1px solid silver;
326 height: 1px;
327 text-align: left;
328 margin-left: 0;
329 width: 20%;
330 min-width: 100px;
331}
332
Junio C Hamano9d971152012-12-19 00:43:11333div.colist td {
334 padding-right: 0.5em;
335 padding-bottom: 0.3em;
336 vertical-align: top;
337}
338div.colist td img {
339 margin-top: 0.3em;
Junio C Hamano1a4e8412005-12-27 08:17:23340}
Junio C Hamanoba4b9282008-07-06 05:20:31341
Junio C Hamano9d971152012-12-19 00:43:11342@media print {
343 #footer-badges { display: none; }
344}
345
346#toc {
Junio C Hamano7bd050f2011-09-22 06:32:22347 margin-bottom: 2.5em;
348}
349
Junio C Hamano9d971152012-12-19 00:43:11350#toctitle {
Junio C Hamanoba4b9282008-07-06 05:20:31351 color: #527bbd;
Junio C Hamanoba4b9282008-07-06 05:20:31352 font-size: 1.1em;
353 font-weight: bold;
354 margin-top: 1.0em;
355 margin-bottom: 0.1em;
356}
357
Junio C Hamanoc14e6ad2014-10-31 20:25:53358div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
Junio C Hamanoba4b9282008-07-06 05:20:31359 margin-top: 0;
360 margin-bottom: 0;
361}
362div.toclevel2 {
363 margin-left: 2em;
364 font-size: 0.9em;
365}
366div.toclevel3 {
367 margin-left: 4em;
368 font-size: 0.9em;
369}
370div.toclevel4 {
371 margin-left: 6em;
372 font-size: 0.9em;
373}
Junio C Hamano9d971152012-12-19 00:43:11374
375span.aqua { color: aqua; }
376span.black { color: black; }
377span.blue { color: blue; }
378span.fuchsia { color: fuchsia; }
379span.gray { color: gray; }
380span.green { color: green; }
381span.lime { color: lime; }
382span.maroon { color: maroon; }
383span.navy { color: navy; }
384span.olive { color: olive; }
385span.purple { color: purple; }
386span.red { color: red; }
387span.silver { color: silver; }
388span.teal { color: teal; }
389span.white { color: white; }
390span.yellow { color: yellow; }
391
392span.aqua-background { background: aqua; }
393span.black-background { background: black; }
394span.blue-background { background: blue; }
395span.fuchsia-background { background: fuchsia; }
396span.gray-background { background: gray; }
397span.green-background { background: green; }
398span.lime-background { background: lime; }
399span.maroon-background { background: maroon; }
400span.navy-background { background: navy; }
401span.olive-background { background: olive; }
402span.purple-background { background: purple; }
403span.red-background { background: red; }
404span.silver-background { background: silver; }
405span.teal-background { background: teal; }
406span.white-background { background: white; }
407span.yellow-background { background: yellow; }
408
409span.big { font-size: 2em; }
410span.small { font-size: 0.6em; }
411
412span.underline { text-decoration: underline; }
413span.overline { text-decoration: overline; }
414span.line-through { text-decoration: line-through; }
415
Junio C Hamanoc14e6ad2014-10-31 20:25:53416div.unbreakable { page-break-inside: avoid; }
417
Junio C Hamano9d971152012-12-19 00:43:11418
419/*
420 * xhtml11 specific
421 *
422 * */
423
424div.tableblock {
425 margin-top: 1.0em;
426 margin-bottom: 1.5em;
427}
428div.tableblock > table {
429 border: 3px solid #527bbd;
430}
431thead, p.table.header {
432 font-weight: bold;
433 color: #527bbd;
434}
435p.table {
436 margin-top: 0;
437}
438/* Because the table frame attribute is overriden by CSS in most browsers. */
439div.tableblock > table[frame="void"] {
440 border-style: none;
441}
442div.tableblock > table[frame="hsides"] {
443 border-left-style: none;
444 border-right-style: none;
445}
446div.tableblock > table[frame="vsides"] {
447 border-top-style: none;
448 border-bottom-style: none;
449}
450
451
452/*
453 * html5 specific
454 *
455 * */
456
457table.tableblock {
458 margin-top: 1.0em;
459 margin-bottom: 1.5em;
460}
461thead, p.tableblock.header {
462 font-weight: bold;
463 color: #527bbd;
464}
465p.tableblock {
466 margin-top: 0;
467}
468table.tableblock {
469 border-width: 3px;
470 border-spacing: 0px;
471 border-style: solid;
472 border-color: #527bbd;
473 border-collapse: collapse;
474}
475th.tableblock, td.tableblock {
476 border-width: 1px;
477 padding: 4px;
478 border-style: solid;
479 border-color: #527bbd;
480}
481
482table.tableblock.frame-topbot {
483 border-left-style: hidden;
484 border-right-style: hidden;
485}
486table.tableblock.frame-sides {
487 border-top-style: hidden;
488 border-bottom-style: hidden;
489}
490table.tableblock.frame-none {
491 border-style: hidden;
492}
493
494th.tableblock.halign-left, td.tableblock.halign-left {
495 text-align: left;
496}
497th.tableblock.halign-center, td.tableblock.halign-center {
498 text-align: center;
499}
500th.tableblock.halign-right, td.tableblock.halign-right {
501 text-align: right;
502}
503
504th.tableblock.valign-top, td.tableblock.valign-top {
505 vertical-align: top;
506}
507th.tableblock.valign-middle, td.tableblock.valign-middle {
508 vertical-align: middle;
509}
510th.tableblock.valign-bottom, td.tableblock.valign-bottom {
511 vertical-align: bottom;
512}
513
514
515/*
516 * manpage specific
517 *
518 * */
519
520body.manpage h1 {
Junio C Hamano68cf15a2010-11-06 01:01:59521 padding-top: 0.5em;
522 padding-bottom: 0.5em;
523 border-top: 2px solid silver;
524 border-bottom: 2px solid silver;
525}
Junio C Hamano9d971152012-12-19 00:43:11526body.manpage h2 {
Junio C Hamano68cf15a2010-11-06 01:01:59527 border-style: none;
528}
Junio C Hamano9d971152012-12-19 00:43:11529body.manpage div.sectionbody {
530 margin-left: 3em;
Junio C Hamano68cf15a2010-11-06 01:01:59531}
532
533@media print {
Junio C Hamano9d971152012-12-19 00:43:11534 body.manpage div#toc { display: none; }
Junio C Hamano68cf15a2010-11-06 01:01:59535}
Junio C Hamanoc14e6ad2014-10-31 20:25:53536
537
Junio C Hamano1a4e8412005-12-27 08:17:23538</style>
Junio C Hamano7bd050f2011-09-22 06:32:22539<script type="text/javascript">
540/*<![CDATA[*/
Junio C Hamano7bd050f2011-09-22 06:32:22541var asciidoc = { // Namespace.
542
543/////////////////////////////////////////////////////////////////////
544// Table Of Contents generator
545/////////////////////////////////////////////////////////////////////
546
547/* Author: Mihai Bazon, September 2002
548 * http://students.infoiasi.ro/~mishoo
549 *
550 * Table Of Content generator
551 * Version: 0.4
552 *
553 * Feel free to use this script under the terms of the GNU General Public
554 * License, as long as you do not remove or alter this notice.
555 */
556
557 /* modified by Troy D. Hanson, September 2006. License: GPL */
558 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
559
560// toclevels = 1..4.
561toc: function (toclevels) {
562
563 function getText(el) {
564 var text = "";
565 for (var i = el.firstChild; i != null; i = i.nextSibling) {
566 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
567 text += i.data;
568 else if (i.firstChild != null)
569 text += getText(i);
570 }
571 return text;
572 }
573
574 function TocEntry(el, text, toclevel) {
575 this.element = el;
576 this.text = text;
577 this.toclevel = toclevel;
578 }
579
580 function tocEntries(el, toclevels) {
581 var result = new Array;
Junio C Hamanoc14e6ad2014-10-31 20:25:53582 var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
Junio C Hamano7bd050f2011-09-22 06:32:22583 // Function that scans the DOM tree for header elements (the DOM2
584 // nodeIterator API would be a better technique but not supported by all
585 // browsers).
586 var iterate = function (el) {
587 for (var i = el.firstChild; i != null; i = i.nextSibling) {
588 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
589 var mo = re.exec(i.tagName);
590 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
591 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
592 }
593 iterate(i);
594 }
595 }
596 }
597 iterate(el);
598 return result;
599 }
600
601 var toc = document.getElementById("toc");
Junio C Hamano9d971152012-12-19 00:43:11602 if (!toc) {
603 return;
604 }
605
606 // Delete existing TOC entries in case we're reloading the TOC.
607 var tocEntriesToRemove = [];
608 var i;
609 for (i = 0; i < toc.childNodes.length; i++) {
610 var entry = toc.childNodes[i];
Junio C Hamanoc14e6ad2014-10-31 20:25:53611 if (entry.nodeName.toLowerCase() == 'div'
Junio C Hamano9d971152012-12-19 00:43:11612 && entry.getAttribute("class")
613 && entry.getAttribute("class").match(/^toclevel/))
614 tocEntriesToRemove.push(entry);
615 }
616 for (i = 0; i < tocEntriesToRemove.length; i++) {
617 toc.removeChild(tocEntriesToRemove[i]);
618 }
619
620 // Rebuild TOC entries.
Junio C Hamano7bd050f2011-09-22 06:32:22621 var entries = tocEntries(document.getElementById("content"), toclevels);
622 for (var i = 0; i < entries.length; ++i) {
623 var entry = entries[i];
624 if (entry.element.id == "")
625 entry.element.id = "_toc_" + i;
626 var a = document.createElement("a");
627 a.href = "#" + entry.element.id;
628 a.appendChild(document.createTextNode(entry.text));
629 var div = document.createElement("div");
630 div.appendChild(a);
631 div.className = "toclevel" + entry.toclevel;
632 toc.appendChild(div);
633 }
634 if (entries.length == 0)
635 toc.parentNode.removeChild(toc);
636},
637
638
639/////////////////////////////////////////////////////////////////////
640// Footnotes generator
641/////////////////////////////////////////////////////////////////////
642
643/* Based on footnote generation code from:
644 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
645 */
646
647footnotes: function () {
Junio C Hamano9d971152012-12-19 00:43:11648 // Delete existing footnote entries in case we're reloading the footnodes.
649 var i;
Junio C Hamano7bd050f2011-09-22 06:32:22650 var noteholder = document.getElementById("footnotes");
Junio C Hamano9d971152012-12-19 00:43:11651 if (!noteholder) {
652 return;
653 }
654 var entriesToRemove = [];
655 for (i = 0; i < noteholder.childNodes.length; i++) {
656 var entry = noteholder.childNodes[i];
Junio C Hamanoc14e6ad2014-10-31 20:25:53657 if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
Junio C Hamano9d971152012-12-19 00:43:11658 entriesToRemove.push(entry);
659 }
660 for (i = 0; i < entriesToRemove.length; i++) {
661 noteholder.removeChild(entriesToRemove[i]);
662 }
663
664 // Rebuild footnote entries.
665 var cont = document.getElementById("content");
Junio C Hamano7bd050f2011-09-22 06:32:22666 var spans = cont.getElementsByTagName("span");
667 var refs = {};
668 var n = 0;
669 for (i=0; i<spans.length; i++) {
670 if (spans[i].className == "footnote") {
671 n++;
Junio C Hamano9d971152012-12-19 00:43:11672 var note = spans[i].getAttribute("data-note");
673 if (!note) {
674 // Use [\s\S] in place of . so multi-line matches work.
675 // Because JavaScript has no s (dotall) regex flag.
676 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
677 spans[i].innerHTML =
678 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
679 "' title='View footnote' class='footnote'>" + n + "</a>]";
680 spans[i].setAttribute("data-note", note);
681 }
Junio C Hamano7bd050f2011-09-22 06:32:22682 noteholder.innerHTML +=
683 "<div class='footnote' id='_footnote_" + n + "'>" +
684 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
685 n + "</a>. " + note + "</div>";
Junio C Hamano7bd050f2011-09-22 06:32:22686 var id =spans[i].getAttribute("id");
687 if (id != null) refs["#"+id] = n;
688 }
689 }
690 if (n == 0)
691 noteholder.parentNode.removeChild(noteholder);
692 else {
693 // Process footnoterefs.
694 for (i=0; i<spans.length; i++) {
695 if (spans[i].className == "footnoteref") {
696 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
697 href = href.match(/#.*/)[0]; // Because IE return full URL.
698 n = refs[href];
699 spans[i].innerHTML =
700 "[<a href='#_footnote_" + n +
701 "' title='View footnote' class='footnote'>" + n + "</a>]";
702 }
703 }
704 }
Junio C Hamano9d971152012-12-19 00:43:11705},
706
707install: function(toclevels) {
708 var timerId;
709
710 function reinstall() {
711 asciidoc.footnotes();
712 if (toclevels) {
713 asciidoc.toc(toclevels);
714 }
715 }
716
717 function reinstallAndRemoveTimer() {
718 clearInterval(timerId);
719 reinstall();
720 }
721
722 timerId = setInterval(reinstall, 500);
723 if (document.addEventListener)
724 document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
725 else
726 window.onload = reinstallAndRemoveTimer;
Junio C Hamano7bd050f2011-09-22 06:32:22727}
728
729}
Junio C Hamano9d971152012-12-19 00:43:11730asciidoc.install();
Junio C Hamano7bd050f2011-09-22 06:32:22731/*]]>*/
732</script>
Junio C Hamano1a4e8412005-12-27 08:17:23733</head>
Junio C Hamano9d971152012-12-19 00:43:11734<body class="manpage">
Junio C Hamano1a4e8412005-12-27 08:17:23735<div id="header">
736<h1>
737git-reset(1) Manual Page
738</h1>
739<h2>NAME</h2>
740<div class="sectionbody">
741<p>git-reset -
Junio C Hamano01078922006-03-10 00:31:47742 Reset current HEAD to the specified state
Junio C Hamano1a4e8412005-12-27 08:17:23743</p>
744</div>
745</div>
Junio C Hamano7bd050f2011-09-22 06:32:22746<div id="content">
Junio C Hamano9d971152012-12-19 00:43:11747<div class="sect1">
Junio C Hamano68cf15a2010-11-06 01:01:59748<h2 id="_synopsis">SYNOPSIS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23749<div class="sectionbody">
Junio C Hamanod793de52006-12-26 09:11:43750<div class="verseblock">
Junio C Hamanoe77c5d02013-01-22 19:19:59751<pre class="content"><em>git reset</em> [-q] [&lt;tree-ish&gt;] [--] &lt;paths&gt;&#8230;
Junio C Hamano4e1d0cb2013-07-19 20:43:00752<em>git reset</em> (--patch | -p) [&lt;tree-ish&gt;] [--] [&lt;paths&gt;&#8230;]
Junio C Hamano5b3533d2014-02-27 23:07:15753<em>git reset</em> [--soft | --mixed [-N] | --hard | --merge | --keep] [-q] [&lt;commit&gt;]</pre>
Junio C Hamano9d971152012-12-19 00:43:11754<div class="attribution">
Junio C Hamano68cf15a2010-11-06 01:01:59755</div></div>
Junio C Hamano1a4e8412005-12-27 08:17:23756</div>
Junio C Hamano9d971152012-12-19 00:43:11757</div>
758<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31759<h2 id="_description">DESCRIPTION</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23760<div class="sectionbody">
Junio C Hamanoe77c5d02013-01-22 19:19:59761<div class="paragraph"><p>In the first and second form, copy entries from &lt;tree-ish&gt; to the index.
Junio C Hamano657fd8a2010-10-07 00:01:24762In the third form, set the current branch head (HEAD) to &lt;commit&gt;, optionally
Junio C Hamanoe77c5d02013-01-22 19:19:59763modifying index and working tree to match. The &lt;tree-ish&gt;/&lt;commit&gt; defaults
764to HEAD in all forms.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59765<div class="dlist"><dl>
766<dt class="hdlist1">
Junio C Hamanoe77c5d02013-01-22 19:19:59767<em>git reset</em> [-q] [&lt;tree-ish&gt;] [--] &lt;paths&gt;&#8230;
Junio C Hamano1a4e8412005-12-27 08:17:23768</dt>
769<dd>
770<p>
Junio C Hamanob5a296f2010-08-13 02:46:36771 This form resets the index entries for all &lt;paths&gt; to their
Junio C Hamanod75148a2014-04-08 19:48:38772 state at &lt;tree-ish&gt;. (It does not affect the working tree or
Junio C Hamanob5a296f2010-08-13 02:46:36773 the current branch.)
Junio C Hamano1a4e8412005-12-27 08:17:23774</p>
Junio C Hamanoc14e6ad2014-10-31 20:25:53775<div class="paragraph"><p>This means that <code>git reset &lt;paths&gt;</code> is the opposite of <code>git add
776&lt;paths&gt;</code>.</p></div>
777<div class="paragraph"><p>After running <code>git reset &lt;paths&gt;</code> to update the index entry, you can
Junio C Hamanoa28a9202012-06-21 07:08:23778use <a href="git-checkout.html">git-checkout(1)</a> to check the contents out of the index to
Junio C Hamano657fd8a2010-10-07 00:01:24779the working tree.
Junio C Hamanoa28a9202012-06-21 07:08:23780Alternatively, using <a href="git-checkout.html">git-checkout(1)</a> and specifying a commit, you
Junio C Hamano657fd8a2010-10-07 00:01:24781can copy the contents of a path out of a commit to the index and to the
782working tree in one go.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23783</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59784<dt class="hdlist1">
Junio C Hamanoe77c5d02013-01-22 19:19:59785<em>git reset</em> (--patch | -p) [&lt;tree-ish&gt;] [--] [&lt;paths&gt;&#8230;]
Junio C Hamanob5a296f2010-08-13 02:46:36786</dt>
787<dd>
788<p>
789 Interactively select hunks in the difference between the index
Junio C Hamanoe77c5d02013-01-22 19:19:59790 and &lt;tree-ish&gt; (defaults to HEAD). The chosen hunks are applied
Junio C Hamanob5a296f2010-08-13 02:46:36791 in reverse to the index.
792</p>
Junio C Hamanoc14e6ad2014-10-31 20:25:53793<div class="paragraph"><p>This means that <code>git reset -p</code> is the opposite of <code>git add -p</code>, i.e.
Junio C Hamano9d971152012-12-19 00:43:11794you can use it to selectively reset hunks. See the &#8220;Interactive Mode&#8221;
Junio C Hamanoc14e6ad2014-10-31 20:25:53795section of <a href="git-add.html">git-add(1)</a> to learn how to operate the <code>--patch</code> mode.</p></div>
Junio C Hamanob5a296f2010-08-13 02:46:36796</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59797<dt class="hdlist1">
Junio C Hamanoa1295452012-11-13 22:32:04798<em>git reset</em> [&lt;mode&gt;] [&lt;commit&gt;]
Junio C Hamanob5a296f2010-08-13 02:46:36799</dt>
800<dd>
801<p>
Junio C Hamano657fd8a2010-10-07 00:01:24802 This form resets the current branch head to &lt;commit&gt; and
803 possibly updates the index (resetting it to the tree of &lt;commit&gt;) and
Junio C Hamanoa1295452012-11-13 22:32:04804 the working tree depending on &lt;mode&gt;. If &lt;mode&gt; is omitted,
805 defaults to "--mixed". The &lt;mode&gt; must be one of the following:
Junio C Hamanob5a296f2010-08-13 02:46:36806</p>
Junio C Hamano9d971152012-12-19 00:43:11807<div class="openblock">
808<div class="content">
Junio C Hamano68cf15a2010-11-06 01:01:59809<div class="dlist"><dl>
810<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23811--soft
812</dt>
813<dd>
814<p>
Junio C Hamanod75148a2014-04-08 19:48:38815 Does not touch the index file or the working tree at all (but
Junio C Hamano657fd8a2010-10-07 00:01:24816 resets the head to &lt;commit&gt;, just like all modes do). This leaves
817 all your changed files "Changes to be committed", as <em>git status</em>
818 would put it.
Junio C Hamano1a4e8412005-12-27 08:17:23819</p>
820</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59821<dt class="hdlist1">
Junio C Hamanob5a296f2010-08-13 02:46:36822--mixed
823</dt>
824<dd>
825<p>
826 Resets the index but not the working tree (i.e., the changed files
827 are preserved but not marked for commit) and reports what has not
828 been updated. This is the default action.
829</p>
Junio C Hamanoc14e6ad2014-10-31 20:25:53830<div class="paragraph"><p>If <code>-N</code> is specified, removed paths are marked as intent-to-add (see
Junio C Hamano5b3533d2014-02-27 23:07:15831<a href="git-add.html">git-add(1)</a>).</p></div>
Junio C Hamanob5a296f2010-08-13 02:46:36832</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59833<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23834--hard
835</dt>
836<dd>
837<p>
Junio C Hamano657fd8a2010-10-07 00:01:24838 Resets the index and working tree. Any changes to tracked files in the
839 working tree since &lt;commit&gt; are discarded.
Junio C Hamano1a4e8412005-12-27 08:17:23840</p>
841</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59842<dt class="hdlist1">
Junio C Hamanobbbb8652008-12-29 10:34:22843--merge
844</dt>
845<dd>
846<p>
Junio C Hamano657fd8a2010-10-07 00:01:24847 Resets the index and updates the files in the working tree that are
848 different between &lt;commit&gt; and HEAD, but keeps those which are
849 different between the index and working tree (i.e. which have changes
850 which have not been added).
851 If a file that is different between &lt;commit&gt; and the index has unstaged
Junio C Hamano68cf15a2010-11-06 01:01:59852 changes, reset is aborted.
Junio C Hamanobbbb8652008-12-29 10:34:22853</p>
Junio C Hamano68cf15a2010-11-06 01:01:59854<div class="paragraph"><p>In other words, --merge does something like a <em>git read-tree -u -m &lt;commit&gt;</em>,
855but carries forward unmerged index entries.</p></div>
Junio C Hamanobbbb8652008-12-29 10:34:22856</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59857<dt class="hdlist1">
Junio C Hamano0299d922010-03-20 20:59:31858--keep
859</dt>
860<dd>
861<p>
Junio C Hamano20338b42011-01-22 00:51:59862 Resets index entries and updates files in the working tree that are
863 different between &lt;commit&gt; and HEAD.
Junio C Hamano657fd8a2010-10-07 00:01:24864 If a file that is different between &lt;commit&gt; and HEAD has local changes,
Junio C Hamano68cf15a2010-11-06 01:01:59865 reset is aborted.
Junio C Hamano0299d922010-03-20 20:59:31866</p>
867</dd>
Junio C Hamanob5a296f2010-08-13 02:46:36868</dl></div>
Junio C Hamano9d971152012-12-19 00:43:11869</div></div>
Junio C Hamanoc28068f2009-09-08 00:55:23870</dd>
Junio C Hamanob5a296f2010-08-13 02:46:36871</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59872<div class="paragraph"><p>If you want to undo a commit other than the latest on a branch,
Junio C Hamanoa28a9202012-06-21 07:08:23873<a href="git-revert.html">git-revert(1)</a> is your friend.</p></div>
Junio C Hamanob5a296f2010-08-13 02:46:36874</div>
Junio C Hamano9d971152012-12-19 00:43:11875</div>
876<div class="sect1">
Junio C Hamanob5a296f2010-08-13 02:46:36877<h2 id="_options">OPTIONS</h2>
878<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59879<div class="dlist"><dl>
880<dt class="hdlist1">
Junio C Hamano422cfec2007-11-08 08:07:45881-q
882</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59883<dt class="hdlist1">
Junio C Hamanob141a922010-01-10 19:55:14884--quiet
885</dt>
Junio C Hamano422cfec2007-11-08 08:07:45886<dd>
887<p>
888 Be quiet, only report errors.
889</p>
890</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31891</dl></div>
Junio C Hamano1bb569e2006-05-05 23:14:25892</div>
Junio C Hamano9d971152012-12-19 00:43:11893</div>
894<div class="sect1">
Junio C Hamanob5a296f2010-08-13 02:46:36895<h2 id="_examples">EXAMPLES</h2>
Junio C Hamano1bb569e2006-05-05 23:14:25896<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59897<div class="dlist"><dl>
898<dt class="hdlist1">
Junio C Hamano89d4e0f2007-02-18 00:34:59899Undo add
Junio C Hamano1a4e8412005-12-27 08:17:23900</dt>
901<dd>
902<div class="listingblock">
903<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53904<pre><code>$ edit <b>&lt;1&gt;</b>
Junio C Hamano89d4e0f2007-02-18 00:34:59905$ git add frotz.c filfre.c
Junio C Hamano68cf15a2010-11-06 01:01:59906$ mailx <b>&lt;2&gt;</b>
907$ git reset <b>&lt;3&gt;</b>
Junio C Hamanoc14e6ad2014-10-31 20:25:53908$ git pull git://info.example.com/ nitfol <b>&lt;4&gt;</b></code></pre>
Junio C Hamanoc8d88c22006-04-29 07:02:01909</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59910<div class="colist arabic"><ol>
Junio C Hamanoc8d88c22006-04-29 07:02:01911<li>
912<p>
Junio C Hamano092f5f02007-08-02 07:23:38913You are happily working on something, and find the changes
Junio C Hamano1a4e8412005-12-27 08:17:23914in these files are in good order. You do not want to see them
915when you run "git diff", because you plan to work on other files
916and changes with these files are distracting.
Junio C Hamanoc8d88c22006-04-29 07:02:01917</p>
918</li>
919<li>
920<p>
Junio C Hamano092f5f02007-08-02 07:23:38921Somebody asks you to pull, and the changes sounds worthy of merging.
Junio C Hamanoc8d88c22006-04-29 07:02:01922</p>
923</li>
924<li>
925<p>
Junio C Hamano092f5f02007-08-02 07:23:38926However, you already dirtied the index (i.e. your index does
Junio C Hamano1a4e8412005-12-27 08:17:23927not match the HEAD commit). But you know the pull you are going
Junio C Hamanod75148a2014-04-08 19:48:38928to make does not affect frotz.c or filfre.c, so you revert the
Junio C Hamano1a4e8412005-12-27 08:17:23929index changes for these two files. Your changes in working tree
930remain there.
Junio C Hamanoc8d88c22006-04-29 07:02:01931</p>
932</li>
933<li>
934<p>
Junio C Hamano092f5f02007-08-02 07:23:38935Then you can pull and merge, leaving frotz.c and filfre.c
Junio C Hamanoc8d88c22006-04-29 07:02:01936changes still in the working tree.
937</p>
938</li>
Junio C Hamanoba4b9282008-07-06 05:20:31939</ol></div>
Junio C Hamano1a4e8412005-12-27 08:17:23940</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59941<dt class="hdlist1">
Junio C Hamanob5a296f2010-08-13 02:46:36942Undo a commit and redo
943</dt>
944<dd>
945<div class="listingblock">
946<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53947<pre><code>$ git commit ...
Junio C Hamano68cf15a2010-11-06 01:01:59948$ git reset --soft HEAD^ <b>&lt;1&gt;</b>
949$ edit <b>&lt;2&gt;</b>
Junio C Hamanoc14e6ad2014-10-31 20:25:53950$ git commit -a -c ORIG_HEAD <b>&lt;3&gt;</b></code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:36951</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59952<div class="colist arabic"><ol>
Junio C Hamanob5a296f2010-08-13 02:46:36953<li>
954<p>
955This is most often done when you remembered what you
956just committed is incomplete, or you misspelled your commit
957message, or both. Leaves working tree as it was before "reset".
958</p>
959</li>
960<li>
961<p>
962Make corrections to working tree files.
963</p>
964</li>
965<li>
966<p>
967"reset" copies the old head to .git/ORIG_HEAD; redo the
968commit by starting with its log message. If you do not need to
969edit the message further, you can give -C option instead.
970</p>
Junio C Hamanoa28a9202012-06-21 07:08:23971<div class="paragraph"><p>See also the --amend option to <a href="git-commit.html">git-commit(1)</a>.</p></div>
Junio C Hamanob5a296f2010-08-13 02:46:36972</li>
973</ol></div>
974</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59975<dt class="hdlist1">
Junio C Hamanob5a296f2010-08-13 02:46:36976Undo a commit, making it a topic branch
977</dt>
978<dd>
979<div class="listingblock">
980<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53981<pre><code>$ git branch topic/wip <b>&lt;1&gt;</b>
Junio C Hamano68cf15a2010-11-06 01:01:59982$ git reset --hard HEAD~3 <b>&lt;2&gt;</b>
Junio C Hamanoc14e6ad2014-10-31 20:25:53983$ git checkout topic/wip <b>&lt;3&gt;</b></code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:36984</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59985<div class="colist arabic"><ol>
Junio C Hamanob5a296f2010-08-13 02:46:36986<li>
987<p>
988You have made some commits, but realize they were premature
989to be in the "master" branch. You want to continue polishing
990them in a topic branch, so create "topic/wip" branch off of the
991current HEAD.
992</p>
993</li>
994<li>
995<p>
996Rewind the master branch to get rid of those three commits.
997</p>
998</li>
999<li>
1000<p>
1001Switch to "topic/wip" branch and keep working.
1002</p>
1003</li>
1004</ol></div>
1005</dd>
Junio C Hamano68cf15a2010-11-06 01:01:591006<dt class="hdlist1">
Junio C Hamanob5a296f2010-08-13 02:46:361007Undo commits permanently
1008</dt>
1009<dd>
1010<div class="listingblock">
1011<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531012<pre><code>$ git commit ...
1013$ git reset --hard HEAD~3 <b>&lt;1&gt;</b></code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:361014</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591015<div class="colist arabic"><ol>
Junio C Hamanob5a296f2010-08-13 02:46:361016<li>
1017<p>
1018The last three commits (HEAD, HEAD^, and HEAD~2) were bad
1019and you do not want to ever see them again. Do <strong>not</strong> do this if
1020you have already given these commits to somebody else. (See the
Junio C Hamanoa28a9202012-06-21 07:08:231021"RECOVERING FROM UPSTREAM REBASE" section in <a href="git-rebase.html">git-rebase(1)</a> for
Junio C Hamanob5a296f2010-08-13 02:46:361022the implications of doing so.)
1023</p>
1024</li>
1025</ol></div>
1026</dd>
Junio C Hamano68cf15a2010-11-06 01:01:591027<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:231028Undo a merge or pull
1029</dt>
1030<dd>
1031<div class="listingblock">
1032<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531033<pre><code>$ git pull <b>&lt;1&gt;</b>
Junio C Hamano1a4e8412005-12-27 08:17:231034Auto-merging nitfol
1035CONFLICT (content): Merge conflict in nitfol
Junio C Hamano6a3c8272008-12-19 21:38:181036Automatic merge failed; fix conflicts and then commit the result.
Junio C Hamano68cf15a2010-11-06 01:01:591037$ git reset --hard <b>&lt;2&gt;</b>
1038$ git pull . topic/branch <b>&lt;3&gt;</b>
Junio C Hamano1a4e8412005-12-27 08:17:231039Updating from 41223... to 13134...
Junio C Hamano3f680f32009-11-16 02:10:541040Fast-forward
Junio C Hamanoc14e6ad2014-10-31 20:25:531041$ git reset --hard ORIG_HEAD <b>&lt;4&gt;</b></code></pre>
Junio C Hamanoc8d88c22006-04-29 07:02:011042</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591043<div class="colist arabic"><ol>
Junio C Hamanoc8d88c22006-04-29 07:02:011044<li>
1045<p>
Junio C Hamano092f5f02007-08-02 07:23:381046Try to update from the upstream resulted in a lot of
Junio C Hamanoc8d88c22006-04-29 07:02:011047conflicts; you were not ready to spend a lot of time merging
1048right now, so you decide to do that later.
1049</p>
1050</li>
1051<li>
1052<p>
1053"pull" has not made merge commit, so "git reset --hard"
1054which is a synonym for "git reset --hard HEAD" clears the mess
1055from the index file and the working tree.
1056</p>
1057</li>
1058<li>
1059<p>
Junio C Hamano092f5f02007-08-02 07:23:381060Merge a topic branch into the current branch, which resulted
Junio C Hamano3f680f32009-11-16 02:10:541061in a fast-forward.
Junio C Hamanoc8d88c22006-04-29 07:02:011062</p>
1063</li>
1064<li>
1065<p>
Junio C Hamano092f5f02007-08-02 07:23:381066But you decided that the topic branch is not ready for public
Junio C Hamano1a4e8412005-12-27 08:17:231067consumption yet. "pull" or "merge" always leaves the original
1068tip of the current branch in ORIG_HEAD, so resetting hard to it
1069brings your index file and the working tree back to that state,
Junio C Hamanoc8d88c22006-04-29 07:02:011070and resets the tip of the branch to that commit.
1071</p>
1072</li>
Junio C Hamanoba4b9282008-07-06 05:20:311073</ol></div>
Junio C Hamano1a4e8412005-12-27 08:17:231074</dd>
Junio C Hamano68cf15a2010-11-06 01:01:591075<dt class="hdlist1">
Junio C Hamano657fd8a2010-10-07 00:01:241076Undo a merge or pull inside a dirty working tree
Junio C Hamanobbbb8652008-12-29 10:34:221077</dt>
1078<dd>
1079<div class="listingblock">
1080<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531081<pre><code>$ git pull <b>&lt;1&gt;</b>
Junio C Hamanobbbb8652008-12-29 10:34:221082Auto-merging nitfol
1083Merge made by recursive.
1084 nitfol | 20 +++++----
1085 ...
Junio C Hamanoc14e6ad2014-10-31 20:25:531086$ git reset --merge ORIG_HEAD <b>&lt;2&gt;</b></code></pre>
Junio C Hamanobbbb8652008-12-29 10:34:221087</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591088<div class="colist arabic"><ol>
Junio C Hamanobbbb8652008-12-29 10:34:221089<li>
1090<p>
1091Even if you may have local modifications in your
1092working tree, you can safely say "git pull" when you know
1093that the change in the other branch does not overlap with
1094them.
1095</p>
1096</li>
1097<li>
1098<p>
1099After inspecting the result of the merge, you may find
1100that the change in the other branch is unsatisfactory. Running
1101"git reset --hard ORIG_HEAD" will let you go back to where you
1102were, but it will discard your local changes, which you do not
1103want. "git reset --merge" keeps your local changes.
1104</p>
1105</li>
1106</ol></div>
1107</dd>
Junio C Hamano68cf15a2010-11-06 01:01:591108<dt class="hdlist1">
Junio C Hamano74e8a2d2006-01-14 03:58:411109Interrupted workflow
1110</dt>
1111<dd>
Junio C Hamano68cf15a2010-11-06 01:01:591112<div class="paragraph"><p>Suppose you are interrupted by an urgent fix request while you
Junio C Hamanoa6331a82006-01-22 07:50:331113are in the middle of a large change. The files in your
Junio C Hamano74e8a2d2006-01-14 03:58:411114working tree are not in any shape to be committed yet, but you
Junio C Hamanoba4b9282008-07-06 05:20:311115need to get to the other branch for a quick bugfix.</p></div>
Junio C Hamano74e8a2d2006-01-14 03:58:411116<div class="listingblock">
1117<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531118<pre><code>$ git checkout feature ;# you were working in "feature" branch and
Junio C Hamano74e8a2d2006-01-14 03:58:411119$ work work work ;# got interrupted
Junio C Hamano68cf15a2010-11-06 01:01:591120$ git commit -a -m "snapshot WIP" <b>&lt;1&gt;</b>
Junio C Hamano74e8a2d2006-01-14 03:58:411121$ git checkout master
1122$ fix fix fix
1123$ git commit ;# commit with real log
1124$ git checkout feature
Junio C Hamano68cf15a2010-11-06 01:01:591125$ git reset --soft HEAD^ ;# go back to WIP state <b>&lt;2&gt;</b>
Junio C Hamanoc14e6ad2014-10-31 20:25:531126$ git reset <b>&lt;3&gt;</b></code></pre>
Junio C Hamano74e8a2d2006-01-14 03:58:411127</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591128<div class="colist arabic"><ol>
Junio C Hamanoc8d88c22006-04-29 07:02:011129<li>
1130<p>
1131This commit will get blown away so a throw-away log message is OK.
1132</p>
1133</li>
1134<li>
1135<p>
1136This removes the <em>WIP</em> commit from the commit history, and sets
1137 your working tree to the state just before you made that snapshot.
1138</p>
1139</li>
1140<li>
1141<p>
1142At this point the index file still has all the WIP changes you
1143 committed as <em>snapshot WIP</em>. This updates the index to show your
1144 WIP files as uncommitted.
1145</p>
Junio C Hamanoa28a9202012-06-21 07:08:231146<div class="paragraph"><p>See also <a href="git-stash.html">git-stash(1)</a>.</p></div>
Junio C Hamanoc8d88c22006-04-29 07:02:011147</li>
Junio C Hamanoba4b9282008-07-06 05:20:311148</ol></div>
Junio C Hamano74e8a2d2006-01-14 03:58:411149</dd>
Junio C Hamano68cf15a2010-11-06 01:01:591150<dt class="hdlist1">
Junio C Hamano26e590a2008-02-17 03:53:511151Reset a single file in the index
1152</dt>
1153<dd>
Junio C Hamano68cf15a2010-11-06 01:01:591154<div class="paragraph"><p>Suppose you have added a file to your index, but later decide you do not
Junio C Hamano26e590a2008-02-17 03:53:511155want to add it to your commit. You can remove the file from the index
Junio C Hamanoba4b9282008-07-06 05:20:311156while keeping your changes with git reset.</p></div>
Junio C Hamano26e590a2008-02-17 03:53:511157<div class="listingblock">
1158<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531159<pre><code>$ git reset -- frotz.c <b>&lt;1&gt;</b>
Junio C Hamano68cf15a2010-11-06 01:01:591160$ git commit -m "Commit files in index" <b>&lt;2&gt;</b>
Junio C Hamanoc14e6ad2014-10-31 20:25:531161$ git add frotz.c <b>&lt;3&gt;</b></code></pre>
Junio C Hamano26e590a2008-02-17 03:53:511162</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591163<div class="colist arabic"><ol>
Junio C Hamano26e590a2008-02-17 03:53:511164<li>
1165<p>
1166This removes the file from the index while keeping it in the working
1167 directory.
1168</p>
1169</li>
1170<li>
1171<p>
1172This commits all other changes in the index.
1173</p>
1174</li>
1175<li>
1176<p>
1177Adds the file to the index again.
1178</p>
1179</li>
Junio C Hamanoba4b9282008-07-06 05:20:311180</ol></div>
Junio C Hamano26e590a2008-02-17 03:53:511181</dd>
Junio C Hamano68cf15a2010-11-06 01:01:591182<dt class="hdlist1">
Junio C Hamano0299d922010-03-20 20:59:311183Keep changes in working tree while discarding some previous commits
1184</dt>
1185<dd>
Junio C Hamano68cf15a2010-11-06 01:01:591186<div class="paragraph"><p>Suppose you are working on something and you commit it, and then you
Junio C Hamano0299d922010-03-20 20:59:311187continue working a bit more, but now you think that what you have in
1188your working tree should be in another branch that has nothing to do
Junio C Hamano619596a2010-08-18 22:15:351189with what you committed previously. You can start a new branch and
Junio C Hamano657fd8a2010-10-07 00:01:241190reset it while keeping the changes in your working tree.</p></div>
Junio C Hamano0299d922010-03-20 20:59:311191<div class="listingblock">
1192<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531193<pre><code>$ git tag start
Junio C Hamano0299d922010-03-20 20:59:311194$ git checkout -b branch1
1195$ edit
Junio C Hamano68cf15a2010-11-06 01:01:591196$ git commit ... <b>&lt;1&gt;</b>
Junio C Hamano0299d922010-03-20 20:59:311197$ edit
Junio C Hamano68cf15a2010-11-06 01:01:591198$ git checkout -b branch2 <b>&lt;2&gt;</b>
Junio C Hamanoc14e6ad2014-10-31 20:25:531199$ git reset --keep start <b>&lt;3&gt;</b></code></pre>
Junio C Hamano0299d922010-03-20 20:59:311200</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591201<div class="colist arabic"><ol>
Junio C Hamano0299d922010-03-20 20:59:311202<li>
1203<p>
1204This commits your first edits in branch1.
1205</p>
1206</li>
1207<li>
1208<p>
1209In the ideal world, you could have realized that the earlier
1210 commit did not belong to the new topic when you created and switched
1211 to branch2 (i.e. "git checkout -b branch2 start"), but nobody is
1212 perfect.
1213</p>
1214</li>
1215<li>
1216<p>
1217But you can use "reset --keep" to remove the unwanted commit after
1218 you switched to "branch2".
1219</p>
1220</li>
1221</ol></div>
1222</dd>
Junio C Hamanoba4b9282008-07-06 05:20:311223</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:231224</div>
Junio C Hamano9d971152012-12-19 00:43:111225</div>
1226<div class="sect1">
Junio C Hamanob5a296f2010-08-13 02:46:361227<h2 id="_discussion">DISCUSSION</h2>
1228<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:591229<div class="paragraph"><p>The tables below show what happens when running:</p></div>
Junio C Hamanob5a296f2010-08-13 02:46:361230<div class="listingblock">
1231<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531232<pre><code>git reset --option target</code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:361233</div></div>
Junio C Hamanoc14e6ad2014-10-31 20:25:531234<div class="paragraph"><p>to reset the HEAD to another commit (<code>target</code>) with the different
Junio C Hamanob5a296f2010-08-13 02:46:361235reset options depending on the state of the files.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:591236<div class="paragraph"><p>In these tables, A, B, C and D are some different states of a
Junio C Hamanob5a296f2010-08-13 02:46:361237file. For example, the first line of the first table means that if a
1238file is in state A in the working tree, in state B in the index, in
1239state C in HEAD and in state D in the target, then "git reset --soft
Junio C Hamano657fd8a2010-10-07 00:01:241240target" will leave the file in the working tree in state A and in the
1241index in state B. It resets (i.e. moves) the HEAD (i.e. the tip of
1242the current branch, if you are on one) to "target" (which has the file
1243in state D).</p></div>
Junio C Hamanob5a296f2010-08-13 02:46:361244<div class="literalblock">
1245<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531246<pre><code>working index HEAD target working index HEAD
Junio C Hamanob5a296f2010-08-13 02:46:361247----------------------------------------------------
1248 A B C D --soft A B D
1249 --mixed A D D
1250 --hard D D D
1251 --merge (disallowed)
Junio C Hamanoc14e6ad2014-10-31 20:25:531252 --keep (disallowed)</code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:361253</div></div>
1254<div class="literalblock">
1255<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531256<pre><code>working index HEAD target working index HEAD
Junio C Hamanob5a296f2010-08-13 02:46:361257----------------------------------------------------
1258 A B C C --soft A B C
1259 --mixed A C C
1260 --hard C C C
1261 --merge (disallowed)
Junio C Hamanoc14e6ad2014-10-31 20:25:531262 --keep A C C</code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:361263</div></div>
1264<div class="literalblock">
1265<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531266<pre><code>working index HEAD target working index HEAD
Junio C Hamanob5a296f2010-08-13 02:46:361267----------------------------------------------------
1268 B B C D --soft B B D
1269 --mixed B D D
1270 --hard D D D
1271 --merge D D D
Junio C Hamanoc14e6ad2014-10-31 20:25:531272 --keep (disallowed)</code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:361273</div></div>
1274<div class="literalblock">
1275<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531276<pre><code>working index HEAD target working index HEAD
Junio C Hamanob5a296f2010-08-13 02:46:361277----------------------------------------------------
1278 B B C C --soft B B C
1279 --mixed B C C
1280 --hard C C C
1281 --merge C C C
Junio C Hamanoc14e6ad2014-10-31 20:25:531282 --keep B C C</code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:361283</div></div>
1284<div class="literalblock">
1285<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531286<pre><code>working index HEAD target working index HEAD
Junio C Hamanob5a296f2010-08-13 02:46:361287----------------------------------------------------
1288 B C C D --soft B C D
1289 --mixed B D D
1290 --hard D D D
1291 --merge (disallowed)
Junio C Hamanoc14e6ad2014-10-31 20:25:531292 --keep (disallowed)</code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:361293</div></div>
1294<div class="literalblock">
1295<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531296<pre><code>working index HEAD target working index HEAD
Junio C Hamanob5a296f2010-08-13 02:46:361297----------------------------------------------------
1298 B C C C --soft B C C
1299 --mixed B C C
1300 --hard C C C
1301 --merge B C C
Junio C Hamanoc14e6ad2014-10-31 20:25:531302 --keep B C C</code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:361303</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591304<div class="paragraph"><p>"reset --merge" is meant to be used when resetting out of a conflicted
Junio C Hamano657fd8a2010-10-07 00:01:241305merge. Any mergy operation guarantees that the working tree file that is
Junio C Hamanob5a296f2010-08-13 02:46:361306involved in the merge does not have local change wrt the index before
Junio C Hamano657fd8a2010-10-07 00:01:241307it starts, and that it writes the result out to the working tree. So if
Junio C Hamanob5a296f2010-08-13 02:46:361308we see some difference between the index and the target and also
Junio C Hamano657fd8a2010-10-07 00:01:241309between the index and the working tree, then it means that we are not
Junio C Hamanob5a296f2010-08-13 02:46:361310resetting out from a state that a mergy operation left after failing
1311with a conflict. That is why we disallow --merge option in this case.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:591312<div class="paragraph"><p>"reset --keep" is meant to be used when removing some of the last
Junio C Hamanob5a296f2010-08-13 02:46:361313commits in the current branch while keeping changes in the working
1314tree. If there could be conflicts between the changes in the commit we
1315want to remove and the changes in the working tree we want to keep,
Junio C Hamano68cf15a2010-11-06 01:01:591316the reset is disallowed. That&#8217;s why it is disallowed if there are both
Junio C Hamanob5a296f2010-08-13 02:46:361317changes between the working tree and HEAD, and between HEAD and the
1318target. To be safe, it is also disallowed when there are unmerged
1319entries.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:591320<div class="paragraph"><p>The following tables show what happens when there are unmerged
Junio C Hamanob5a296f2010-08-13 02:46:361321entries:</p></div>
1322<div class="literalblock">
1323<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531324<pre><code>working index HEAD target working index HEAD
Junio C Hamanob5a296f2010-08-13 02:46:361325----------------------------------------------------
1326 X U A B --soft (disallowed)
1327 --mixed X B B
1328 --hard B B B
1329 --merge B B B
Junio C Hamanoc14e6ad2014-10-31 20:25:531330 --keep (disallowed)</code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:361331</div></div>
1332<div class="literalblock">
1333<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:531334<pre><code>working index HEAD target working index HEAD
Junio C Hamanob5a296f2010-08-13 02:46:361335----------------------------------------------------
1336 X U A A --soft (disallowed)
1337 --mixed X A A
1338 --hard A A A
1339 --merge A A A
Junio C Hamanoc14e6ad2014-10-31 20:25:531340 --keep (disallowed)</code></pre>
Junio C Hamanob5a296f2010-08-13 02:46:361341</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:591342<div class="paragraph"><p>X means any state and U means an unmerged index.</p></div>
Junio C Hamanob5a296f2010-08-13 02:46:361343</div>
Junio C Hamano9d971152012-12-19 00:43:111344</div>
1345<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:311346<h2 id="_git">GIT</h2>
Junio C Hamano1a4e8412005-12-27 08:17:231347<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:231348<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:231349</div>
Junio C Hamano7bd050f2011-09-22 06:32:221350</div>
Junio C Hamano9d971152012-12-19 00:43:111351</div>
Junio C Hamano7bd050f2011-09-22 06:32:221352<div id="footnotes"><hr /></div>
Junio C Hamano1a4e8412005-12-27 08:17:231353<div id="footer">
1354<div id="footer-text">
Junio C Hamanod75148a2014-04-08 19:48:381355Last updated 2014-04-08 12:47:26 PDT
Junio C Hamano1a4e8412005-12-27 08:17:231356</div>
1357</div>
1358</body>
1359</html>