Artifact f5fbdc276ee75a142b76e2c20ee1ba0ced54019d:
File
www/cmd_extra.wiki
part of check-in
[9eb6ea75c1]
- doc changes -- spelling corrections and embedded ref pages.
by
kejoki on
2008-11-11 03:50:39.
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 20 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 0d 0a 70 72 6f 6a 65 63 74 20 69 your..project i
0360: 73 20 62 69 67 2c 20 61 6e 64 20 79 6f 75 20 77 s big, and you w
0370: 61 6e 74 20 74 6f 20 66 69 6e 64 20 6e 6f 6f 64 ant to find nood
0380: 6c 65 2e 73 72 63 2c 20 61 6e 64 20 61 6e 79 74 le.src, and anyt
0390: 68 69 6e 67 20 65 6c 73 65 20 74 68 61 74 20 69 hing else that i
03a0: 73 6e 27 74 0d 0a 75 6e 64 65 72 20 73 6f 75 72 sn't..under sour
03b0: 63 65 20 63 6f 6e 74 72 6f 6c 20 77 69 74 68 69 ce control withi
03c0: 6e 20 74 68 65 20 70 72 6f 6a 65 63 74 20 64 69 n the project di
03d0: 72 65 63 74 6f 72 69 65 73 2c 20 74 68 65 6e 20 rectories, then
03e0: 0d 0a 3c 63 6f 64 65 3e 66 6f 73 73 69 6c 26 6e ..<code>fossil&n
03f0: 62 73 70 3b 65 78 74 72 61 3c 2f 63 6f 64 65 3e bsp;extra</code>
0400: 20 77 69 6c 6c 20 67 69 76 65 20 79 6f 75 20 61 will give you a
0410: 20 6c 69 73 74 2e 0d 0a 0d 0a 49 66 20 79 6f 75 list.....If you
0420: 20 64 6f 6e 27 74 20 74 68 69 6e 6b 20 74 68 69 don't think thi
0430: 73 20 69 73 20 61 6c 6c 20 74 68 61 74 20 75 73 s is all that us
0440: 65 66 75 6c 2c 20 74 68 65 6e 20 79 6f 75 27 76 eful, then you'v
0450: 65 20 6e 65 76 65 72 20 68 61 64 20 74 6f 20 77 e never had to w
0460: 72 69 74 65 0d 0a 61 20 73 68 65 6c 6c 20 73 63 rite..a shell sc
0470: 72 69 70 74 20 74 68 61 74 20 6f 6e 6c 79 20 61 ript that only a
0480: 66 66 65 63 74 73 20 70 72 6f 6a 65 63 74 20 66 ffects project f
0490: 69 6c 65 73 20 61 6e 64 20 6c 65 61 76 65 73 20 iles and leaves
04a0: 65 76 65 72 79 74 68 69 6e 67 0d 0a 65 6c 73 65 everything..else
04b0: 20 61 6c 6f 6e 65 2e 20 20 3b 29 0d 0a 0d 0a 54 alone. ;)....T
04c0: 68 65 20 3c 63 6f 64 65 3e 65 78 74 72 61 3c 2f he <code>extra</
04d0: 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 20 69 73 code> command is
04e0: 20 61 6c 6d 6f 73 74 2c 20 62 75 74 20 6e 6f 74 almost, but not
04f0: 20 71 75 69 74 65 20 65 6e 74 69 72 65 6c 79 2c quite entirely,
0500: 20 74 68 65 20 65 78 61 63 74 0d 0a 6f 70 70 6f the exact..oppo
0510: 73 69 74 65 20 6f 66 20 74 68 65 20 3c 61 20 68 site of the <a h
0520: 72 65 66 3d 22 77 69 6b 69 3f 6e 61 6d 65 3d 66 ref="wiki?name=f
0530: 6f 73 73 69 6c 2b 6c 73 22 3e 3c 63 6f 64 65 3e ossil+ls"><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 5b 66 6f 73 73 69 6c 20 63 6c 65 61 so: [fossil clea
0570: 6e 5d 2c 20 5b 66 6f 73 73 69 6c 20 6c 73 5d 2c n], [fossil ls],
0580: 20 5b 52 65 66 65 72 65 6e 63 65 5d 0a [Reference].