Artifact 2878d797602d9dfa271f31015fcf428f10c509b6:
File www/cmd_extra.wiki part of check-in [44b3fc6b5b] - reference docs -- added 'all', minor edits to others. by kejoki on 2008-11-17 02:07:14.
0000: 3c 68 32 3e 65 78 74 72 61 3c 2f 68 32 3e 0a 0a <h2>extra</h2>.. 0010: 54 68 65 20 3c 63 6f 64 65 3e 65 78 74 72 61 3c The <code>extra< 0020: 2f 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 20 69 /code> command i 0030: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 61 6c 2c s informational, 0040: 20 69 74 20 64 6f 65 73 6e 27 74 20 64 6f 20 61 it doesn't do a 0050: 6e 79 74 68 69 6e 67 20 74 6f 0a 61 20 63 68 65 nything to.a che 0060: 63 6b 65 64 2d 6f 75 74 20 70 72 6f 6a 65 63 74 cked-out project 0070: 2c 20 62 75 74 20 69 74 20 74 65 6c 6c 73 20 79 , but it tells y 0080: 6f 75 20 73 6f 6d 65 74 68 69 6e 67 20 61 62 6f ou something abo 0090: 75 74 20 69 74 2e 0a 0a 45 78 74 72 61 20 66 69 ut it...Extra fi 00a0: 6c 65 73 20 61 72 65 20 66 69 6c 65 73 20 74 68 les are files th 00b0: 61 74 20 65 78 69 73 74 20 69 6e 20 61 20 63 68 at exist in a ch 00c0: 65 63 6b 65 64 2d 6f 75 74 20 70 72 6f 6a 65 63 ecked-out projec 00d0: 74 2c 20 62 75 74 20 64 6f 6e 27 74 20 62 65 6c t, but don't bel 00e0: 6f 6e 67 20 74 6f 0a 74 68 65 20 72 65 70 6f 73 ong to.the repos 00f0: 69 74 6f 72 79 2e 0a 0a 54 68 65 20 3c 63 6f 64 itory...The <cod 0100: 65 3e 66 6f 73 73 69 6c 20 65 78 74 72 61 3c 2f e>fossil extra</ 0110: 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 20 77 69 code> command wi 0120: 6c 6c 20 67 65 74 20 79 6f 75 20 61 20 6c 69 73 ll get you a lis 0130: 74 20 6f 66 20 74 68 65 73 65 20 66 69 6c 65 73 t of these files 0140: 2e 0a 0a 54 68 69 73 20 69 73 20 63 6f 6e 76 65 ...This is conve 0150: 6e 69 65 6e 74 20 66 6f 72 20 66 69 67 75 72 69 nient for figuri 0160: 6e 67 20 6f 75 74 20 69 66 20 79 6f 75 27 76 65 ng out if you've 0170: 20 3c 63 6f 64 65 3e 0a 3c 61 20 68 72 65 66 3d <code>.<a href= 0180: 22 63 6d 64 5f 61 64 64 2e 77 69 6b 69 22 3e 61 "cmd_add.wiki">a 0190: 64 64 3c 2f 61 3e 3c 2f 63 6f 64 65 3e 65 64 20 dd</a></code>ed 01a0: 65 76 65 72 79 20 66 69 6c 65 20 74 68 61 74 20 every file that 01b0: 6e 65 65 64 73 20 74 6f 20 62 65 0a 0a 69 6e 20 needs to be..in 01c0: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 62 the repository b 01d0: 65 66 6f 72 65 20 79 6f 75 20 64 6f 20 61 20 63 efore you do a c 01e0: 6f 6d 6d 69 74 2e 20 20 49 74 20 77 69 6c 6c 20 ommit. It will 01f0: 61 6c 73 6f 20 74 65 6c 6c 20 79 6f 75 20 77 68 also tell you wh 0200: 61 74 0a 77 69 6c 6c 20 62 65 20 72 65 6d 6f 76 at.will be remov 0210: 65 64 20 69 66 20 79 6f 75 20 3c 63 6f 64 65 3e ed if you <code> 0220: 3c 61 20 68 72 65 66 3d 22 63 6d 64 5f 63 6c 65 <a href="cmd_cle 0230: 61 6e 2e 77 69 6b 69 22 3e 63 6c 65 61 6e 3c 2f an.wiki">clean</ 0240: 61 3e 3c 2f 63 6f 64 65 3e 0a 74 68 65 20 70 72 a></code>.the pr 0250: 6f 6a 65 63 74 2e 0a 0a 53 75 70 70 6f 73 65 2c oject...Suppose, 0260: 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 79 6f for example, yo 0270: 75 20 68 61 76 65 20 61 20 22 6e 6f 6f 64 6c 65 u have a "noodle 0280: 2e 73 72 63 22 20 66 69 6c 65 20 61 73 20 61 20 .src" file as a 0290: 73 63 72 61 74 63 68 20 70 61 64 0a 66 6f 72 20 scratch pad.for 02a0: 73 6f 75 72 63 65 20 63 6f 64 65 2c 20 61 6e 64 source code, and 02b0: 20 79 6f 75 20 64 6f 6e 27 74 20 77 61 6e 74 20 you don't want 02c0: 74 6f 20 69 6e 63 6c 75 64 65 20 79 6f 75 72 20 to include your 02d0: 6c 61 74 65 73 74 0a 68 61 72 65 2d 62 72 61 69 latest.hare-brai 02e0: 6e 65 64 20 69 64 65 61 73 20 69 6e 20 74 68 65 ned ideas in the 02f0: 20 72 65 70 6f 73 69 74 6f 72 79 3f 20 20 59 6f repository? Yo 0300: 75 20 64 6f 6e 27 74 20 3c 63 6f 64 65 3e 61 64 u don't <code>ad 0310: 64 3c 2f 63 6f 64 65 3e 20 69 74 0a 74 6f 20 74 d</code> it.to t 0320: 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 6f he repository, o 0330: 66 20 63 6f 75 72 73 65 26 23 38 32 31 32 3b 74 f course—t 0340: 68 6f 75 67 68 20 74 68 65 72 65 20 61 72 65 20 hough there are 0350: 77 61 79 73 20 79 6f 75 20 6d 69 67 68 74 20 61 ways you might a 0360: 64 64 0a 69 74 20 75 6e 69 6e 74 65 6e 74 69 6f dd.it unintentio 0370: 6e 61 6c 6c 79 2e 20 20 49 66 20 79 6f 75 72 20 nally. If your 0380: 70 72 6f 6a 65 63 74 20 69 73 20 62 69 67 2c 20 project is big, 0390: 61 6e 64 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 and you want to 03a0: 66 69 6e 64 0a 6e 6f 6f 64 6c 65 2e 73 72 63 2c find.noodle.src, 03b0: 20 61 6e 64 20 61 6e 79 74 68 69 6e 67 20 65 6c and anything el 03c0: 73 65 20 74 68 61 74 20 69 73 6e 27 74 20 75 6e se that isn't un 03d0: 64 65 72 20 73 6f 75 72 63 65 20 63 6f 6e 74 72 der source contr 03e0: 6f 6c 20 77 69 74 68 69 6e 0a 74 68 65 20 70 72 ol within.the pr 03f0: 6f 6a 65 63 74 20 64 69 72 65 63 74 6f 72 69 65 oject directorie 0400: 73 2c 20 74 68 65 6e 3c 63 6f 64 65 3e 20 66 6f s, then<code> fo 0410: 73 73 69 6c 26 6e 62 73 70 3b 65 78 74 72 61 20 ssil extra 0420: 3c 2f 63 6f 64 65 3e 20 77 69 6c 6c 0a 67 69 76 </code> will.giv 0430: 65 20 79 6f 75 20 61 20 6c 69 73 74 2e 0a 0a 49 e you a list...I 0440: 66 20 79 6f 75 20 64 6f 6e 27 74 20 74 68 69 6e f you don't thin 0450: 6b 20 74 68 69 73 20 69 73 20 61 6c 6c 20 74 68 k this is all th 0460: 61 74 20 75 73 65 66 75 6c 2c 20 74 68 65 6e 20 at useful, then 0470: 79 6f 75 27 76 65 20 6e 65 76 65 72 20 68 61 64 you've never had 0480: 20 74 6f 20 77 72 69 74 65 0a 61 20 73 68 65 6c to write.a shel 0490: 6c 20 73 63 72 69 70 74 20 74 68 61 74 20 6f 6e l script that on 04a0: 6c 79 20 61 66 66 65 63 74 73 20 70 72 6f 6a 65 ly affects proje 04b0: 63 74 20 66 69 6c 65 73 20 61 6e 64 20 6c 65 61 ct files and lea 04c0: 76 65 73 20 65 76 65 72 79 74 68 69 6e 67 0a 65 ves everything.e 04d0: 6c 73 65 20 61 6c 6f 6e 65 2e 20 20 3b 29 0a 0a lse alone. ;).. 04e0: 54 68 65 20 3c 63 6f 64 65 3e 65 78 74 72 61 3c The <code>extra< 04f0: 2f 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 20 69 /code> command i 0500: 73 20 61 6c 6d 6f 73 74 2c 20 62 75 74 20 6e 6f s almost, but no 0510: 74 20 71 75 69 74 65 20 65 6e 74 69 72 65 6c 79 t quite entirely 0520: 2c 20 74 68 65 20 65 78 61 63 74 0a 6f 70 70 6f , the exact.oppo 0530: 73 69 74 65 20 6f 66 20 74 68 65 20 3c 63 6f 64 site of the <cod 0540: 65 3e 3c 61 20 68 72 65 66 3d 22 63 6d 64 5f 6c e><a href="cmd_l 0550: 73 2e 77 69 6b 69 22 3e 6c 73 3c 2f 61 3e 3c 2f s.wiki">ls</a></ 0560: 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 2e 0a 0a code> command... 0570: 53 65 65 20 61 6c 73 6f 3a 20 3c 61 20 68 72 65 See also: <a hre 0580: 66 3d 22 63 6d 64 5f 73 74 61 74 75 73 2e 77 69 f="cmd_status.wi 0590: 6b 69 22 3e 66 6f 73 73 69 6c 20 73 74 61 74 75 ki">fossil statu 05a0: 73 3c 2f 61 3e 2c 0a 3c 61 20 68 72 65 66 3d 22 s</a>,.<a href=" 05b0: 63 6d 64 5f 6c 73 2e 77 69 6b 69 22 3e 66 6f 73 cmd_ls.wiki">fos 05c0: 73 69 6c 20 6c 73 3c 2f 61 3e 2c 0a 3c 61 20 68 sil ls</a>,.<a h 05d0: 72 65 66 3d 22 63 6d 64 5f 63 68 61 6e 67 65 73 ref="cmd_changes 05e0: 2e 77 69 6b 69 22 3e 66 6f 73 73 69 6c 20 63 68 .wiki">fossil ch 05f0: 61 6e 67 65 73 3c 2f 61 3e 2c 0a 3c 61 20 68 72 anges</a>,.<a hr 0600: 65 66 3d 22 63 6d 64 5f 63 6c 65 61 6e 2e 77 69 ef="cmd_clean.wi 0610: 6b 69 22 3e 66 6f 73 73 69 6c 20 63 6c 65 61 6e ki">fossil clean 0620: 3c 2f 61 3e 2c 0a 3c 61 20 68 72 65 66 3d 22 72 </a>,.<a href="r 0630: 65 66 65 72 65 6e 63 65 2e 77 69 6b 69 22 3e 52 eference.wiki">R 0640: 65 66 65 72 65 6e 63 65 3c 2f 61 3e 0a eference</a>.