Artifact 94ab3d8aa3dc591da23f0935529708c090a2eeb2:
Wiki page [fossil ls] by kkinnell on 2008-11-09 19:28:07.
0000: 44 20 32 30 30 38 2d 31 31 2d 30 39 54 31 39 3a D 2008-11-09T19: 0010: 32 38 3a 30 37 0a 4c 20 66 6f 73 73 69 6c 5c 73 28:07.L fossil\s 0020: 6c 73 0a 55 20 6b 6b 69 6e 6e 65 6c 6c 0a 57 20 ls.U kkinnell.W 0030: 32 31 32 35 0a 3c 68 32 3e 6c 73 3c 2f 68 32 3e 2125.<h2>ls</h2> 0040: 0d 0a 0d 0a 54 68 65 20 3c 63 6f 64 65 3e 6c 73 ....The <code>ls 0050: 3c 2f 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 20 </code> command 0060: 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 61 6c is informational 0070: 2c 20 69 74 20 64 6f 65 73 6e 27 74 20 64 6f 20 , it doesn't do 0080: 61 6e 79 74 68 69 6e 67 20 74 6f 0d 0a 61 20 63 anything to..a c 0090: 68 65 63 6b 65 64 2d 6f 75 74 20 70 72 6f 6a 65 hecked-out proje 00a0: 63 74 2c 20 62 75 74 20 69 74 20 74 65 6c 6c 73 ct, but it tells 00b0: 20 79 6f 75 20 73 6f 6d 65 74 68 69 6e 67 20 61 you something a 00c0: 62 6f 75 74 20 69 74 2e 0d 0a 0d 0a 41 20 70 72 bout it.....A pr 00d0: 6f 6a 65 63 74 20 63 6f 6e 73 69 73 74 73 20 6f oject consists o 00e0: 66 20 61 20 22 73 6f 75 72 63 65 20 74 72 65 65 f a "source tree 00f0: 22 20 6f 66 20 22 61 72 74 69 66 61 63 74 73 22 " of "artifacts" 0100: 20 28 73 65 65 20 3c 61 20 68 72 65 66 3d 22 64 (see <a href="d 0110: 6f 63 2f 74 69 70 2f 77 77 77 2f 63 6f 6e 63 65 oc/tip/www/conce 0120: 70 74 73 2e 77 69 6b 69 22 3e 46 6f 73 73 69 6c pts.wiki">Fossil 0130: 20 63 6f 6e 63 65 70 74 73 3c 2f 61 3e 2e 29 0d concepts</a>.). 0140: 0a 46 72 6f 6d 20 61 20 70 72 61 63 74 69 63 61 .From a practica 0150: 6c 20 73 74 61 6e 64 70 6f 69 6e 74 20 74 68 69 l standpoint thi 0160: 73 20 69 73 20 61 20 73 65 74 20 6f 66 20 66 69 s is a set of fi 0170: 6c 65 73 20 61 6e 64 20 64 69 72 65 63 74 6f 72 les and director 0180: 69 65 73 20 72 6f 6f 74 65 64 0d 0a 61 74 20 61 ies rooted..at a 0190: 20 6d 61 69 6e 20 70 72 6f 6a 65 63 74 20 64 69 main project di 01a0: 72 65 63 74 6f 72 79 2e 20 20 54 68 65 20 66 69 rectory. The fi 01b0: 6c 65 73 20 74 68 61 74 20 61 72 65 20 75 6e 64 les that are und 01c0: 65 72 20 73 6f 75 72 63 65 20 63 6f 6e 74 72 6f er source contro 01d0: 6c 20 61 72 65 6e 27 74 0d 0a 70 61 72 74 69 63 l aren't..partic 01e0: 75 6c 61 72 6c 79 20 64 69 73 74 69 6e 67 75 69 ularly distingui 01f0: 73 68 61 62 6c 65 20 66 72 6f 6d 20 74 68 6f 73 shable from thos 0200: 65 20 74 68 61 74 20 61 72 65 6e 27 74 2e 20 20 e that aren't. 0210: 54 68 65 20 3c 63 6f 64 65 3e 6c 73 3c 2f 63 6f The <code>ls</co 0220: 64 65 3e 20 61 6e 64 0d 0a 3c 63 6f 64 65 3e 65 de> and..<code>e 0230: 78 74 72 61 3c 2f 63 6f 64 65 3e 20 63 6f 6d 6d xtra</code> comm 0240: 61 6e 64 73 20 70 72 6f 76 69 64 65 20 74 68 69 ands provide thi 0250: 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0d 0a s information... 0260: 0d 0a 3c 63 6f 64 65 3e 66 6f 73 73 69 6c 20 6c ..<code>fossil l 0270: 73 3c 2f 63 6f 64 65 3e 20 70 72 6f 64 75 63 65 s</code> produce 0280: 73 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20 74 s a listing of t 0290: 68 65 20 66 69 6c 65 73 20 77 68 69 63 68 20 61 he files which a 02a0: 72 65 20 75 6e 64 65 72 20 73 6f 75 72 63 65 0d re under source. 02b0: 0a 63 6f 6e 74 72 6f 6c 20 3c 69 3e 61 6e 64 3c .control <i>and< 02c0: 2f 69 3e 20 74 68 65 69 72 20 73 74 61 74 75 73 /i> their status 02d0: 20 77 69 74 68 69 6e 20 74 68 65 20 72 65 70 6f within the repo 02e0: 73 69 74 6f 72 79 2e 20 20 54 68 65 20 6f 75 74 sitory. The out 02f0: 70 75 74 20 69 73 20 61 20 73 69 6d 70 6c 65 0d put is a simple. 0300: 0a 6c 69 73 74 20 6f 66 20 53 54 41 54 55 53 2f .list of STATUS/ 0310: 66 69 6c 65 70 61 74 68 20 70 61 69 72 73 20 6f filepath pairs o 0320: 6e 20 73 65 70 61 72 61 74 65 20 6c 69 6e 65 73 n separate lines 0330: 2e 20 20 54 68 65 20 73 74 61 74 75 73 20 6f 66 . The status of 0340: 20 61 20 66 69 6c 65 20 77 69 6c 6c 0d 0a 62 65 a file will..be 0350: 20 6f 6e 65 20 6f 66 20 41 44 44 45 44 2c 20 55 one of ADDED, U 0360: 4e 43 48 41 4e 47 45 44 2c 20 6f 72 20 44 45 4c NCHANGED, or DEL 0370: 45 54 45 44 2e 0d 0a 0d 0a 49 74 27 73 20 69 6d ETED.....It's im 0380: 70 6f 72 74 61 6e 74 20 74 6f 20 72 65 61 6c 69 portant to reali 0390: 7a 65 20 74 68 61 74 20 74 68 69 73 20 69 73 20 ze that this is 03a0: 74 68 65 20 73 74 61 74 75 73 20 3c 69 3e 72 65 the status <i>re 03b0: 6c 61 74 69 76 65 20 74 6f 20 74 68 65 20 72 65 lative to the re 03c0: 70 6f 73 69 74 6f 72 79 3c 2f 69 3e 2c 0d 0a 69 pository</i>,..i 03d0: 74 27 73 20 74 68 65 20 73 74 61 74 75 73 20 61 t's the status a 03e0: 73 20 3c 62 3e 66 6f 73 73 69 6c 3c 2f 62 3e 20 s <b>fossil</b> 03f0: 73 65 65 73 20 69 74 20 61 6e 64 20 68 61 73 20 sees it and has 0400: 6e 6f 74 68 69 6e 67 20 74 6f 20 64 6f 20 77 69 nothing to do wi 0410: 74 68 0d 0a 66 69 6c 65 73 79 73 74 65 6d 20 73 th..filesystem s 0420: 74 61 74 75 73 2e 20 20 49 66 20 79 6f 75 27 72 tatus. If you'r 0430: 65 20 6e 65 77 20 74 6f 20 73 6f 75 72 63 65 2d e new to source- 0440: 6d 61 6e 61 67 65 6d 65 6e 74 2f 76 65 72 73 69 management/versi 0450: 6f 6e 2d 63 6f 6e 74 72 6f 6c 0d 0a 73 79 73 74 on-control..syst 0460: 65 6d 73 2c 20 79 6f 75 27 6c 6c 20 70 72 6f 62 ems, you'll prob 0470: 61 62 6c 79 20 67 65 74 20 62 69 74 20 62 79 20 ably get bit by 0480: 74 68 69 73 20 63 6f 6e 63 65 70 74 2d 62 75 67 this concept-bug 0490: 20 61 74 20 6c 65 61 73 74 20 6f 6e 63 65 2e 0d at least once.. 04a0: 0a 0d 0a 54 6f 20 72 65 61 6c 6c 79 20 73 65 65 ...To really see 04b0: 20 74 68 65 20 64 69 66 66 65 72 65 6e 63 65 2c the difference, 04c0: 20 69 73 73 75 65 20 61 6e 20 3c 63 6f 64 65 3e issue an <code> 04d0: 6c 73 3c 2f 63 6f 64 65 3e 20 62 65 66 6f 72 65 ls</code> before 04e0: 20 61 6e 64 20 61 66 74 65 72 20 64 6f 69 6e 67 and after doing 04f0: 0d 0a 61 20 3c 63 6f 64 65 3e 63 6f 6d 6d 69 74 ..a <code>commit 0500: 3c 2f 63 6f 64 65 3e 2e 20 20 42 65 66 6f 72 65 </code>. Before 0510: 2c 20 74 68 65 20 73 74 61 74 75 73 20 6f 66 20 , the status of 0520: 66 69 6c 65 73 20 6d 61 79 20 62 65 20 61 6e 79 files may be any 0530: 20 6f 66 20 74 68 65 20 74 68 72 65 65 2c 0d 0a of the three,.. 0540: 62 75 74 20 61 66 74 65 72 20 3c 63 6f 64 65 3e but after <code> 0550: 63 6f 6d 6d 69 74 3c 2f 63 6f 64 65 3e 74 69 6e commit</code>tin 0560: 67 20 63 68 61 6e 67 65 73 20 74 68 65 20 73 74 g changes the st 0570: 61 74 75 73 20 77 69 6c 6c 20 62 65 20 55 4e 43 atus will be UNC 0580: 48 41 4e 47 45 44 20 22 61 63 72 6f 73 73 0d 0a HANGED "across.. 0590: 74 68 65 20 62 6f 61 72 64 2e 22 0d 0a 0d 0a 42 the board."....B 05a0: 79 20 77 61 79 20 6f 66 20 65 78 61 6d 70 6c 65 y way of example 05b0: 2c 20 68 65 72 65 27 73 20 77 68 61 74 20 49 20 , here's what I 05c0: 73 65 65 20 69 66 20 49 20 3c 63 6f 64 65 3e 66 see if I <code>f 05d0: 6f 73 73 69 6c 20 6c 73 3c 2f 63 6f 64 65 3e 20 ossil ls</code> 05e0: 69 6e 20 74 68 65 0d 0a 64 69 72 65 63 74 6f 72 in the..director 05f0: 79 20 77 68 65 72 65 20 49 20 68 61 76 65 20 63 y where I have c 0600: 68 65 63 6b 65 64 20 6f 75 74 20 6d 79 20 74 65 hecked out my te 0610: 73 74 69 6e 67 20 72 65 70 6f 73 69 74 6f 72 79 sting repository 0620: 3a 0d 0a 3c 6e 6f 77 69 6b 69 3e 3c 70 72 65 3e :..<nowiki><pre> 0630: 0d 0a 20 20 20 20 24 20 66 6f 73 73 69 6c 20 6c .. $ fossil l 0640: 73 0d 0a 20 20 20 20 41 44 44 45 44 20 20 20 20 s.. ADDED 0650: 20 66 65 65 67 62 6f 69 6e 67 0d 0a 20 20 20 20 feegboing.. 0660: 55 4e 43 48 41 4e 47 45 44 20 66 6f 73 73 69 6c UNCHANGED fossil 0670: 5f 64 6f 63 73 2e 74 78 74 0d 0a 20 20 20 20 44 _docs.txt.. D 0680: 45 4c 45 54 45 44 20 20 20 6e 69 62 63 72 6f 64 ELETED nibcrod 0690: 0d 0a 3c 2f 70 72 65 3e 3c 2f 6e 6f 77 69 6b 69 ..</pre></nowiki 06a0: 3e 0d 0a 42 75 74 20 69 66 20 49 20 64 6f 20 61 >..But if I do a 06b0: 20 73 69 6d 70 6c 65 20 6c 73 2c 20 77 68 61 74 simple ls, what 06c0: 20 49 20 67 65 74 20 69 73 0d 0a 3c 6e 6f 77 69 I get is..<nowi 06d0: 6b 69 3e 3c 70 72 65 3e 0d 0a 20 20 20 20 24 20 ki><pre>.. $ 06e0: 6c 73 0d 0a 20 20 20 20 66 65 65 67 62 6f 69 6e ls.. feegboin 06f0: 67 20 20 66 6f 73 73 69 6c 5f 64 6f 63 73 2e 74 g fossil_docs.t 0700: 78 74 20 20 6d 61 6e 69 66 65 73 74 2e 75 75 69 xt manifest.uui 0710: 64 20 20 6e 6f 6f 64 6c 65 2e 74 78 74 0d 0a 20 d noodle.txt.. 0720: 20 20 20 5f 46 4f 53 53 49 4c 5f 20 20 20 6d 61 _FOSSIL_ ma 0730: 6e 69 66 65 73 74 20 20 20 20 20 20 20 20 20 6e nifest n 0740: 69 62 63 72 6f 64 0d 0a 3c 2f 70 72 65 3e 3c 2f ibcrod..</pre></ 0750: 6e 6f 77 69 6b 69 3e 0d 0a 54 68 65 20 3c 63 6f nowiki>..The <co 0760: 64 65 3e 6c 73 3c 2f 63 6f 64 65 3e 20 63 6f 6d de>ls</code> com 0770: 6d 61 6e 64 20 69 73 20 61 6c 6d 6f 73 74 2c 20 mand is almost, 0780: 62 75 74 20 6e 6f 74 20 71 75 69 74 65 20 65 6e but not quite en 0790: 74 69 72 65 6c 79 2c 20 74 68 65 20 65 78 61 63 tirely, the exac 07a0: 74 0d 0a 6f 70 70 6f 73 69 74 65 20 6f 66 20 74 t..opposite of t 07b0: 68 65 0d 0a 3c 61 20 68 72 65 66 3d 22 77 69 6b he..<a href="wik 07c0: 69 3f 6e 61 6d 65 3d 66 6f 73 73 69 6c 2b 65 78 i?name=fossil+ex 07d0: 74 72 61 22 3e 3c 63 6f 64 65 3e 65 78 74 72 61 tra"><code>extra 07e0: 3c 2f 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 3c </code> command< 07f0: 2f 61 3e 2e 0d 0a 0d 0a 53 65 65 20 61 6c 73 6f /a>.....See also 0800: 3a 20 5b 66 6f 73 73 69 6c 20 61 64 64 5d 2c 20 : [fossil add], 0810: 5b 66 6f 73 73 69 6c 20 72 6d 5d 2c 20 5b 66 6f [fossil rm], [fo 0820: 73 73 69 6c 20 65 78 74 72 61 5d 2c 20 5b 66 6f ssil extra], [fo 0830: 73 73 69 6c 20 63 6f 6d 6d 69 74 5d 2c 20 3c 61 ssil commit], <a 0840: 20 68 72 65 66 3d 22 64 6f 63 2f 74 69 70 2f 77 href="doc/tip/w 0850: 77 77 2f 63 6f 6e 63 65 70 74 73 2e 77 69 6b 69 ww/concepts.wiki 0860: 22 3e 46 6f 73 73 69 6c 20 63 6f 6e 63 65 70 74 ">Fossil concept 0870: 73 3c 2f 61 3e 2c 20 5b 52 65 66 65 72 65 6e 63 s</a>, [Referenc 0880: 65 5d 0a 5a 20 31 62 61 32 31 62 35 36 64 32 34 e].Z 1ba21b56d24 0890: 64 33 31 61 37 61 62 30 35 36 30 61 65 30 35 31 d31a7ab0560ae051 08a0: 39 63 62 61 33 0a 9cba3.