Artifact ac4365faf45a49429c1dccac640df7d9ca57d5cb:
Wiki page [fossil ls] by kejoki on 2008-11-09 21:08:13.
0000: 44 20 32 30 30 38 2d 31 31 2d 30 39 54 32 31 3a D 2008-11-09T21: 0010: 30 38 3a 31 33 0a 4c 20 66 6f 73 73 69 6c 5c 73 08:13.L fossil\s 0020: 6c 73 0a 50 20 30 65 63 32 63 33 62 34 61 35 66 ls.P 0ec2c3b4a5f 0030: 65 30 39 37 61 66 31 64 62 34 37 63 64 34 62 64 e097af1db47cd4bd 0040: 31 38 39 37 36 63 35 64 30 30 66 66 63 0a 55 20 18976c5d00ffc.U 0050: 6b 65 6a 6f 6b 69 0a 57 20 32 35 32 30 0a 3c 68 kejoki.W 2520.<h 0060: 32 3e 6c 73 3c 2f 68 32 3e 0d 0a 0d 0a 54 68 65 2>ls</h2>....The 0070: 20 3c 63 6f 64 65 3e 6c 73 3c 2f 63 6f 64 65 3e <code>ls</code> 0080: 3c 61 20 68 72 65 66 3d 22 23 6e 6f 74 65 73 22 <a href="#notes" 0090: 3e 2a 3c 2f 61 3e 20 63 6f 6d 6d 61 6e 64 20 69 >*</a> command i 00a0: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 61 6c 2c s informational, 00b0: 20 69 74 20 64 6f 65 73 6e 27 74 20 64 6f 20 61 it doesn't do a 00c0: 6e 79 74 68 69 6e 67 20 74 6f 0d 0a 61 20 63 68 nything to..a ch 00d0: 65 63 6b 65 64 2d 6f 75 74 20 70 72 6f 6a 65 63 ecked-out projec 00e0: 74 2c 20 62 75 74 20 69 74 20 74 65 6c 6c 73 20 t, but it tells 00f0: 79 6f 75 20 73 6f 6d 65 74 68 69 6e 67 20 61 62 you something ab 0100: 6f 75 74 20 69 74 2e 0d 0a 0d 0a 41 20 70 72 6f out it.....A pro 0110: 6a 65 63 74 20 63 6f 6e 73 69 73 74 73 20 6f 66 ject consists of 0120: 20 61 20 22 73 6f 75 72 63 65 20 74 72 65 65 22 a "source tree" 0130: 20 6f 66 20 22 61 72 74 69 66 61 63 74 73 22 20 of "artifacts" 0140: 28 73 65 65 20 3c 61 20 68 72 65 66 3d 22 64 6f (see <a href="do 0150: 63 2f 74 69 70 2f 77 77 77 2f 63 6f 6e 63 65 70 c/tip/www/concep 0160: 74 73 2e 77 69 6b 69 22 3e 46 6f 73 73 69 6c 20 ts.wiki">Fossil 0170: 63 6f 6e 63 65 70 74 73 3c 2f 61 3e 2e 29 0d 0a concepts</a>.).. 0180: 46 72 6f 6d 20 61 20 70 72 61 63 74 69 63 61 6c From a practical 0190: 20 73 74 61 6e 64 70 6f 69 6e 74 20 74 68 69 73 standpoint this 01a0: 20 69 73 20 61 20 73 65 74 20 6f 66 20 66 69 6c is a set of fil 01b0: 65 73 20 61 6e 64 20 64 69 72 65 63 74 6f 72 69 es and directori 01c0: 65 73 20 72 6f 6f 74 65 64 0d 0a 61 74 20 61 20 es rooted..at a 01d0: 6d 61 69 6e 20 70 72 6f 6a 65 63 74 20 64 69 72 main project dir 01e0: 65 63 74 6f 72 79 2e 20 20 54 68 65 20 66 69 6c ectory. The fil 01f0: 65 73 20 74 68 61 74 20 61 72 65 20 75 6e 64 65 es that are unde 0200: 72 20 73 6f 75 72 63 65 20 63 6f 6e 74 72 6f 6c r source control 0210: 20 61 72 65 6e 27 74 0d 0a 70 61 72 74 69 63 75 aren't..particu 0220: 6c 61 72 6c 79 20 64 69 73 74 69 6e 67 75 69 73 larly distinguis 0230: 68 61 62 6c 65 20 66 72 6f 6d 20 74 68 6f 73 65 hable from those 0240: 20 74 68 61 74 20 61 72 65 6e 27 74 2e 20 20 54 that aren't. T 0250: 68 65 20 3c 63 6f 64 65 3e 6c 73 3c 2f 63 6f 64 he <code>ls</cod 0260: 65 3e 20 61 6e 64 0d 0a 3c 63 6f 64 65 3e 65 78 e> and..<code>ex 0270: 74 72 61 3c 2f 63 6f 64 65 3e 20 63 6f 6d 6d 61 tra</code> comma 0280: 6e 64 73 20 70 72 6f 76 69 64 65 20 74 68 69 73 nds provide this 0290: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0d 0a 0d information.... 02a0: 0a 3c 63 6f 64 65 3e 66 6f 73 73 69 6c 20 6c 73 .<code>fossil ls 02b0: 3c 2f 63 6f 64 65 3e 20 70 72 6f 64 75 63 65 73 </code> produces 02c0: 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20 74 68 a listing of th 02d0: 65 20 66 69 6c 65 73 20 77 68 69 63 68 20 61 72 e files which ar 02e0: 65 20 75 6e 64 65 72 20 73 6f 75 72 63 65 0d 0a e under source.. 02f0: 63 6f 6e 74 72 6f 6c 20 3c 69 3e 61 6e 64 3c 2f control <i>and</ 0300: 69 3e 20 74 68 65 69 72 20 73 74 61 74 75 73 20 i> their status 0310: 77 69 74 68 69 6e 20 74 68 65 20 72 65 70 6f 73 within the repos 0320: 69 74 6f 72 79 2e 20 20 54 68 65 20 6f 75 74 70 itory. The outp 0330: 75 74 20 69 73 20 61 20 73 69 6d 70 6c 65 0d 0a ut is a simple.. 0340: 6c 69 73 74 20 6f 66 20 53 54 41 54 55 53 2f 66 list of STATUS/f 0350: 69 6c 65 70 61 74 68 20 70 61 69 72 73 20 6f 6e ilepath pairs on 0360: 20 73 65 70 61 72 61 74 65 20 6c 69 6e 65 73 2e separate lines. 0370: 20 20 54 68 65 20 73 74 61 74 75 73 20 6f 66 20 The status of 0380: 61 20 66 69 6c 65 20 77 69 6c 6c 0d 0a 6c 69 6b a file will..lik 0390: 65 6c 79 20 62 65 20 6f 6e 65 20 6f 66 20 41 44 ely be one of AD 03a0: 44 45 44 2c 20 55 4e 43 48 41 4e 47 45 44 2c 20 DED, UNCHANGED, 03b0: 55 50 44 41 54 45 44 2c 20 6f 72 20 44 45 4c 45 UPDATED, or DELE 03c0: 54 45 44 2e 20 3c 61 20 68 72 65 66 3d 22 23 6e TED. <a href="#n 03d0: 6f 74 65 73 22 3e 2a 3c 2f 61 3e 0d 0a 0d 0a 49 otes">*</a>....I 03e0: 74 27 73 20 69 6d 70 6f 72 74 61 6e 74 20 74 6f t's important to 03f0: 20 72 65 61 6c 69 7a 65 20 74 68 61 74 20 74 68 realize that th 0400: 69 73 20 69 73 20 74 68 65 20 73 74 61 74 75 73 is is the status 0410: 20 3c 69 3e 72 65 6c 61 74 69 76 65 20 74 6f 20 <i>relative to 0420: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 3c 2f the repository</ 0430: 69 3e 2c 0d 0a 69 74 27 73 20 74 68 65 20 73 74 i>,..it's the st 0440: 61 74 75 73 20 61 73 20 3c 62 3e 66 6f 73 73 69 atus as <b>fossi 0450: 6c 3c 2f 62 3e 20 73 65 65 73 20 69 74 20 61 6e l</b> sees it an 0460: 64 20 68 61 73 20 6e 6f 74 68 69 6e 67 20 74 6f d has nothing to 0470: 20 64 6f 20 77 69 74 68 0d 0a 66 69 6c 65 73 79 do with..filesy 0480: 73 74 65 6d 20 73 74 61 74 75 73 2e 20 20 49 66 stem status. If 0490: 20 79 6f 75 27 72 65 20 6e 65 77 20 74 6f 20 73 you're new to s 04a0: 6f 75 72 63 65 2d 6d 61 6e 61 67 65 6d 65 6e 74 ource-management 04b0: 2f 76 65 72 73 69 6f 6e 2d 63 6f 6e 74 72 6f 6c /version-control 04c0: 0d 0a 73 79 73 74 65 6d 73 2c 20 79 6f 75 27 6c ..systems, you'l 04d0: 6c 20 70 72 6f 62 61 62 6c 79 20 67 65 74 20 62 l probably get b 04e0: 69 74 20 62 79 20 74 68 69 73 20 63 6f 6e 63 65 it by this conce 04f0: 70 74 2d 62 75 67 20 61 74 20 6c 65 61 73 74 20 pt-bug at least 0500: 6f 6e 63 65 2e 0d 0a 0d 0a 54 6f 20 72 65 61 6c once.....To real 0510: 6c 79 20 73 65 65 20 74 68 65 20 64 69 66 66 65 ly see the diffe 0520: 72 65 6e 63 65 2c 20 69 73 73 75 65 20 61 6e 20 rence, issue an 0530: 3c 63 6f 64 65 3e 6c 73 3c 2f 63 6f 64 65 3e 20 <code>ls</code> 0540: 62 65 66 6f 72 65 20 61 6e 64 20 61 66 74 65 72 before and after 0550: 20 64 6f 69 6e 67 0d 0a 61 20 3c 61 20 68 72 65 doing..a <a hre 0560: 66 3d 22 77 69 6b 69 3f 6e 61 6d 65 3d 66 6f 73 f="wiki?name=fos 0570: 73 69 6c 2b 63 6f 6d 6d 69 74 22 3e 3c 63 6f 64 sil+commit"><cod 0580: 65 3e 63 6f 6d 6d 69 74 3c 2f 63 6f 64 65 3e 3c e>commit</code>< 0590: 2f 61 3e 2e 20 20 42 65 66 6f 72 65 2c 20 74 68 /a>. Before, th 05a0: 65 20 73 74 61 74 75 73 20 6f 66 20 66 69 6c 65 e status of file 05b0: 73 20 6d 61 79 20 62 65 20 61 6e 79 20 6f 66 20 s may be any of 05c0: 74 68 65 20 74 68 72 65 65 2c 0d 0a 62 75 74 20 the three,..but 05d0: 61 66 74 65 72 20 3c 63 6f 64 65 3e 63 6f 6d 6d after <code>comm 05e0: 69 74 3c 2f 63 6f 64 65 3e 74 69 6e 67 20 63 68 it</code>ting ch 05f0: 61 6e 67 65 73 20 74 68 65 20 73 74 61 74 75 73 anges the status 0600: 20 77 69 6c 6c 20 62 65 20 55 4e 43 48 41 4e 47 will be UNCHANG 0610: 45 44 20 22 61 63 72 6f 73 73 0d 0a 74 68 65 20 ED "across..the 0620: 62 6f 61 72 64 2e 22 0d 0a 0d 0a 42 79 20 77 61 board."....By wa 0630: 79 20 6f 66 20 65 78 61 6d 70 6c 65 2c 20 68 65 y of example, he 0640: 72 65 27 73 20 77 68 61 74 20 49 20 73 65 65 20 re's what I see 0650: 69 66 20 49 20 3c 63 6f 64 65 3e 66 6f 73 73 69 if I <code>fossi 0660: 6c 20 6c 73 3c 2f 63 6f 64 65 3e 20 69 6e 20 74 l ls</code> in t 0670: 68 65 0d 0a 64 69 72 65 63 74 6f 72 79 20 77 68 he..directory wh 0680: 65 72 65 20 49 20 68 61 76 65 20 63 68 65 63 6b ere I have check 0690: 65 64 20 6f 75 74 20 6d 79 20 74 65 73 74 69 6e ed out my testin 06a0: 67 20 72 65 70 6f 73 69 74 6f 72 79 3a 0d 0a 3c g repository:..< 06b0: 6e 6f 77 69 6b 69 3e 3c 70 72 65 3e 0d 0a 20 20 nowiki><pre>.. 06c0: 20 20 24 20 66 6f 73 73 69 6c 20 6c 73 0d 0a 20 $ fossil ls.. 06d0: 20 20 20 41 44 44 45 44 20 20 20 20 20 66 65 65 ADDED fee 06e0: 67 62 6f 69 6e 67 0d 0a 20 20 20 20 55 4e 43 48 gboing.. UNCH 06f0: 41 4e 47 45 44 20 66 6f 73 73 69 6c 5f 64 6f 63 ANGED fossil_doc 0700: 73 2e 74 78 74 0d 0a 20 20 20 20 44 45 4c 45 54 s.txt.. DELET 0710: 45 44 20 20 20 6e 69 62 63 72 6f 64 0d 0a 3c 2f ED nibcrod..</ 0720: 70 72 65 3e 3c 2f 6e 6f 77 69 6b 69 3e 0d 0a 42 pre></nowiki>..B 0730: 75 74 20 69 66 20 49 20 64 6f 20 61 20 73 69 6d ut if I do a sim 0740: 70 6c 65 20 6c 73 2c 20 77 68 61 74 20 49 20 67 ple ls, what I g 0750: 65 74 20 69 73 0d 0a 3c 6e 6f 77 69 6b 69 3e 3c et is..<nowiki>< 0760: 70 72 65 3e 0d 0a 20 20 20 20 24 20 6c 73 0d 0a pre>.. $ ls.. 0770: 20 20 20 20 66 65 65 67 62 6f 69 6e 67 20 20 66 feegboing f 0780: 6f 73 73 69 6c 5f 64 6f 63 73 2e 74 78 74 20 20 ossil_docs.txt 0790: 6d 61 6e 69 66 65 73 74 2e 75 75 69 64 20 20 6e manifest.uuid n 07a0: 6f 6f 64 6c 65 2e 74 78 74 0d 0a 20 20 20 20 5f oodle.txt.. _ 07b0: 46 4f 53 53 49 4c 5f 20 20 20 6d 61 6e 69 66 65 FOSSIL_ manife 07c0: 73 74 20 20 20 20 20 20 20 20 20 6e 69 62 63 72 st nibcr 07d0: 6f 64 0d 0a 3c 2f 70 72 65 3e 3c 2f 6e 6f 77 69 od..</pre></nowi 07e0: 6b 69 3e 0d 0a 0d 0a 54 68 65 20 3c 63 6f 64 65 ki>....The <code 07f0: 3e 6c 73 3c 2f 63 6f 64 65 3e 20 63 6f 6d 6d 61 >ls</code> comma 0800: 6e 64 20 69 73 20 61 6c 6d 6f 73 74 2c 20 62 75 nd is almost, bu 0810: 74 20 6e 6f 74 20 71 75 69 74 65 20 65 6e 74 69 t not quite enti 0820: 72 65 6c 79 2c 20 74 68 65 20 65 78 61 63 74 0d rely, the exact. 0830: 0a 6f 70 70 6f 73 69 74 65 20 6f 66 20 74 68 65 .opposite of the 0840: 0d 0a 3c 61 20 68 72 65 66 3d 22 77 69 6b 69 3f ..<a href="wiki? 0850: 6e 61 6d 65 3d 66 6f 73 73 69 6c 2b 65 78 74 72 name=fossil+extr 0860: 61 22 3e 3c 63 6f 64 65 3e 65 78 74 72 61 3c 2f a"><code>extra</ 0870: 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 3c 2f 61 code> command</a 0880: 3e 2e 0d 0a 0d 0a 3c 61 20 6e 61 6d 65 3d 22 6e >.....<a name="n 0890: 6f 74 65 73 22 3e 4e 6f 74 65 73 3a 3c 2f 61 3e otes">Notes:</a> 08a0: 0d 0a 20 20 2a 20 20 49 66 20 79 6f 75 20 63 6f .. * If you co 08b0: 6d 65 20 66 72 6f 6d 20 74 68 65 20 3c 62 3e 57 me from the <b>W 08c0: 69 6e 64 6f 77 73 3c 2f 62 3e 20 77 6f 72 6c 64 indows</b> world 08d0: 2c 20 69 74 20 77 69 6c 6c 20 68 65 6c 70 20 74 , it will help t 08e0: 6f 20 6b 6e 6f 77 20 74 68 61 74 20 27 6c 73 27 o know that 'ls' 08f0: 20 69 73 20 74 68 65 20 75 73 75 61 6c 20 3c 62 is the usual <b 0900: 3e 75 6e 69 78 3c 2f 62 3e 20 63 6f 6d 6d 61 6e >unix</b> comman 0910: 64 20 66 6f 72 20 6c 69 73 74 69 6e 67 20 61 20 d for listing a 0920: 64 69 72 65 63 74 6f 72 79 2e 0d 0a 20 20 2a 20 directory... * 0930: 20 54 68 65 72 65 20 61 72 65 20 6d 6f 72 65 20 There are more 0940: 73 74 61 74 65 73 20 66 6f 72 20 61 20 66 69 6c states for a fil 0950: 65 20 74 6f 20 62 65 20 69 6e 20 74 68 61 6e 20 e to be in than 0960: 74 68 6f 73 65 20 6c 69 73 74 65 64 2c 20 69 6e those listed, in 0970: 63 6c 75 64 69 6e 67 20 4d 49 53 53 49 4e 47 2c cluding MISSING, 0980: 20 45 44 49 54 45 44 2c 20 52 45 4e 41 4d 45 44 EDITED, RENAMED 0990: 20 61 6e 64 20 61 20 63 6f 75 70 6c 65 20 6f 66 and a couple of 09a0: 20 6f 74 68 65 72 73 2e 0d 0a 0d 0a 53 65 65 20 others.....See 09b0: 61 6c 73 6f 3a 20 5b 66 6f 73 73 69 6c 20 61 64 also: [fossil ad 09c0: 64 5d 2c 20 5b 66 6f 73 73 69 6c 20 72 6d 5d 2c d], [fossil rm], 09d0: 20 5b 66 6f 73 73 69 6c 20 65 78 74 72 61 5d 2c [fossil extra], 09e0: 20 5b 66 6f 73 73 69 6c 20 63 6f 6d 6d 69 74 5d [fossil commit] 09f0: 2c 20 3c 61 20 68 72 65 66 3d 22 64 6f 63 2f 74 , <a href="doc/t 0a00: 69 70 2f 77 77 77 2f 63 6f 6e 63 65 70 74 73 2e ip/www/concepts. 0a10: 77 69 6b 69 22 3e 46 6f 73 73 69 6c 20 63 6f 6e wiki">Fossil con 0a20: 63 65 70 74 73 3c 2f 61 3e 2c 20 5b 52 65 66 65 cepts</a>, [Refe 0a30: 72 65 6e 63 65 5d 0a 5a 20 66 62 37 30 30 65 33 rence].Z fb700e3 0a40: 64 31 61 61 30 30 66 30 37 39 39 39 63 65 39 62 d1aa00f07999ce9b 0a50: 35 65 63 64 65 63 62 35 30 0a 5ecdecb50.