Artifact 89c914e396d6fa1fb5db5b43c794e5d407d64345:
File www/cmd_update.wiki part of check-in [51868cb12f] - Changed update docs, ** ADDED A _SPECIAL_ (but MUTYPE_BLOCK) wikitag <annotation> to put html comments in wikimarkup by kkennell on 2009-01-30 21:18:10.
0000: 3c 68 32 3e 75 70 64 61 74 65 3c 2f 68 32 3e 0a <h2>update</h2>. 0010: 0a 3c 75 3e 55 70 64 61 74 69 6e 67 3c 2f 75 3e .<u>Updating</u> 0020: 20 61 20 72 65 70 6f 73 69 74 6f 72 79 20 69 73 a repository is 0030: 20 74 68 65 20 70 72 6f 63 65 73 73 20 6f 66 20 the process of 0040: 61 70 70 6c 79 69 6e 67 20 74 6f 20 69 74 20 63 applying to it c 0050: 68 61 6e 67 65 73 0a 6d 61 64 65 20 62 79 20 65 hanges.made by e 0060: 78 74 65 72 6e 61 6c 20 65 6e 74 69 74 69 65 73 xternal entities 0070: 2e 20 20 43 6f 6e 74 72 61 73 74 20 74 68 69 73 . Contrast this 0080: 20 77 69 74 68 20 5b 2e 2f 63 6d 64 5f 63 6f 6d with [./cmd_com 0090: 6d 69 74 2e 77 69 6b 69 20 7c 0a 63 6f 6d 6d 69 mit.wiki |.commi 00a0: 74 5d 69 6e 67 20 61 20 6c 6f 63 61 6c 6c 79 20 t]ing a locally 00b0: 6d 61 64 65 20 63 68 61 6e 67 65 3b 20 75 70 64 made change; upd 00c0: 61 74 69 6e 67 20 69 73 20 61 20 62 69 74 20 6c ating is a bit l 00d0: 69 6b 65 20 22 63 6f 6d 6d 69 74 74 69 6e 67 22 ike "committing" 00e0: 0a 65 78 74 65 72 6e 61 6c 20 63 68 61 6e 67 65 .external change 00f0: 73 20 74 6f 20 74 68 65 20 6c 6f 63 61 6c 20 72 s to the local r 0100: 65 70 6f 2e 0a 0a 55 70 64 61 74 65 20 3c 65 6d epo...Update <em 0110: 3e 6d 65 72 67 65 73 3c 2f 65 6d 3e 20 63 68 61 >merges</em> cha 0120: 6e 67 65 73 20 66 72 6f 6d 20 74 68 65 20 72 65 nges from the re 0130: 70 6f 73 69 74 6f 72 79 20 69 6e 74 6f 20 79 6f pository into yo 0140: 75 72 20 63 68 65 63 6b 6f 75 74 2e 0a 54 68 61 ur checkout..Tha 0150: 74 20 6d 65 61 6e 73 20 74 68 61 74 20 69 74 20 t means that it 0160: 77 6f 6e 27 74 20 68 61 76 65 20 61 6e 79 20 65 won't have any e 0170: 66 66 65 63 74 20 75 6e 6c 65 73 73 20 74 68 65 ffect unless the 0180: 72 65 20 3c 69 3e 61 72 65 3c 2f 69 3e 0a 63 68 re <i>are</i>.ch 0190: 61 6e 67 65 73 20 69 6e 20 74 68 65 20 72 65 70 anges in the rep 01a0: 6f 73 69 74 6f 72 79 2e 20 20 54 68 65 20 6f 6e ository. The on 01b0: 6c 79 20 77 61 79 20 74 68 65 20 63 68 65 63 6b ly way the check 01c0: 6f 75 74 20 63 61 6e 20 61 66 66 65 63 74 0a 74 out can affect.t 01d0: 68 65 20 72 65 70 6f 20 28 74 68 69 73 20 69 73 he repo (this is 01e0: 20 74 68 65 20 6c 6f 63 61 6c 20 72 65 70 6f 20 the local repo 01f0: 77 65 27 72 65 20 74 61 6c 6b 69 6e 67 20 61 62 we're talking ab 0200: 6f 75 74 29 20 69 73 20 69 66 20 79 6f 75 0a 64 out) is if you.d 0210: 6f 20 61 20 5b 2e 2f 63 6d 64 5f 63 6f 6d 6d 69 o a [./cmd_commi 0220: 74 2e 77 69 6b 69 20 7c 20 3c 63 6f 64 65 3e 63 t.wiki | <code>c 0230: 69 3c 2f 63 6f 64 65 3e 5d 2e 20 20 53 6f 2c 20 i</code>]. So, 0240: 3c 63 6f 64 65 3e 75 70 64 61 74 65 3c 2f 63 6f <code>update</co 0250: 64 65 3e 0a 6f 6e 6c 79 20 72 65 61 6c 6c 79 20 de>.only really 0260: 6d 61 6b 65 73 20 73 65 6e 73 65 20 69 66 20 79 makes sense if y 0270: 6f 75 20 68 61 76 65 0a 5b 2e 2f 63 6d 64 5f 70 ou have.[./cmd_p 0280: 75 6c 6c 2e 77 69 6b 69 20 7c 20 3c 63 6f 64 65 ull.wiki | <code 0290: 3e 70 75 6c 6c 3c 2f 63 6f 64 65 3e 5d 65 64 20 >pull</code>]ed 02a0: 63 68 61 6e 67 65 73 20 66 72 6f 6d 20 74 68 65 changes from the 02b0: 20 6d 61 73 74 65 72 20 72 65 70 6f 73 69 74 6f master reposito 02c0: 72 79 0a 69 6e 74 6f 20 74 68 65 20 6c 6f 63 61 ry.into the loca 02d0: 6c 20 72 65 70 6f 73 69 74 6f 72 79 2e 0a 0a 3c l repository...< 02e0: 61 6e 6e 6f 74 61 74 69 6f 6e 3e 0a 20 20 4e 6f annotation>. No 02f0: 74 65 20 3a 0a 20 20 72 65 61 6c 6c 79 20 72 65 te :. really re 0300: 61 6c 6c 79 20 6e 65 65 64 20 61 20 71 75 69 63 ally need a quic 0310: 6b 20 6f 76 65 72 76 69 65 77 20 6f 66 20 74 68 k overview of th 0320: 65 20 70 75 6c 6c 2d 75 70 64 61 74 65 2d 65 64 e pull-update-ed 0330: 69 74 2d 63 6f 6d 6d 69 74 2d 70 75 73 68 0a 20 it-commit-push. 0340: 20 77 6f 72 6b 66 6c 6f 77 2c 20 61 6e 64 20 74 workflow, and t 0350: 68 65 20 73 68 6f 72 74 63 75 74 73 20 66 6f 72 he shortcuts for 0360: 20 74 68 61 74 2c 20 61 6e 64 20 72 65 2d 65 6d that, and re-em 0370: 70 68 61 73 69 7a 65 20 74 68 65 20 72 6f 6c 65 phasize the role 0380: 20 6f 66 20 61 75 74 6f 73 79 6e 63 0a 20 20 69 of autosync. i 0390: 6e 20 63 68 61 6e 67 69 6e 67 20 74 68 65 20 62 n changing the b 03a0: 61 73 69 63 20 6e 61 74 75 72 65 20 6f 66 20 74 asic nature of t 03b0: 68 65 20 77 6f 72 6b 66 6c 6f 77 0a 3c 2f 61 6e he workflow.</an 03c0: 6e 6f 74 61 74 69 6f 6e 3e 0a 0a 4c 6f 63 61 6c notation>..Local 03d0: 20 69 6e 74 72 61 6e 65 74 20 3c 63 6f 64 65 3e intranet <code> 03e0: 5b 2e 2f 63 6d 64 5f 63 6f 6d 6d 69 74 2e 77 69 [./cmd_commit.wi 03f0: 6b 69 20 7c 20 63 6f 6d 6d 69 74 5d 3c 2f 63 6f ki | commit]</co 0400: 64 65 3e 73 0a 28 62 79 20 73 6f 6d 65 6f 6e 65 de>s.(by someone 0410: 20 65 6c 73 65 29 0a 6f 72 20 4e 65 74 20 3c 63 else).or Net <c 0420: 6f 64 65 3e 5b 2e 2f 63 6d 64 5f 70 75 6c 6c 2e ode>[./cmd_pull. 0430: 77 69 6b 69 20 7c 20 70 75 6c 6c 5d 3c 2f 63 6f wiki | pull]</co 0440: 64 65 3e 73 20 66 72 6f 6d 20 61 20 73 65 72 76 de>s from a serv 0450: 65 72 0a 77 69 6c 6c 20 75 73 75 61 6c 6c 79 20 er.will usually 0460: 72 65 71 75 69 72 65 20 61 20 3c 63 6f 64 65 3e require a <code> 0470: 66 6f 73 73 69 6c 26 6e 62 73 70 3b 75 70 64 61 fossil upda 0480: 74 65 3c 2f 63 6f 64 65 3e 20 61 66 74 65 72 77 te</code> afterw 0490: 61 72 64 2c 0a 62 65 63 61 75 73 65 20 74 68 65 ard,.because the 04a0: 79 20 61 72 65 20 6c 69 6b 65 6c 79 20 6e 6f 74 y are likely not 04b0: 20 74 6f 20 62 65 20 64 6f 6e 65 20 69 6e 0a 5b to be done in.[ 04c0: 2e 2f 63 6d 64 5f 73 65 74 74 69 6e 67 73 2e 77 ./cmd_settings.w 04d0: 69 6b 69 23 61 75 74 6f 73 79 6e 63 20 7c 20 61 iki#autosync | a 04e0: 75 74 6f 73 79 6e 63 5d 0a 6d 6f 64 65 2e 0a 0a utosync].mode... 04f0: 4c 6f 63 61 6c 20 63 6f 6d 6d 69 74 73 20 61 72 Local commits ar 0500: 65 20 6c 69 6b 65 6c 79 20 74 6f 20 62 65 20 6d e likely to be m 0510: 61 64 65 20 77 69 74 68 0a 5b 2e 2f 63 6d 64 5f ade with.[./cmd_ 0520: 73 65 74 74 69 6e 67 73 2e 77 69 6b 69 23 61 75 settings.wiki#au 0530: 74 6f 73 79 6e 63 20 7c 20 61 75 74 6f 6d 61 74 tosync | automat 0540: 69 63 20 73 79 6e 63 69 6e 67 5d 0a 73 65 74 20 ic syncing].set 0550: 74 6f 20 22 6f 6e 22 2c 20 68 6f 77 65 76 65 72 to "on", however 0560: 2c 20 73 6f 20 69 66 20 79 6f 75 20 64 6f 6e 27 , so if you don' 0570: 74 20 75 73 65 20 3c 62 3e 66 6f 73 73 69 6c 3c t use <b>fossil< 0580: 2f 62 3e 20 66 6f 72 20 4e 65 74 2d 77 69 64 65 /b> for Net-wide 0590: 0a 70 72 6f 6a 65 63 74 73 20 79 6f 75 20 6d 61 .projects you ma 05a0: 79 20 6e 65 76 65 72 20 68 61 76 65 20 74 6f 20 y never have to 05b0: 75 73 65 20 3c 63 6f 64 65 3e 75 70 64 61 74 65 use <code>update 05c0: 3c 2f 63 6f 64 65 3e 2e 0a 0a 53 65 65 20 61 6c </code>...See al 05d0: 73 6f 3a 20 5b 2e 2f 63 6d 64 5f 70 75 6c 6c 2e so: [./cmd_pull. 05e0: 77 69 6b 69 20 7c 20 66 6f 73 73 69 6c 20 70 75 wiki | fossil pu 05f0: 6c 6c 5d 2c 0a 5b 2e 2f 63 6d 64 5f 63 6f 6d 6d ll],.[./cmd_comm 0600: 69 74 2e 77 69 6b 69 20 7c 20 66 6f 73 73 69 6c it.wiki | fossil 0610: 20 63 6f 6d 6d 69 74 5d 2c 0a 5b 2e 2f 63 6d 64 commit],.[./cmd 0620: 5f 73 65 74 74 69 6e 67 73 2e 77 69 6b 69 23 61 _settings.wiki#a 0630: 75 74 6f 73 79 6e 63 20 7c 20 66 6f 73 73 69 6c utosync | fossil 0640: 20 73 65 74 74 69 6e 67 5d 20 28 61 75 74 6f 73 setting] (autos 0650: 79 6e 63 29 2c 0a 5b 2e 2f 62 72 61 6e 63 68 69 ync),.[./branchi 0660: 6e 67 2e 77 69 6b 69 20 7c 20 3c 69 3e 62 72 61 ng.wiki | <i>bra 0670: 6e 63 68 69 6e 67 2c 20 6d 65 72 67 69 6e 67 2c nching, merging, 0680: 20 66 6f 72 6b 69 6e 67 20 61 6e 64 20 74 61 67 forking and tag 0690: 67 69 6e 67 3c 2f 69 3e 5d 2c 0a 5b 2e 2f 72 65 ging</i>],.[./re 06a0: 66 65 72 65 6e 63 65 2e 77 69 6b 69 20 7c 20 52 ference.wiki | R 06b0: 65 66 65 72 65 6e 63 65 5d 0a eference].