| blob | ac175366a639d73fcbf24ff5f074479c678425a6 |
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 /* Overrides for manpage documents */
343 h1 {
348 }
349 h2 {
351 }
354 }
358 }
360 /* Workarounds for IE6's broken and incomplete CSS2. */
366 }
373 }
379 }
384 }
388 }
392 }
397 }
399 /* IE6 sets dynamically generated links as visited. */
401 </style>
402 </head>
403 <body>
405 <h1>
406 git-update-ref(1) Manual Page
407 </h1>
410 <p>git-update-ref -
411 Update the object name stored in a ref safely
412 </p>
413 </div>
414 </div>
417 <div class="paragraph"><p><em>git update-ref</em> [-m <reason>] (-d <ref> [<oldvalue>] | [--no-deref] <ref> <newvalue> [<oldvalue>])</p></div>
418 </div>
421 <div class="paragraph"><p>Given two arguments, stores the <newvalue> in the <ref>, possibly
422 dereferencing the symbolic refs. E.g. <tt>git update-ref HEAD
424 <div class="paragraph"><p>Given three arguments, stores the <newvalue> in the <ref>,
425 possibly dereferencing the symbolic refs, after verifying that
431 not exist.</p></div>
433 ref file by starting with the four-byte header sequence of
436 these symbolic pointers, whether they are symlinks or these
438 if they start with "refs/": otherwise it will just try to read
439 them and update them as a regular file (i.e. it will allow the
440 filesystem to follow them, but will overwrite such a symlink to
441 somewhere else with a regular filename).</p></div>
442 <div class="paragraph"><p>If --no-deref is given, <ref> itself is overwritten, rather than
443 the result of following the symbolic pointers.</p></div>
448 </div></div>
453 </div></div>
454 <div class="paragraph"><p>both from a symlink following standpoint <strong>and</strong> an error checking
455 standpoint. The "refs/" rule for symlinks means that symlinks
457 for reading but not for writing (so we’ll never write through a
458 ref symlink to some other tree, if you have copied a whole
459 archive by creating a symlink tree).</p></div>
460 <div class="paragraph"><p>With <tt>-d</tt> flag, it deletes the named <ref> after verifying it
462 </div>
467 a line to the log file "$GIT_DIR/logs/<ref>" (dereferencing all
468 symbolic refs before creating the log name) describing the change
469 in ref value. Log lines are formatted as:</p></div>
471 <li>
472 <p>
473 oldsha1 SP newsha1 SP committer LF
474 </p>
478 and date in the standard GIT committer ident format.</p></div>
479 </li>
480 </ol></div>
483 <li>
484 <p>
485 oldsha1 SP newsha1 SP committer TAB message LF
486 </p>
488 value supplied to the -m option.</p></div>
489 </li>
490 </ol></div>
491 <div class="paragraph"><p>An update will fail (without changing <ref>) if the current user is
492 unable to create a new log file, append to the existing log file
493 or does not have committer information available.</p></div>
494 </div>
498 </div>
502 </div>
503 </div>
504 </body>
505 </html>