Hex Artifact Content
Not logged in

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].