Artifact 0ec2c3b4a5fe097af1db47cd4bd18976c5d00ffc:
Wiki page [fossil ls] by kejoki on 2008-11-09 21:03:39.
0000: 44 20 32 30 30 38 2d 31 31 2d 30 39 54 32 31 3a D 2008-11-09T21: 0010: 30 33 3a 33 39 0a 4c 20 66 6f 73 73 69 6c 5c 73 03:39.L fossil\s 0020: 6c 73 0a 50 20 63 31 66 37 64 30 33 34 65 61 62 ls.P c1f7d034eab 0030: 39 39 62 30 38 33 35 34 37 66 36 30 35 39 63 64 99b083547f6059cd 0040: 64 39 33 63 39 65 66 36 64 61 36 65 33 0a 55 20 d93c9ef6da6e3.U 0050: 6b 65 6a 6f 6b 69 0a 57 20 32 34 35 37 0a 3c 68 kejoki.W 2457.<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: 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69 6e 66 6f command is info 0090: 72 6d 61 74 69 6f 6e 61 6c 2c 20 69 74 20 64 6f rmational, it do 00a0: 65 73 6e 27 74 20 64 6f 20 61 6e 79 74 68 69 6e esn't do anythin 00b0: 67 20 74 6f 0d 0a 61 20 63 68 65 63 6b 65 64 2d g to..a checked- 00c0: 6f 75 74 20 70 72 6f 6a 65 63 74 2c 20 62 75 74 out project, but 00d0: 20 69 74 20 74 65 6c 6c 73 20 79 6f 75 20 73 6f it tells you so 00e0: 6d 65 74 68 69 6e 67 20 61 62 6f 75 74 20 69 74 mething about it 00f0: 2e 0d 0a 0d 0a 41 20 70 72 6f 6a 65 63 74 20 63 .....A project c 0100: 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 22 73 6f onsists of a "so 0110: 75 72 63 65 20 74 72 65 65 22 20 6f 66 20 22 61 urce tree" of "a 0120: 72 74 69 66 61 63 74 73 22 20 28 73 65 65 20 3c rtifacts" (see < 0130: 61 20 68 72 65 66 3d 22 64 6f 63 2f 74 69 70 2f a href="doc/tip/ 0140: 77 77 77 2f 63 6f 6e 63 65 70 74 73 2e 77 69 6b www/concepts.wik 0150: 69 22 3e 46 6f 73 73 69 6c 20 63 6f 6e 63 65 70 i">Fossil concep 0160: 74 73 3c 2f 61 3e 2e 29 0d 0a 46 72 6f 6d 20 61 ts</a>.)..From a 0170: 20 70 72 61 63 74 69 63 61 6c 20 73 74 61 6e 64 practical stand 0180: 70 6f 69 6e 74 20 74 68 69 73 20 69 73 20 61 20 point this is a 0190: 73 65 74 20 6f 66 20 66 69 6c 65 73 20 61 6e 64 set of files and 01a0: 20 64 69 72 65 63 74 6f 72 69 65 73 20 72 6f 6f directories roo 01b0: 74 65 64 0d 0a 61 74 20 61 20 6d 61 69 6e 20 70 ted..at a main p 01c0: 72 6f 6a 65 63 74 20 64 69 72 65 63 74 6f 72 79 roject directory 01d0: 2e 20 20 54 68 65 20 66 69 6c 65 73 20 74 68 61 . The files tha 01e0: 74 20 61 72 65 20 75 6e 64 65 72 20 73 6f 75 72 t are under sour 01f0: 63 65 20 63 6f 6e 74 72 6f 6c 20 61 72 65 6e 27 ce control aren' 0200: 74 0d 0a 70 61 72 74 69 63 75 6c 61 72 6c 79 20 t..particularly 0210: 64 69 73 74 69 6e 67 75 69 73 68 61 62 6c 65 20 distinguishable 0220: 66 72 6f 6d 20 74 68 6f 73 65 20 74 68 61 74 20 from those that 0230: 61 72 65 6e 27 74 2e 20 20 54 68 65 20 3c 63 6f aren't. The <co 0240: 64 65 3e 6c 73 3c 2f 63 6f 64 65 3e 20 61 6e 64 de>ls</code> and 0250: 0d 0a 3c 63 6f 64 65 3e 65 78 74 72 61 3c 2f 63 ..<code>extra</c 0260: 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 73 20 70 72 ode> commands pr 0270: 6f 76 69 64 65 20 74 68 69 73 20 69 6e 66 6f 72 ovide this infor 0280: 6d 61 74 69 6f 6e 2e 0d 0a 0d 0a 3c 63 6f 64 65 mation.....<code 0290: 3e 66 6f 73 73 69 6c 20 6c 73 3c 2f 63 6f 64 65 >fossil ls</code 02a0: 3e 20 70 72 6f 64 75 63 65 73 20 61 20 6c 69 73 > produces a lis 02b0: 74 69 6e 67 20 6f 66 20 74 68 65 20 66 69 6c 65 ting of the file 02c0: 73 20 77 68 69 63 68 20 61 72 65 20 75 6e 64 65 s which are unde 02d0: 72 20 73 6f 75 72 63 65 0d 0a 63 6f 6e 74 72 6f r source..contro 02e0: 6c 20 3c 69 3e 61 6e 64 3c 2f 69 3e 20 74 68 65 l <i>and</i> the 02f0: 69 72 20 73 74 61 74 75 73 20 77 69 74 68 69 6e ir status within 0300: 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2e the repository. 0310: 20 20 54 68 65 20 6f 75 74 70 75 74 20 69 73 20 The output is 0320: 61 20 73 69 6d 70 6c 65 0d 0a 6c 69 73 74 20 6f a simple..list o 0330: 66 20 53 54 41 54 55 53 2f 66 69 6c 65 70 61 74 f STATUS/filepat 0340: 68 20 70 61 69 72 73 20 6f 6e 20 73 65 70 61 72 h pairs on separ 0350: 61 74 65 20 6c 69 6e 65 73 2e 20 20 54 68 65 20 ate lines. The 0360: 73 74 61 74 75 73 20 6f 66 20 61 20 66 69 6c 65 status of a file 0370: 20 77 69 6c 6c 0d 0a 6c 69 6b 65 6c 79 20 62 65 will..likely be 0380: 20 6f 6e 65 20 6f 66 20 41 44 44 45 44 2c 20 55 one of ADDED, U 0390: 4e 43 48 41 4e 47 45 44 2c 20 55 50 44 41 54 45 NCHANGED, UPDATE 03a0: 44 2c 20 6f 72 20 44 45 4c 45 54 45 44 2e 0d 0a D, or DELETED... 03b0: 0d 0a 49 74 27 73 20 69 6d 70 6f 72 74 61 6e 74 ..It's important 03c0: 20 74 6f 20 72 65 61 6c 69 7a 65 20 74 68 61 74 to realize that 03d0: 20 74 68 69 73 20 69 73 20 74 68 65 20 73 74 61 this is the sta 03e0: 74 75 73 20 3c 69 3e 72 65 6c 61 74 69 76 65 20 tus <i>relative 03f0: 74 6f 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 to the repositor 0400: 79 3c 2f 69 3e 2c 0d 0a 69 74 27 73 20 74 68 65 y</i>,..it's the 0410: 20 73 74 61 74 75 73 20 61 73 20 3c 62 3e 66 6f status as <b>fo 0420: 73 73 69 6c 3c 2f 62 3e 20 73 65 65 73 20 69 74 ssil</b> sees it 0430: 20 61 6e 64 20 68 61 73 20 6e 6f 74 68 69 6e 67 and has nothing 0440: 20 74 6f 20 64 6f 20 77 69 74 68 0d 0a 66 69 6c to do with..fil 0450: 65 73 79 73 74 65 6d 20 73 74 61 74 75 73 2e 20 esystem status. 0460: 20 49 66 20 79 6f 75 27 72 65 20 6e 65 77 20 74 If you're new t 0470: 6f 20 73 6f 75 72 63 65 2d 6d 61 6e 61 67 65 6d o source-managem 0480: 65 6e 74 2f 76 65 72 73 69 6f 6e 2d 63 6f 6e 74 ent/version-cont 0490: 72 6f 6c 0d 0a 73 79 73 74 65 6d 73 2c 20 79 6f rol..systems, yo 04a0: 75 27 6c 6c 20 70 72 6f 62 61 62 6c 79 20 67 65 u'll probably ge 04b0: 74 20 62 69 74 20 62 79 20 74 68 69 73 20 63 6f t bit by this co 04c0: 6e 63 65 70 74 2d 62 75 67 20 61 74 20 6c 65 61 ncept-bug at lea 04d0: 73 74 20 6f 6e 63 65 2e 0d 0a 0d 0a 54 6f 20 72 st once.....To r 04e0: 65 61 6c 6c 79 20 73 65 65 20 74 68 65 20 64 69 eally see the di 04f0: 66 66 65 72 65 6e 63 65 2c 20 69 73 73 75 65 20 fference, issue 0500: 61 6e 20 3c 63 6f 64 65 3e 6c 73 3c 2f 63 6f 64 an <code>ls</cod 0510: 65 3e 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66 e> before and af 0520: 74 65 72 20 64 6f 69 6e 67 0d 0a 61 20 3c 61 20 ter doing..a <a 0530: 68 72 65 66 3d 22 77 69 6b 69 3f 6e 61 6d 65 3d href="wiki?name= 0540: 66 6f 73 73 69 6c 2b 63 6f 6d 6d 69 74 22 3e 3c fossil+commit">< 0550: 63 6f 64 65 3e 63 6f 6d 6d 69 74 3c 2f 63 6f 64 code>commit</cod 0560: 65 3e 3c 2f 61 3e 2e 20 20 42 65 66 6f 72 65 2c e></a>. Before, 0570: 20 74 68 65 20 73 74 61 74 75 73 20 6f 66 20 66 the status of f 0580: 69 6c 65 73 20 6d 61 79 20 62 65 20 61 6e 79 20 iles may be any 0590: 6f 66 20 74 68 65 20 74 68 72 65 65 2c 0d 0a 62 of the three,..b 05a0: 75 74 20 61 66 74 65 72 20 3c 63 6f 64 65 3e 63 ut after <code>c 05b0: 6f 6d 6d 69 74 3c 2f 63 6f 64 65 3e 74 69 6e 67 ommit</code>ting 05c0: 20 63 68 61 6e 67 65 73 20 74 68 65 20 73 74 61 changes the sta 05d0: 74 75 73 20 77 69 6c 6c 20 62 65 20 55 4e 43 48 tus will be UNCH 05e0: 41 4e 47 45 44 20 22 61 63 72 6f 73 73 0d 0a 74 ANGED "across..t 05f0: 68 65 20 62 6f 61 72 64 2e 22 0d 0a 0d 0a 42 79 he board."....By 0600: 20 77 61 79 20 6f 66 20 65 78 61 6d 70 6c 65 2c way of example, 0610: 20 68 65 72 65 27 73 20 77 68 61 74 20 49 20 73 here's what I s 0620: 65 65 20 69 66 20 49 20 3c 63 6f 64 65 3e 66 6f ee if I <code>fo 0630: 73 73 69 6c 20 6c 73 3c 2f 63 6f 64 65 3e 20 69 ssil ls</code> i 0640: 6e 20 74 68 65 0d 0a 64 69 72 65 63 74 6f 72 79 n the..directory 0650: 20 77 68 65 72 65 20 49 20 68 61 76 65 20 63 68 where I have ch 0660: 65 63 6b 65 64 20 6f 75 74 20 6d 79 20 74 65 73 ecked out my tes 0670: 74 69 6e 67 20 72 65 70 6f 73 69 74 6f 72 79 3a ting repository: 0680: 0d 0a 3c 6e 6f 77 69 6b 69 3e 3c 70 72 65 3e 0d ..<nowiki><pre>. 0690: 0a 20 20 20 20 24 20 66 6f 73 73 69 6c 20 6c 73 . $ fossil ls 06a0: 0d 0a 20 20 20 20 41 44 44 45 44 20 20 20 20 20 .. ADDED 06b0: 66 65 65 67 62 6f 69 6e 67 0d 0a 20 20 20 20 55 feegboing.. U 06c0: 4e 43 48 41 4e 47 45 44 20 66 6f 73 73 69 6c 5f NCHANGED fossil_ 06d0: 64 6f 63 73 2e 74 78 74 0d 0a 20 20 20 20 44 45 docs.txt.. DE 06e0: 4c 45 54 45 44 20 20 20 6e 69 62 63 72 6f 64 0d LETED nibcrod. 06f0: 0a 3c 2f 70 72 65 3e 3c 2f 6e 6f 77 69 6b 69 3e .</pre></nowiki> 0700: 0d 0a 42 75 74 20 69 66 20 49 20 64 6f 20 61 20 ..But if I do a 0710: 73 69 6d 70 6c 65 20 6c 73 2c 20 77 68 61 74 20 simple ls, what 0720: 49 20 67 65 74 20 69 73 0d 0a 3c 6e 6f 77 69 6b I get is..<nowik 0730: 69 3e 3c 70 72 65 3e 0d 0a 20 20 20 20 24 20 6c i><pre>.. $ l 0740: 73 0d 0a 20 20 20 20 66 65 65 67 62 6f 69 6e 67 s.. feegboing 0750: 20 20 66 6f 73 73 69 6c 5f 64 6f 63 73 2e 74 78 fossil_docs.tx 0760: 74 20 20 6d 61 6e 69 66 65 73 74 2e 75 75 69 64 t manifest.uuid 0770: 20 20 6e 6f 6f 64 6c 65 2e 74 78 74 0d 0a 20 20 noodle.txt.. 0780: 20 20 5f 46 4f 53 53 49 4c 5f 20 20 20 6d 61 6e _FOSSIL_ man 0790: 69 66 65 73 74 20 20 20 20 20 20 20 20 20 6e 69 ifest ni 07a0: 62 63 72 6f 64 0d 0a 3c 2f 70 72 65 3e 3c 2f 6e bcrod..</pre></n 07b0: 6f 77 69 6b 69 3e 0d 0a 0d 0a 54 68 65 20 3c 63 owiki>....The <c 07c0: 6f 64 65 3e 6c 73 3c 2f 63 6f 64 65 3e 20 63 6f ode>ls</code> co 07d0: 6d 6d 61 6e 64 20 69 73 20 61 6c 6d 6f 73 74 2c mmand is almost, 07e0: 20 62 75 74 20 6e 6f 74 20 71 75 69 74 65 20 65 but not quite e 07f0: 6e 74 69 72 65 6c 79 2c 20 74 68 65 20 65 78 61 ntirely, the exa 0800: 63 74 0d 0a 6f 70 70 6f 73 69 74 65 20 6f 66 20 ct..opposite of 0810: 74 68 65 0d 0a 3c 61 20 68 72 65 66 3d 22 77 69 the..<a href="wi 0820: 6b 69 3f 6e 61 6d 65 3d 66 6f 73 73 69 6c 2b 65 ki?name=fossil+e 0830: 78 74 72 61 22 3e 3c 63 6f 64 65 3e 65 78 74 72 xtra"><code>extr 0840: 61 3c 2f 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 a</code> command 0850: 3c 2f 61 3e 2e 0d 0a 0d 0a 4e 6f 74 65 73 3a 0d </a>.....Notes:. 0860: 0a 20 20 2a 20 20 54 68 65 72 65 20 61 72 65 20 . * There are 0870: 6d 6f 72 65 20 73 74 61 74 65 73 20 66 6f 72 20 more states for 0880: 61 20 66 69 6c 65 20 74 6f 20 62 65 20 69 6e 20 a file to be in 0890: 74 68 61 6e 20 74 68 6f 73 65 20 6c 69 73 74 65 than those liste 08a0: 64 2c 20 69 6e 63 6c 75 64 69 6e 67 20 4d 49 53 d, including MIS 08b0: 53 49 4e 47 2c 20 45 44 49 54 45 44 2c 20 52 45 SING, EDITED, RE 08c0: 4e 41 4d 45 44 20 61 6e 64 20 61 20 63 6f 75 70 NAMED and a coup 08d0: 6c 65 20 6f 66 20 6f 74 68 65 72 73 2e 0d 0a 20 le of others... 08e0: 20 2a 20 20 49 66 20 79 6f 75 20 63 6f 6d 65 20 * If you come 08f0: 66 72 6f 6d 20 74 68 65 20 3c 62 3e 57 69 6e 64 from the <b>Wind 0900: 6f 77 73 3c 2f 62 3e 20 77 6f 72 6c 64 2c 20 69 ows</b> world, i 0910: 74 20 77 69 6c 6c 20 68 65 6c 70 20 74 6f 20 6b t will help to k 0920: 6e 6f 77 20 74 68 61 74 20 27 6c 73 27 20 69 73 now that 'ls' is 0930: 20 74 68 65 20 75 73 75 61 6c 6c 79 20 3c 62 3e the usually <b> 0940: 75 6e 69 78 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 unix</b> command 0950: 20 66 6f 72 20 6c 69 73 74 69 6e 67 20 61 20 64 for listing a d 0960: 69 72 65 63 74 6f 72 79 2e 0d 0a 0d 0a 53 65 65 irectory.....See 0970: 20 61 6c 73 6f 3a 20 5b 66 6f 73 73 69 6c 20 61 also: [fossil a 0980: 64 64 5d 2c 20 5b 66 6f 73 73 69 6c 20 72 6d 5d dd], [fossil rm] 0990: 2c 20 5b 66 6f 73 73 69 6c 20 65 78 74 72 61 5d , [fossil extra] 09a0: 2c 20 5b 66 6f 73 73 69 6c 20 63 6f 6d 6d 69 74 , [fossil commit 09b0: 5d 2c 20 3c 61 20 68 72 65 66 3d 22 64 6f 63 2f ], <a href="doc/ 09c0: 74 69 70 2f 77 77 77 2f 63 6f 6e 63 65 70 74 73 tip/www/concepts 09d0: 2e 77 69 6b 69 22 3e 46 6f 73 73 69 6c 20 63 6f .wiki">Fossil co 09e0: 6e 63 65 70 74 73 3c 2f 61 3e 2c 20 5b 52 65 66 ncepts</a>, [Ref 09f0: 65 72 65 6e 63 65 5d 0a 5a 20 34 62 66 65 33 32 erence].Z 4bfe32 0a00: 32 37 66 66 64 66 62 66 66 61 61 63 33 33 39 64 27ffdfbffaac339d 0a10: 66 66 31 61 37 36 64 33 34 38 0a ff1a76d348.