Artifact 1f2aed88d1b481c7fa8019c5cfd25a55b3407555:
File www/cmd_extra.wiki part of check-in [f15298fd4e] - Change the reference docs to embedded (still need to remove wiki versions); add the mv|rename command. by kejoki on 2008-11-12 03:46:34.
0000: 3c 68 32 3e 65 78 74 72 61 3c 2f 68 32 3e 0d 0a <h2>extra</h2>.. 0010: 0d 0a 54 68 65 20 3c 63 6f 64 65 3e 65 78 74 72 ..The <code>extr 0020: 61 3c 2f 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 a</code> command 0030: 20 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 61 is informationa 0040: 6c 2c 20 69 74 20 64 6f 65 73 6e 27 74 20 64 6f l, it doesn't do 0050: 20 61 6e 79 74 68 69 6e 67 20 74 6f 0d 0a 61 20 anything to..a 0060: 63 68 65 63 6b 65 64 2d 6f 75 74 20 70 72 6f 6a checked-out proj 0070: 65 63 74 2c 20 62 75 74 20 69 74 20 74 65 6c 6c ect, but it tell 0080: 73 20 79 6f 75 20 73 6f 6d 65 74 68 69 6e 67 20 s you something 0090: 61 62 6f 75 74 20 69 74 2e 0d 0a 0d 0a 45 78 74 about it.....Ext 00a0: 72 61 20 66 69 6c 65 73 20 61 72 65 20 66 69 6c ra files are fil 00b0: 65 73 20 74 68 61 74 20 65 78 69 73 74 20 69 6e es that exist in 00c0: 20 61 20 63 68 65 63 6b 65 64 2d 6f 75 74 20 70 a checked-out p 00d0: 72 6f 6a 65 63 74 2c 20 62 75 74 20 64 6f 6e 27 roject, but don' 00e0: 74 20 62 65 6c 6f 6e 67 20 74 6f 0d 0a 74 68 65 t belong to..the 00f0: 20 72 65 70 6f 73 69 74 6f 72 79 2e 0d 0a 0d 0a repository..... 0100: 54 68 65 20 3c 63 6f 64 65 3e 66 6f 73 73 69 6c The <code>fossil 0110: 20 65 78 74 72 61 3c 2f 63 6f 64 65 3e 20 63 6f extra</code> co 0120: 6d 6d 61 6e 64 20 77 69 6c 6c 20 67 65 74 20 79 mmand will get y 0130: 6f 75 20 61 20 6c 69 73 74 20 6f 66 20 74 68 65 ou a list of the 0140: 73 65 20 66 69 6c 65 73 2e 0d 0a 0d 0a 54 68 69 se files.....Thi 0150: 73 20 69 73 20 63 6f 6e 76 65 6e 69 65 6e 74 20 s is convenient 0160: 66 6f 72 20 66 69 67 75 72 69 6e 67 20 6f 75 74 for figuring out 0170: 20 69 66 20 79 6f 75 27 76 65 20 3c 63 6f 64 65 if you've <code 0180: 3e 61 64 64 3c 2f 63 6f 64 65 3e 65 64 20 65 76 >add</code>ed ev 0190: 65 72 79 20 66 69 6c 65 0d 0a 74 68 61 74 20 6e ery file..that n 01a0: 65 65 64 73 20 74 6f 20 62 65 20 69 6e 20 74 68 eeds to be in th 01b0: 65 20 72 65 70 6f 73 69 74 6f 72 79 20 62 65 66 e repository bef 01c0: 6f 72 65 20 79 6f 75 20 64 6f 20 61 20 63 6f 6d ore you do a com 01d0: 6d 69 74 2e 20 20 49 74 20 77 69 6c 6c 20 61 6c mit. It will al 01e0: 73 6f 0d 0a 74 65 6c 6c 20 79 6f 75 20 77 68 61 so..tell you wha 01f0: 74 20 77 69 6c 6c 20 62 65 20 72 65 6d 6f 76 65 t will be remove 0200: 64 20 69 66 20 79 6f 75 20 3c 63 6f 64 65 3e 63 d if you <code>c 0210: 6c 65 61 6e 3c 2f 63 6f 64 65 3e 20 74 68 65 20 lean</code> the 0220: 70 72 6f 6a 65 63 74 2e 0d 0a 0d 0a 53 75 70 70 project.....Supp 0230: 6f 73 65 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 ose, for example 0240: 2c 20 79 6f 75 20 68 61 76 65 20 61 20 22 6e 6f , you have a "no 0250: 6f 64 6c 65 2e 73 72 63 22 20 66 69 6c 65 20 61 odle.src" file a 0260: 73 20 61 20 73 63 72 61 74 63 68 20 70 61 64 20 s a scratch pad 0270: 66 6f 72 20 73 6f 75 72 63 65 0d 0a 63 6f 64 65 for source..code 0280: 2c 20 61 6e 64 20 79 6f 75 20 64 6f 6e 27 74 20 , and you don't 0290: 77 61 6e 74 20 74 6f 20 69 6e 63 6c 75 64 65 20 want to include 02a0: 79 6f 75 72 20 6c 61 74 65 73 74 20 68 61 72 65 your latest hare 02b0: 2d 62 72 61 69 6e 65 64 20 69 64 65 61 73 20 69 -brained ideas i 02c0: 6e 20 74 68 65 0d 0a 72 65 70 6f 73 69 74 6f 72 n the..repositor 02d0: 79 3f 20 20 59 6f 75 20 64 6f 6e 27 74 20 3c 63 y? You don't <c 02e0: 6f 64 65 3e 61 64 64 3c 2f 63 6f 64 65 3e 20 69 ode>add</code> i 02f0: 74 20 74 6f 20 74 68 65 20 72 65 70 6f 73 69 74 t to the reposit 0300: 6f 72 79 2c 20 6f 66 20 63 6f 75 72 73 65 26 23 ory, of course&# 0310: 38 32 31 32 3b 74 68 6f 75 67 68 0a 74 68 65 72 8212;though.ther 0320: 65 20 61 72 65 20 77 61 79 73 20 79 6f 75 20 6d e are ways you m 0330: 69 67 68 74 20 61 64 64 20 69 74 20 75 6e 69 6e ight add it unin 0340: 74 65 6e 74 69 6f 6e 61 6c 6c 79 2e 20 20 49 66 tentionally. If 0350: 20 79 6f 75 72 20 70 72 6f 6a 65 63 74 20 69 73 your project is 0360: 20 62 69 67 2c 20 61 6e 64 20 79 6f 75 20 77 61 big, and you wa 0370: 6e 74 20 74 6f 0a 66 69 6e 64 20 6e 6f 6f 64 6c nt to.find noodl 0380: 65 2e 73 72 63 2c 20 61 6e 64 20 61 6e 79 74 68 e.src, and anyth 0390: 69 6e 67 20 65 6c 73 65 20 74 68 61 74 20 69 73 ing else that is 03a0: 6e 27 74 20 75 6e 64 65 72 20 73 6f 75 72 63 65 n't under source 03b0: 20 63 6f 6e 74 72 6f 6c 20 77 69 74 68 69 6e 20 control within 03c0: 74 68 65 20 70 72 6f 6a 65 63 74 0a 64 69 72 65 the project.dire 03d0: 63 74 6f 72 69 65 73 2c 20 74 68 65 6e 3c 63 6f ctories, then<co 03e0: 64 65 3e 20 66 6f 73 73 69 6c 26 6e 62 73 70 3b de> fossil 03f0: 65 78 74 72 61 20 3c 2f 63 6f 64 65 3e 20 77 69 extra </code> wi 0400: 6c 6c 20 67 69 76 65 20 79 6f 75 20 61 20 6c 69 ll give you a li 0410: 73 74 2e 0d 0a 0d 0a 49 66 20 79 6f 75 20 64 6f st.....If you do 0420: 6e 27 74 20 74 68 69 6e 6b 20 74 68 69 73 20 69 n't think this i 0430: 73 20 61 6c 6c 20 74 68 61 74 20 75 73 65 66 75 s all that usefu 0440: 6c 2c 20 74 68 65 6e 20 79 6f 75 27 76 65 20 6e l, then you've n 0450: 65 76 65 72 20 68 61 64 20 74 6f 20 77 72 69 74 ever had to writ 0460: 65 0d 0a 61 20 73 68 65 6c 6c 20 73 63 72 69 70 e..a shell scrip 0470: 74 20 74 68 61 74 20 6f 6e 6c 79 20 61 66 66 65 t that only affe 0480: 63 74 73 20 70 72 6f 6a 65 63 74 20 66 69 6c 65 cts project file 0490: 73 20 61 6e 64 20 6c 65 61 76 65 73 20 65 76 65 s and leaves eve 04a0: 72 79 74 68 69 6e 67 0d 0a 65 6c 73 65 20 61 6c rything..else al 04b0: 6f 6e 65 2e 20 20 3b 29 0d 0a 0d 0a 54 68 65 20 one. ;)....The 04c0: 3c 63 6f 64 65 3e 65 78 74 72 61 3c 2f 63 6f 64 <code>extra</cod 04d0: 65 3e 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61 6c e> command is al 04e0: 6d 6f 73 74 2c 20 62 75 74 20 6e 6f 74 20 71 75 most, but not qu 04f0: 69 74 65 20 65 6e 74 69 72 65 6c 79 2c 20 74 68 ite entirely, th 0500: 65 20 65 78 61 63 74 0d 0a 6f 70 70 6f 73 69 74 e exact..opposit 0510: 65 20 6f 66 20 74 68 65 20 3c 61 20 68 72 65 66 e of the <a href 0520: 3d 22 64 6f 63 2f 74 69 70 2f 77 77 77 2f 63 6d ="doc/tip/www/cm 0530: 64 5f 6c 73 2e 77 69 6b 69 3e 3c 63 6f 64 65 3e d_ls.wiki><code> 0540: 6c 73 3c 2f 63 6f 64 65 3e 3c 2f 61 3e 20 63 6f ls</code></a> co 0550: 6d 6d 61 6e 64 2e 0d 0a 0d 0a 53 65 65 20 61 6c mmand.....See al 0560: 73 6f 3a 20 3c 61 20 68 72 65 66 3d 22 64 6f 63 so: <a href="doc 0570: 2f 74 69 70 2f 77 77 77 2f 63 6d 64 5f 63 6c 65 /tip/www/cmd_cle 0580: 61 6e 2e 77 69 6b 69 22 3e 66 6f 73 73 69 6c 20 an.wiki">fossil 0590: 63 6c 65 61 6e 3c 2f 61 3e 2c 20 3c 61 20 68 72 clean</a>, <a hr 05a0: 65 66 3d 22 64 6f 63 2f 74 69 70 2f 77 77 77 2f ef="doc/tip/www/ 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 20 3c 61 20 68 sil ls</a>, <a h 05d0: 72 65 66 3d 22 64 6f 63 2f 74 69 70 2f 77 77 77 ref="doc/tip/www 05e0: 2f 72 65 66 65 72 65 6e 63 65 2e 77 69 6b 69 22 /reference.wiki" 05f0: 3e 0a 52 65 66 65 72 65 6e 63 65 3c 2f 61 3e 0a >.Reference</a>.