Artifact ffbd0d5ce685c6ab7df2fd129b5b651cfb32ebc2:
File www/cmd_extra.wiki part of check-in [1eb067d456] - Adjust some wikilinks, clean up main ref page, add "new" command. by kejoki on 2008-12-12 21:55:46.
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 5b 2e 2f 63 6d 64 5f 61 <code>.[./cmd_a 0180: 64 64 2e 77 69 6b 69 20 7c 20 61 64 64 5d 3c 2f dd.wiki | add]</ 0190: 63 6f 64 65 3e 65 64 20 65 76 65 72 79 20 66 69 code>ed every fi 01a0: 6c 65 20 74 68 61 74 20 6e 65 65 64 73 20 74 6f le that needs to 01b0: 20 62 65 0a 0a 69 6e 20 74 68 65 20 72 65 70 6f be..in the repo 01c0: 73 69 74 6f 72 79 20 62 65 66 6f 72 65 20 79 6f sitory before yo 01d0: 75 20 64 6f 20 61 20 63 6f 6d 6d 69 74 2e 20 20 u do a commit. 01e0: 49 74 20 77 69 6c 6c 20 61 6c 73 6f 20 74 65 6c It will also tel 01f0: 6c 20 79 6f 75 20 77 68 61 74 0a 77 69 6c 6c 20 l you what.will 0200: 62 65 20 72 65 6d 6f 76 65 64 20 69 66 20 79 6f be removed if yo 0210: 75 20 5b 2e 2f 63 6d 64 5f 63 6c 65 61 6e 2e 77 u [./cmd_clean.w 0220: 69 6b 69 20 7c 20 3c 63 6f 64 65 3e 63 6c 65 61 iki | <code>clea 0230: 6e 3c 2f 63 6f 64 65 3e 5d 0a 74 68 65 20 70 72 n</code>].the pr 0240: 6f 6a 65 63 74 2e 0a 0a 53 75 70 70 6f 73 65 2c oject...Suppose, 0250: 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 79 6f for example, yo 0260: 75 20 68 61 76 65 20 61 20 22 6e 6f 6f 64 6c 65 u have a "noodle 0270: 2e 73 72 63 22 20 66 69 6c 65 20 61 73 20 61 20 .src" file as a 0280: 73 63 72 61 74 63 68 20 70 61 64 0a 66 6f 72 20 scratch pad.for 0290: 73 6f 75 72 63 65 20 63 6f 64 65 2c 20 61 6e 64 source code, and 02a0: 20 79 6f 75 20 64 6f 6e 27 74 20 77 61 6e 74 20 you don't want 02b0: 74 6f 20 69 6e 63 6c 75 64 65 20 79 6f 75 72 20 to include your 02c0: 6c 61 74 65 73 74 0a 68 61 72 65 2d 62 72 61 69 latest.hare-brai 02d0: 6e 65 64 20 69 64 65 61 73 20 69 6e 20 74 68 65 ned ideas in the 02e0: 20 72 65 70 6f 73 69 74 6f 72 79 3f 20 20 59 6f repository? Yo 02f0: 75 20 64 6f 6e 27 74 20 3c 63 6f 64 65 3e 61 64 u don't <code>ad 0300: 64 3c 2f 63 6f 64 65 3e 20 69 74 0a 74 6f 20 74 d</code> it.to t 0310: 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2c 20 6f he repository, o 0320: 66 20 63 6f 75 72 73 65 26 23 38 32 31 32 3b 74 f course—t 0330: 68 6f 75 67 68 20 74 68 65 72 65 20 61 72 65 20 hough there are 0340: 77 61 79 73 20 79 6f 75 20 6d 69 67 68 74 20 61 ways you might a 0350: 64 64 0a 69 74 20 75 6e 69 6e 74 65 6e 74 69 6f dd.it unintentio 0360: 6e 61 6c 6c 79 2e 20 20 49 66 20 79 6f 75 72 20 nally. If your 0370: 70 72 6f 6a 65 63 74 20 69 73 20 62 69 67 2c 20 project is big, 0380: 61 6e 64 20 79 6f 75 20 77 61 6e 74 20 74 6f 20 and you want to 0390: 66 69 6e 64 0a 6e 6f 6f 64 6c 65 2e 73 72 63 2c find.noodle.src, 03a0: 20 61 6e 64 20 61 6e 79 74 68 69 6e 67 20 65 6c and anything el 03b0: 73 65 20 74 68 61 74 20 69 73 6e 27 74 20 75 6e se that isn't un 03c0: 64 65 72 20 73 6f 75 72 63 65 20 63 6f 6e 74 72 der source contr 03d0: 6f 6c 20 77 69 74 68 69 6e 0a 74 68 65 20 70 72 ol within.the pr 03e0: 6f 6a 65 63 74 20 64 69 72 65 63 74 6f 72 69 65 oject directorie 03f0: 73 2c 20 74 68 65 6e 3c 63 6f 64 65 3e 20 66 6f s, then<code> fo 0400: 73 73 69 6c 26 6e 62 73 70 3b 65 78 74 72 61 20 ssil extra 0410: 3c 2f 63 6f 64 65 3e 20 77 69 6c 6c 0a 67 69 76 </code> will.giv 0420: 65 20 79 6f 75 20 61 20 6c 69 73 74 2e 0a 0a 49 e you a list...I 0430: 66 20 79 6f 75 20 64 6f 6e 27 74 20 74 68 69 6e f you don't thin 0440: 6b 20 74 68 69 73 20 69 73 20 61 6c 6c 20 74 68 k this is all th 0450: 61 74 20 75 73 65 66 75 6c 2c 20 74 68 65 6e 20 at useful, then 0460: 79 6f 75 27 76 65 20 6e 65 76 65 72 20 68 61 64 you've never had 0470: 20 74 6f 20 77 72 69 74 65 0a 61 20 73 68 65 6c to write.a shel 0480: 6c 20 73 63 72 69 70 74 20 74 68 61 74 20 6f 6e l script that on 0490: 6c 79 20 61 66 66 65 63 74 73 20 70 72 6f 6a 65 ly affects proje 04a0: 63 74 20 66 69 6c 65 73 20 61 6e 64 20 6c 65 61 ct files and lea 04b0: 76 65 73 20 65 76 65 72 79 74 68 69 6e 67 0a 65 ves everything.e 04c0: 6c 73 65 20 61 6c 6f 6e 65 2e 20 20 3b 29 0a 0a lse alone. ;).. 04d0: 54 68 65 20 3c 63 6f 64 65 3e 65 78 74 72 61 3c The <code>extra< 04e0: 2f 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 20 69 /code> command i 04f0: 73 20 61 6c 6d 6f 73 74 2c 20 62 75 74 20 6e 6f s almost, but no 0500: 74 20 71 75 69 74 65 20 65 6e 74 69 72 65 6c 79 t quite entirely 0510: 2c 20 74 68 65 20 65 78 61 63 74 0a 6f 70 70 6f , the exact.oppo 0520: 73 69 74 65 20 6f 66 20 74 68 65 20 5b 2e 2f 63 site of the [./c 0530: 6d 64 5f 6c 73 2e 77 69 6b 69 20 7c 20 3c 63 6f md_ls.wiki | <co 0540: 64 65 3e 6c 73 3c 2f 63 6f 64 65 3e 5d 20 63 6f de>ls</code>] co 0550: 6d 6d 61 6e 64 2e 0a 0a 53 65 65 20 61 6c 73 6f mmand...See also 0560: 3a 20 5b 2e 2f 63 6d 64 5f 73 74 61 74 75 73 2e : [./cmd_status. 0570: 77 69 6b 69 20 7c 20 66 6f 73 73 69 6c 20 73 74 wiki | fossil st 0580: 61 74 75 73 5d 2c 0a 5b 2e 2f 63 6d 64 5f 6c 73 atus],.[./cmd_ls 0590: 2e 77 69 6b 69 20 7c 20 66 6f 73 73 69 6c 20 6c .wiki | fossil l 05a0: 73 5d 2c 0a 5b 2e 2f 63 6d 64 5f 63 68 61 6e 67 s],.[./cmd_chang 05b0: 65 73 2e 77 69 6b 69 20 7c 20 66 6f 73 73 69 6c es.wiki | fossil 05c0: 20 63 68 61 6e 67 65 73 5d 2c 0a 5b 2e 2f 63 6d changes],.[./cm 05d0: 64 5f 63 6c 65 61 6e 2e 77 69 6b 69 20 7c 20 66 d_clean.wiki | f 05e0: 6f 73 73 69 6c 20 63 6c 65 61 6e 5d 2c 0a 5b 2e ossil clean],.[. 05f0: 2f 72 65 66 65 72 65 6e 63 65 2e 77 69 6b 69 20 /reference.wiki 0600: 7c 20 52 65 66 65 72 65 6e 63 65 5d 0a | Reference].