Artifact 743e75d49ad2679e6546579c0c63bf71db40f5e7:
File rse-notes.txt part of check-in [9a482dd701] - Remove control characters from rse-notes.txt. by drh on 2008-10-24 14:03:17.
0000: 46 72 6f 6d 3a 20 22 52 61 6c 66 20 53 2e 20 45 From: "Ralf S. E 0010: 6e 67 65 6c 73 63 68 61 6c 6c 22 0a 44 61 74 65 ngelschall".Date 0020: 3a 20 4f 63 74 6f 62 65 72 20 31 38 2c 20 32 30 : October 18, 20 0030: 30 38 20 31 3a 34 30 3a 35 33 20 50 4d 20 45 44 08 1:40:53 PM ED 0040: 54 0a 54 6f 3a 20 64 72 68 40 68 77 61 63 69 2e T.To: drh@hwaci. 0050: 63 6f 6d 0a 53 75 62 6a 65 63 74 3a 20 53 6f 6d com.Subject: Som 0060: 65 20 46 6f 73 73 69 6c 20 46 65 65 64 62 61 63 e Fossil Feedbac 0070: 6b 0a 0a 49 27 76 65 20 74 6f 64 61 79 20 6c 6f k..I've today lo 0080: 6f 6b 65 64 20 61 74 20 79 6f 75 72 20 46 6f 73 oked at your Fos 0090: 73 69 6c 20 70 72 6f 6a 65 63 74 20 28 6c 61 74 sil project (lat 00a0: 65 73 74 20 76 65 72 73 69 6f 6e 20 66 72 6f 6d est version from 00b0: 20 79 6f 75 72 0a 72 65 70 6f 73 69 74 6f 72 79 your.repository 00c0: 29 2e 20 54 68 61 74 27 73 20 61 20 5f 72 65 61 ). That's a _rea 00d0: 6c 6c 79 5f 20 69 6e 74 65 72 65 73 74 69 6e 67 lly_ interesting 00e0: 20 61 6e 64 20 76 65 72 79 20 70 72 6f 6d 69 73 and very promis 00f0: 69 6e 67 20 44 56 43 53 2e 0a 57 68 69 6c 65 20 ing DVCS..While 0100: 49 20 6c 6f 6f 6b 65 64 20 61 72 6f 75 6e 64 20 I looked around 0110: 61 6e 64 20 74 65 73 74 65 64 20 69 74 2c 20 49 and tested it, I 0120: 20 73 74 75 6d 62 6c 65 64 20 6f 76 65 72 20 73 stumbled over s 0130: 6f 6d 65 20 69 73 73 75 65 73 20 49 20 77 61 6e ome issues I wan 0140: 74 0a 74 6f 20 73 68 61 72 65 20 77 69 74 68 20 t.to share with 0150: 79 6f 75 3a 0a 0a 6f 20 4e 6f 20 74 61 72 62 61 you:..o No tarba 0160: 6c 6c 0a 0a 20 20 59 6f 75 20 63 75 72 72 65 6e ll.. You curren 0170: 74 6c 79 20 73 74 69 6c 6c 20 64 6f 20 6e 6f 74 tly still do not 0180: 20 70 72 6f 76 69 64 65 20 61 6e 79 20 74 61 72 provide any tar 0190: 62 61 6c 6c 73 20 6f 66 20 74 68 65 20 46 6f 73 balls of the Fos 01a0: 73 69 6c 20 73 6f 75 72 63 65 73 2e 0a 20 20 53 sil sources.. S 01b0: 75 72 65 2c 20 79 6f 75 20 61 72 65 20 73 74 69 ure, you are sti 01c0: 6c 6c 20 68 61 63 6b 69 6e 67 20 77 69 6c 64 20 ll hacking wild 01d0: 6f 6e 20 74 68 65 20 63 6f 64 65 20 61 6e 64 20 on the code and 01e0: 6f 6e 65 20 63 61 6e 20 6f 6e 2d 74 68 65 2d 66 one can on-the-f 01f0: 6c 79 0a 20 20 66 65 74 63 68 20 61 20 5a 49 50 ly. fetch a ZIP 0200: 20 61 72 63 68 69 76 65 2c 20 62 75 74 20 74 68 archive, but th 0210: 61 74 27 73 20 61 20 6d 61 6e 75 61 6c 20 70 72 at's a manual pr 0220: 6f 63 65 73 73 2e 20 46 6f 72 20 70 61 63 6b 61 ocess. For packa 0230: 67 65 72 73 20 28 6c 69 6b 65 0a 20 20 6d 65 20 gers (like. me 0240: 69 6e 20 74 68 65 20 4f 70 65 6e 50 4b 47 20 70 in the OpenPKG p 0250: 72 6f 6a 65 63 74 29 20 74 68 69 73 20 69 73 20 roject) this is 0260: 76 65 72 79 20 6e 61 73 74 79 20 61 6e 64 20 6a very nasty and j 0270: 75 73 74 20 6d 65 61 6e 73 20 74 68 61 74 0a 20 ust means that. 0280: 20 46 6f 73 73 69 6c 20 77 69 6c 6c 20 75 73 75 Fossil will usu 0290: 61 6c 6c 79 20 73 74 69 6c 6c 20 6e 6f 74 20 62 ally still not b 02a0: 65 20 70 61 63 6b 61 67 65 64 2e 20 41 73 20 61 e packaged. As a 02b0: 20 72 65 73 75 6c 74 20 69 74 20 77 69 6c 6c 20 result it will 02c0: 62 65 20 6e 6f 74 0a 20 20 73 70 72 65 61 64 65 be not. spreade 02d0: 64 20 61 73 20 6d 75 63 68 20 61 73 20 70 6f 73 d as much as pos 02e0: 73 69 62 6c 65 20 61 6e 64 20 74 68 69 73 20 77 sible and this w 02f0: 61 79 20 79 6f 75 20 73 74 69 6c 6c 20 64 6f 20 ay you still do 0300: 6e 6f 74 20 67 65 74 20 61 73 20 6d 75 63 68 0a not get as much. 0310: 20 20 61 73 20 70 6f 73 73 69 62 6c 65 20 66 65 as possible fe 0320: 65 64 62 61 63 6b 2e 20 48 65 6e 63 65 2c 20 49 edback. Hence, I 0330: 20 72 65 63 6f 6d 6d 65 6e 64 20 74 68 61 74 20 recommend that 0340: 79 6f 75 20 6c 65 74 20 64 61 69 6c 79 20 73 6e you let daily sn 0350: 61 70 73 68 6f 74 0a 20 20 74 61 72 62 61 6c 6c apshot. tarball 0360: 73 20 28 6f 72 20 5a 49 50 20 66 69 6c 65 73 29 s (or ZIP files) 0370: 20 62 65 20 72 6f 6c 6c 65 64 2e 20 54 68 69 73 be rolled. This 0380: 20 77 6f 75 6c 64 20 62 65 20 67 72 65 61 74 2e would be great. 0390: 0a 0a 6f 20 55 55 49 44 0a 0a 20 20 55 6e 64 65 ..o UUID.. Unde 03a0: 72 20 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f 73 r http://www.fos 03b0: 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 69 6e 64 65 sil-scm.org/inde 03c0: 78 2e 68 74 6d 6c 2f 64 6f 63 2f 74 69 70 2f 77 x.html/doc/tip/w 03d0: 77 77 2f 63 6f 6e 63 65 70 74 73 2e 77 69 6b 69 ww/concepts.wiki 03e0: 0a 20 20 79 6f 75 20 64 65 73 63 72 69 62 65 20 . you describe 03f0: 74 68 65 20 63 6f 6e 63 65 70 74 73 20 61 6e 64 the concepts and 0400: 20 79 6f 75 20 63 6c 65 61 72 6c 79 20 6e 61 6d you clearly nam 0410: 65 20 74 68 65 20 61 72 74 69 66 61 63 74 20 49 e the artifact I 0420: 44 20 61 0a 20 20 22 55 55 49 44 22 20 61 6e 64 D a. "UUID" and 0430: 20 65 76 65 6e 20 73 61 79 20 74 68 61 74 20 74 even say that t 0440: 68 69 73 20 69 73 20 61 20 22 55 6e 69 76 65 72 his is a "Univer 0450: 73 61 6c 6c 79 20 55 6e 69 71 75 65 20 49 64 65 sally Unique Ide 0460: 6e 74 69 66 69 65 72 22 2e 0a 20 20 55 6e 66 6f ntifier".. Unfo 0470: 72 74 75 6e 61 74 65 6c 79 2c 20 61 20 55 55 49 rtunately, a UUI 0480: 44 20 69 73 20 61 20 31 32 38 2d 62 69 74 20 65 D is a 128-bit e 0490: 6e 74 69 74 79 20 73 74 61 6e 64 61 72 64 69 7a ntity standardiz 04a0: 65 64 20 62 79 20 74 68 65 20 49 53 4f 0a 20 20 ed by the ISO. 04b0: 28 75 6e 64 65 72 20 49 53 4f 2f 49 45 43 20 31 (under ISO/IEC 1 04c0: 31 35 37 38 3a 31 39 39 36 29 20 61 6e 64 20 49 1578:1996) and I 04d0: 45 54 46 20 28 75 6e 64 65 72 20 52 46 43 2d 34 ETF (under RFC-4 04e0: 31 32 32 29 20 61 6e 64 20 68 65 6e 63 65 20 69 122) and hence i 04f0: 74 20 69 73 0a 20 20 2a 56 45 52 59 20 4d 55 43 t is. *VERY MUC 0500: 48 2a 20 63 6f 6e 66 75 73 69 6e 67 20 61 6e 64 H* confusing and 0510: 20 75 6e 63 6c 65 61 6e 20 74 68 61 74 20 79 6f unclean that yo 0520: 75 72 20 31 36 30 2d 62 69 74 20 53 48 41 31 2d ur 160-bit SHA1- 0530: 62 61 73 65 64 20 49 44 20 69 73 0a 20 20 63 61 based ID is. ca 0540: 6c 6c 65 64 20 22 55 55 49 44 22 20 69 6e 20 46 lled "UUID" in F 0550: 6f 73 73 69 6c 2e 0a 0a 20 20 49 20 2a 53 54 52 ossil... I *STR 0560: 4f 4e 47 4c 59 2a 20 72 65 63 6f 6d 6d 65 6e 64 ONGLY* recommend 0570: 20 79 6f 75 20 74 6f 20 65 69 74 68 65 72 20 75 you to either u 0580: 73 65 20 72 65 61 6c 20 55 55 49 44 73 20 28 31 se real UUIDs (1 0590: 32 38 2d 62 69 74 0a 20 20 65 6e 74 69 74 69 65 28-bit. entitie 05a0: 73 2c 20 77 68 65 72 65 20 61 20 55 55 49 44 20 s, where a UUID 05b0: 6f 66 20 76 65 72 73 69 6f 6e 20 35 20 65 76 65 of version 5 eve 05c0: 6e 20 69 73 20 53 48 41 31 2d 62 61 73 65 64 21 n is SHA1-based! 05d0: 29 20 6f 72 20 79 6f 75 20 6e 61 6d 65 0a 20 20 ) or you name. 05e0: 79 6f 75 72 20 31 36 30 2d 62 69 74 20 53 48 41 your 160-bit SHA 05f0: 31 20 65 6e 74 69 74 69 65 73 20 64 69 66 66 65 1 entities diffe 0600: 72 65 6e 74 6c 79 20 28 70 65 72 68 61 70 73 20 rently (perhaps 0610: 41 49 44 20 66 6f 72 20 22 41 72 74 69 66 61 63 AID for "Artifac 0620: 74 0a 20 20 49 64 65 6e 74 69 66 69 65 72 22 3f t. Identifier"? 0630: 29 2e 0a 0a 6f 20 22 66 6f 73 73 69 6c 20 63 67 )...o "fossil cg 0640: 69 20 3c 73 63 72 69 70 74 3e 22 0a 0a 20 20 43 i <script>".. C 0650: 75 72 72 65 6e 74 6c 79 20 77 65 20 68 61 76 65 urrently we have 0660: 20 6f 6e 6c 79 20 22 66 6f 73 73 69 6c 20 63 67 only "fossil cg 0670: 69 20 3c 73 63 72 69 70 74 3e 22 20 77 68 65 72 i <script>" wher 0680: 65 20 3c 73 63 72 69 70 74 3e 20 63 6f 6e 74 61 e <script> conta 0690: 69 6e 73 0a 20 20 22 72 65 70 6f 73 69 74 6f 72 ins. "repositor 06a0: 79 3a 20 3c 66 69 6c 65 3e 22 2e 20 54 68 69 73 y: <file>". This 06b0: 20 69 73 20 61 20 6e 65 61 74 20 69 64 65 61 20 is a neat idea 06c0: 61 6e 64 20 73 68 6f 75 6c 64 20 62 65 20 6b 65 and should be ke 06d0: 70 74 2e 20 42 75 74 0a 20 20 74 68 69 73 20 77 pt. But. this w 06e0: 61 79 20 6f 6e 65 20 63 61 6e 6e 6f 74 20 65 61 ay one cannot ea 06f0: 73 69 6c 79 20 68 6f 73 74 20 6d 75 6c 74 69 70 sily host multip 0700: 6c 65 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 le repositories 0710: 6f 76 65 72 20 74 68 69 73 0a 20 20 43 47 49 20 over this. CGI 0720: 69 6e 74 65 72 66 61 63 65 20 77 69 74 68 6f 75 interface withou 0730: 74 20 63 72 65 61 74 69 6e 67 20 73 75 63 68 20 t creating such 0740: 61 20 73 63 72 69 70 74 20 66 6f 72 20 65 76 65 a script for eve 0750: 72 79 20 69 6e 64 69 76 69 64 75 61 6c 0a 20 20 ry individual. 0760: 72 65 70 6f 73 69 74 6f 72 79 2e 0a 0a 20 20 50 repository... P 0770: 65 72 68 61 70 73 20 61 20 22 66 6f 73 73 69 6c erhaps a "fossil 0780: 20 63 67 69 20 2d 2d 72 65 70 6f 73 69 74 6f 72 cgi --repositor 0790: 79 20 3c 66 69 6c 65 3e 22 20 77 6f 75 6c 64 20 y <file>" would 07a0: 68 65 6c 70 20 68 65 72 65 2c 20 61 73 20 74 68 help here, as th 07b0: 69 73 0a 20 20 77 61 79 20 6f 6e 65 20 63 61 6e is. way one can 07c0: 20 75 73 65 20 61 20 67 65 6e 65 72 69 63 20 43 use a generic C 07d0: 47 49 20 73 63 72 69 70 74 20 77 68 69 63 68 20 GI script which 07e0: 66 69 72 73 74 20 66 69 67 75 72 65 73 20 6f 75 first figures ou 07f0: 74 20 74 68 65 0a 20 20 6e 61 6d 65 20 3c 6e 61 t the. name <na 0800: 6d 65 3e 20 6f 66 20 74 68 65 20 69 6e 64 69 76 me> of the indiv 0810: 69 64 75 61 6c 20 70 72 6f 6a 65 63 74 20 61 6e idual project an 0820: 64 20 74 68 65 6e 20 72 75 6e 73 20 22 66 6f 73 d then runs "fos 0830: 73 69 6c 20 63 67 69 0a 20 20 2d 2d 72 65 70 6f sil cgi. --repo 0840: 73 69 74 6f 72 79 20 2f 70 61 74 68 2f 74 6f 2f sitory /path/to/ 0850: 72 65 70 6f 73 69 74 6f 72 69 65 73 2f 3c 6e 61 repositories/<na 0860: 6d 65 3e 2e 64 62 22 2e 20 42 75 74 20 70 65 72 me>.db". But per 0870: 68 61 70 73 20 49 27 6d 20 6a 75 73 74 0a 20 20 haps I'm just. 0880: 6f 76 65 72 6c 6f 6f 6b 69 6e 67 20 73 6f 6d 65 overlooking some 0890: 74 68 69 6e 67 20 61 6e 64 20 74 68 69 73 20 69 thing and this i 08a0: 73 20 61 6c 72 65 61 64 79 20 70 6f 73 73 69 62 s already possib 08b0: 6c 65 2e 2e 2e 0a 0a 6f 20 22 66 6f 73 73 69 6c le.....o "fossil 08c0: 20 64 62 20 3c 6f 70 65 72 61 74 69 6f 6e 3e 22 db <operation>" 08d0: 0a 0a 20 20 49 6e 20 4d 6f 6e 6f 74 6f 6e 65 20 .. In Monotone 08e0: 44 56 43 53 20 77 65 20 68 61 76 65 20 61 20 22 DVCS we have a " 08f0: 6d 74 6e 20 64 62 22 20 63 6f 6d 6d 61 6e 64 20 mtn db" command 0900: 66 6f 72 20 74 68 65 20 6c 6f 77 2d 6c 65 76 65 for the low-leve 0910: 6c 20 53 51 4c 69 74 65 0a 20 20 64 61 74 61 62 l SQLite. datab 0920: 61 73 65 20 6d 61 6e 69 70 75 6c 61 74 69 6f 6e ase manipulation 0930: 73 2e 20 46 6f 72 20 69 6e 73 74 61 6e 63 65 20 s. For instance 0940: 61 20 22 6d 74 6e 20 2d 2d 64 62 3d 3c 6d 6f 6e a "mtn --db=<mon 0950: 6f 74 6f 6e 65 2d 72 65 70 6f 73 69 74 6f 72 79 otone-repository 0960: 3e 0a 20 20 64 62 20 64 75 6d 70 22 20 69 73 20 >. db dump" is 0970: 6d 6f 72 65 20 6f 72 20 6c 65 73 73 20 65 71 75 more or less equ 0980: 61 6c 20 74 6f 20 61 20 22 73 71 6c 69 74 65 33 al to a "sqlite3 0990: 20 3c 6d 6f 6e 6f 74 6f 6e 65 2d 72 65 70 6f 73 <monotone-repos 09a0: 69 74 6f 72 79 3e 0a 20 20 2e 64 75 6d 70 22 2e itory>. .dump". 09b0: 20 41 20 22 6d 74 6e 20 2d 2d 64 62 3d 3c 6d 6f A "mtn --db=<mo 09c0: 6e 6f 74 6f 6e 65 2d 72 65 70 6f 73 69 74 6f 72 notone-repositor 09d0: 79 3e 20 64 62 20 65 78 65 63 20 27 3c 53 51 4c y> db exec '<SQL 09e0: 3e 27 22 20 69 73 20 65 71 75 61 6c 0a 20 20 22 >'" is equal. " 09f0: 65 63 68 6f 20 27 3c 53 51 4c 3e 27 20 7c 20 73 echo '<SQL>' | s 0a00: 71 6c 69 74 65 33 20 3c 6d 6f 6e 6f 74 6f 6e 65 qlite3 <monotone 0a10: 2d 72 65 70 6f 73 69 74 6f 72 79 3e 22 2c 20 65 -repository>", e 0a20: 74 63 2e 20 54 68 65 20 70 6f 69 6e 74 20 69 73 tc. The point is 0a30: 0a 20 20 74 68 61 74 20 74 68 65 20 44 56 43 53 . that the DVCS 0a40: 20 75 73 65 72 20 75 73 75 61 6c 6c 79 20 68 61 user usually ha 0a50: 73 20 6e 6f 20 53 51 4c 69 74 65 20 43 4c 49 20 s no SQLite CLI 0a60: 61 74 20 68 61 6e 64 20 62 75 74 20 61 73 20 74 at hand but as t 0a70: 68 65 20 44 56 43 53 0a 20 20 61 6c 72 65 61 64 he DVCS. alread 0a80: 79 20 63 6f 6e 74 61 69 6e 73 20 6d 6f 72 65 20 y contains more 0a90: 6f 72 20 6c 65 73 73 20 74 68 65 20 63 6f 6d 70 or less the comp 0aa0: 6c 65 74 65 20 53 51 4c 69 74 65 20 69 74 20 69 lete SQLite it i 0ab0: 73 20 76 65 72 79 20 75 73 65 66 75 6c 20 74 6f s very useful to 0ac0: 0a 20 20 61 6c 73 6f 20 69 6e 63 6c 75 64 65 20 . also include 0ad0: 74 68 65 20 53 51 4c 69 74 65 20 43 4c 49 20 66 the SQLite CLI f 0ae0: 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 61 6e 64 unctionality and 0af0: 20 77 69 72 65 20 69 74 20 69 6e 74 6f 20 74 68 wire it into th 0b00: 65 20 44 56 43 53 0a 20 20 43 4c 49 20 76 69 61 e DVCS. CLI via 0b10: 20 61 20 22 64 62 22 20 63 6f 6d 6d 61 6e 64 2e a "db" command. 0b20: 0a 0a 6f 20 22 66 6f 73 73 69 6c 20 76 65 72 73 ..o "fossil vers 0b30: 69 6f 6e 22 0a 0a 20 20 4d 6f 73 74 6c 79 20 61 ion".. Mostly a 0b40: 6c 6c 20 56 43 53 20 49 20 6b 6e 6f 77 20 69 66 ll VCS I know if 0b50: 20 65 69 74 68 65 72 20 73 75 70 70 6f 72 74 20 either support 0b60: 61 20 63 6f 6d 6d 61 6e 64 20 22 76 65 72 73 69 a command "versi 0b70: 6f 6e 22 20 6f 72 20 61 0a 20 20 63 6f 6d 6d 61 on" or a. comma 0b80: 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 20 22 nd-line option " 0b90: 2d 2d 76 65 72 73 69 6f 6e 22 20 6f 72 20 6d 6f --version" or mo 0ba0: 73 74 20 6f 66 20 74 68 65 20 74 69 6d 65 20 65 st of the time e 0bb0: 76 65 6e 20 62 6f 74 68 2e 20 50 6c 65 61 73 65 ven both. Please 0bc0: 0a 20 20 6f 75 74 70 75 74 20 74 68 65 20 22 54 . output the "T 0bd0: 68 69 73 20 69 73 20 66 6f 73 73 69 6c 20 76 65 his is fossil ve 0be0: 72 73 69 6f 6e 20 5b 39 65 38 30 64 63 36 36 63 rsion [9e80dc66c 0bf0: 66 5d 20 32 30 30 38 2d 31 30 2d 31 38 20 31 33 f] 2008-10-18 13 0c00: 3a 30 33 3a 33 36 22 0a 20 20 74 68 65 72 65 20 :03:36". there 0c10: 28 61 74 20 6c 65 61 73 74 20 61 64 64 69 74 69 (at least additi 0c20: 6f 6e 61 6c 6c 79 29 20 69 6e 73 74 65 61 64 20 onally) instead 0c30: 6f 66 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 of at the end of 0c40: 20 22 66 6f 73 73 69 6c 20 68 65 6c 70 22 2e 0a "fossil help".. 0c50: 0a 6f 20 22 2d 2d 70 6f 72 74 22 20 76 73 2e 20 .o "--port" vs. 0c60: 22 2d 70 6f 72 74 22 0a 0a 20 20 49 6e 20 74 68 "-port".. In th 0c70: 65 20 22 66 6f 73 73 69 6c 20 68 65 6c 70 20 73 e "fossil help s 0c80: 65 72 76 65 72 22 20 74 68 65 72 65 20 69 73 20 erver" there is 0c90: 22 2d 2d 70 6f 72 74 22 20 77 68 69 6c 65 20 75 "--port" while u 0ca0: 6e 64 65 72 0a 20 20 68 74 74 70 3a 2f 2f 77 77 nder. http://ww 0cb0: 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 w.fossil-scm.org 0cc0: 2f 69 6e 64 65 78 2e 68 74 6d 6c 2f 64 6f 63 2f /index.html/doc/ 0cd0: 74 69 70 2f 77 77 77 2f 71 75 69 63 6b 73 74 61 tip/www/quicksta 0ce0: 72 74 2e 77 69 6b 69 20 74 68 65 72 65 0a 20 20 rt.wiki there. 0cf0: 69 73 20 22 2d 70 6f 72 74 22 2e 20 49 20 70 65 is "-port". I pe 0d00: 72 73 6f 6e 61 6c 6c 79 20 6c 69 6b 65 20 47 4e rsonally like GN 0d10: 55 2d 6c 6f 6e 67 2d 73 74 79 6c 65 20 6f 70 74 U-long-style opt 0d20: 69 6f 6e 73 20 22 2d 2d 78 78 78 78 22 20 6d 6f ions "--xxxx" mo 0d30: 72 65 0a 20 20 74 68 61 6e 20 74 68 65 20 43 43 re. than the CC 0d40: 2d 73 74 79 6c 65 20 6f 70 74 69 6f 6e 73 20 22 -style options " 0d50: 2d 78 78 78 22 2e 20 42 75 74 20 61 6e 79 77 61 -xxx". But anywa 0d60: 79 2c 20 69 6e 64 65 70 65 6e 64 65 6e 74 20 77 y, independent w 0d70: 68 69 63 68 20 6f 6e 65 20 69 73 0a 20 20 63 6f hich one is. co 0d80: 72 72 65 63 74 20 28 77 65 6c 6c 2c 20 70 65 72 rrect (well, per 0d90: 68 61 70 73 20 62 6f 74 68 20 65 76 65 6e 20 77 haps both even w 0da0: 6f 72 6b 29 20 6f 6e 6c 79 20 6f 6e 65 20 73 68 ork) only one sh 0db0: 6f 75 6c 64 20 62 65 20 64 6f 63 75 6d 65 6e 74 ould be document 0dc0: 65 64 0a 20 20 74 6f 20 61 76 6f 69 64 20 63 6f ed. to avoid co 0dd0: 6e 66 75 73 69 6f 6e 2e 0a 0a 6f 20 55 73 65 72 nfusion...o User 0de0: 20 63 72 65 61 74 69 6f 6e 20 6f 6e 20 74 68 65 creation on the 0df0: 20 43 4c 49 0a 0a 20 20 54 68 65 72 65 20 69 73 CLI.. There is 0e00: 20 22 66 6f 73 73 69 6c 20 75 73 65 72 20 6e 65 "fossil user ne 0e10: 77 20 3f 55 53 45 52 4e 41 4d 45 3f 22 20 77 68 w ?USERNAME?" wh 0e20: 69 63 68 20 69 6e 74 65 72 61 63 74 69 76 65 6c ich interactivel 0e30: 79 20 70 72 6f 6d 70 74 73 0a 20 20 66 6f 72 20 y prompts. for 0e40: 74 68 65 20 63 61 70 61 62 69 6c 69 74 69 65 73 the capabilities 0e50: 20 61 6e 64 20 74 68 65 20 70 61 73 73 77 6f 72 and the passwor 0e60: 64 20 2d 2d 20 65 76 65 6e 20 66 72 6f 6d 20 74 d -- even from t 0e70: 68 65 20 54 54 59 20 61 6e 64 20 6e 6f 74 0a 20 he TTY and not. 0e80: 20 66 72 6f 6d 20 53 54 44 49 4e 2e 20 4f 6e 65 from STDIN. One 0e90: 20 6e 65 65 64 73 20 22 66 6f 73 73 69 6c 20 75 needs "fossil u 0ea0: 73 65 72 20 6e 65 77 20 3f 55 53 45 52 4e 41 4d ser new ?USERNAM 0eb0: 45 3f 20 3f 43 41 50 41 42 49 4c 49 54 49 45 53 E? ?CAPABILITIES 0ec0: 3f 0a 20 20 3f 50 41 53 53 57 4f 52 44 3f 22 20 ?. ?PASSWORD?" 0ed0: 74 6f 20 62 65 20 61 62 6c 65 20 74 6f 20 63 72 to be able to cr 0ee0: 65 61 74 65 20 61 20 72 65 70 6f 73 69 74 6f 72 eate a repositor 0ef0: 79 20 69 6e 20 62 61 74 63 68 20 77 69 74 68 6f y in batch witho 0f00: 75 74 20 68 61 76 69 6e 67 0a 20 20 74 6f 20 68 ut having. to h 0f10: 61 63 6b 20 74 68 65 20 75 73 65 72 20 69 6e 74 ack the user int 0f20: 6f 20 74 68 65 20 22 75 73 65 72 22 20 74 61 62 o the "user" tab 0f30: 6c 65 20 76 69 61 20 74 68 65 20 53 51 4c 69 74 le via the SQLit 0f40: 65 20 43 4c 49 2e 20 53 69 6d 69 6c 61 72 3a 0a e CLI. Similar:. 0f50: 20 20 74 68 65 20 22 66 6f 73 73 69 6c 20 75 73 the "fossil us 0f60: 65 72 20 70 61 73 73 77 6f 72 64 20 55 53 45 52 er password USER 0f70: 4e 41 4d 45 22 20 73 68 6f 75 6c 64 20 62 65 20 NAME" should be 0f80: 61 63 74 75 61 6c 6c 79 20 22 66 6f 73 73 69 6c actually "fossil 0f90: 20 75 73 65 72 0a 20 20 70 61 73 73 77 6f 72 64 user. password 0fa0: 20 55 53 45 52 4e 41 4d 45 20 3f 50 41 53 53 57 USERNAME ?PASSW 0fb0: 4f 52 44 3f 22 2c 20 70 6c 65 61 73 65 2e 0a 0a ORD?", please... 0fc0: 6f 20 22 2d 52 20 3c 72 65 70 6f 73 69 74 6f 72 o "-R <repositor 0fd0: 79 22 0a 0a 20 20 54 68 65 72 65 20 69 73 20 74 y".. There is t 0fe0: 68 65 20 22 2d 52 22 20 6f 70 74 69 6f 6e 20 66 he "-R" option f 0ff0: 6f 72 20 73 70 65 63 69 66 69 79 69 6e 67 20 74 or specifiying t 1000: 68 65 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 42 he repository. B 1010: 75 74 20 69 74 20 69 73 0a 20 20 61 20 73 75 62 ut it is. a sub 1020: 2d 63 6f 6d 6d 61 6e 64 20 6f 70 74 69 6f 6e 20 -command option 1030: 61 6e 64 20 6e 6f 74 20 61 20 67 6c 6f 62 61 6c and not a global 1040: 20 6f 70 74 69 6f 6e 2e 20 41 6e 64 20 6f 6e 20 option. And on 1050: 22 66 6f 73 73 69 6c 20 75 69 22 20 6f 72 0a 20 "fossil ui" or. 1060: 20 22 66 6f 73 73 69 6c 20 73 65 72 76 65 72 22 "fossil server" 1070: 20 69 74 20 65 76 65 6e 20 69 73 20 61 6e 20 61 it even is an a 1080: 72 67 75 6d 65 6e 74 20 61 6e 64 20 6e 6f 74 20 rgument and not 1090: 61 6e 20 6f 70 74 69 6f 6e 2e 20 54 68 69 73 20 an option. This 10a0: 69 73 0a 20 20 63 6f 6e 66 75 73 69 6e 67 2e 20 is. confusing. 10b0: 45 76 65 72 79 20 74 69 6d 65 20 6f 6e 65 20 68 Every time one h 10c0: 61 73 20 74 6f 20 66 69 67 75 72 65 20 6f 75 74 as to figure out 10d0: 20 68 6f 77 20 74 6f 20 73 65 74 20 74 68 65 20 how to set the 10e0: 72 65 70 6f 73 69 74 6f 72 79 0a 20 20 6f 6e 20 repository. on 10f0: 74 68 65 20 43 4c 49 2e 20 4d 6f 6e 6f 74 6f 6e the CLI. Monoton 1100: 65 20 73 69 6d 70 6c 79 20 75 73 65 73 20 61 20 e simply uses a 1110: 2a 67 6c 6f 62 61 6c 2a 20 6f 70 74 69 6f 6e 20 *global* option 1120: 22 2d 2d 64 62 22 20 61 6e 64 20 74 68 61 74 27 "--db" and that' 1130: 73 0a 20 20 69 74 2e 20 53 6f 2c 20 49 20 72 65 s. it. So, I re 1140: 63 6f 6d 6d 65 6e 64 20 74 68 61 74 20 46 6f 73 commend that Fos 1150: 73 69 6c 20 61 6c 73 6f 20 75 73 65 73 20 61 20 sil also uses a 1160: 73 69 6e 67 6c 65 20 67 6c 6f 62 61 6c 20 6f 70 single global op 1170: 74 69 6f 6e 0a 20 20 22 2d 2d 72 65 70 6f 73 69 tion. "--reposi 1180: 74 6f 72 79 22 2f 22 2d 52 22 20 69 6e 73 74 65 tory"/"-R" inste 1190: 61 64 20 6f 66 20 61 20 63 6f 6d 6d 61 6e 64 2d ad of a command- 11a0: 73 70 65 63 69 66 69 63 20 6f 70 74 69 6f 6e 2e specific option. 11b0: 20 53 75 72 65 2c 20 6e 6f 74 0a 20 20 61 6c 6c Sure, not. all 11c0: 20 63 6f 6d 6d 61 6e 64 73 20 6d 69 67 68 74 20 commands might 11d0: 72 65 71 75 69 72 65 20 61 20 72 65 70 6f 73 69 require a reposi 11e0: 74 6f 72 79 2c 20 62 75 74 20 49 4d 48 4f 20 69 tory, but IMHO i 11f0: 74 20 69 73 20 62 65 74 74 65 72 20 74 6f 0a 20 t is better to. 1200: 20 69 67 6e 6f 72 65 20 74 68 65 20 67 6c 6f 62 ignore the glob 1210: 61 6c 20 6f 70 74 69 6f 6e 20 74 68 65 72 65 20 al option there 1220: 74 68 61 6e 20 68 61 76 69 6e 67 20 74 6f 20 66 than having to f 1230: 69 67 75 72 65 20 6f 75 74 20 65 76 65 72 79 20 igure out every 1240: 74 69 6d 65 0a 20 20 68 6f 77 20 74 68 65 20 72 time. how the r 1250: 65 70 6f 73 69 74 6f 72 79 20 68 61 73 20 74 6f epository has to 1260: 20 62 65 20 73 70 65 63 69 66 69 65 64 2e 0a 0a be specified... 1270: 6f 20 53 65 74 75 70 20 70 61 67 65 73 0a 0a 20 o Setup pages.. 1280: 20 57 68 65 6e 20 68 69 74 74 69 6e 67 20 22 41 When hitting "A 1290: 70 70 6c 79 20 63 68 61 6e 67 65 73 22 20 6f 6e pply changes" on 12a0: 20 61 6e 79 20 73 65 74 75 70 20 70 61 67 65 2c any setup page, 12b0: 20 6f 6e 65 20 6b 65 65 70 73 20 73 74 61 79 69 one keeps stayi 12c0: 6e 67 20 6f 6e 0a 20 20 74 68 69 73 20 70 61 67 ng on. this pag 12d0: 65 2e 20 53 75 72 65 2c 20 74 68 61 74 27 73 20 e. Sure, that's 12e0: 77 68 61 74 20 61 6e 20 22 61 70 70 6c 79 22 20 what an "apply" 12f0: 62 75 74 74 6f 6e 20 75 73 75 61 6c 6c 79 20 69 button usually i 1300: 73 20 61 62 6f 75 74 2e 20 42 75 74 0a 20 20 49 s about. But. I 1310: 20 61 74 20 6c 65 61 73 74 20 77 6f 75 6c 64 20 at least would 1320: 68 61 76 65 20 6c 69 6b 65 64 20 74 6f 20 73 65 have liked to se 1330: 65 20 61 20 62 75 74 74 6f 6e 20 28 65 69 74 68 e a button (eith 1340: 65 72 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 er instead of th 1350: 65 0a 20 20 22 61 70 70 6c 79 20 63 68 61 6e 67 e. "apply chang 1360: 65 73 22 20 6f 72 20 61 74 20 6c 65 61 73 74 20 es" or at least 1370: 69 6e 20 61 64 64 69 74 69 6f 6e 29 20 77 68 69 in addition) whi 1380: 63 68 20 61 70 70 6c 69 65 73 20 74 68 65 20 63 ch applies the c 1390: 68 61 6e 67 65 73 20 61 6e 64 0a 20 20 67 6f 65 hanges and. goe 13a0: 73 20 62 61 63 6b 20 74 6f 20 74 68 65 20 73 65 s back to the se 13b0: 74 75 70 20 6d 61 69 6e 20 70 61 67 65 20 28 66 tup main page (f 13c0: 72 6f 6d 20 77 68 65 72 65 20 6f 6e 65 20 75 73 rom where one us 13d0: 75 61 6c 6c 79 20 63 6f 6d 65 29 2e 0a 0a 6f 20 ually come)...o 13e0: 5f 46 4f 53 53 49 4c 5f 0a 0a 20 20 20 20 56 65 _FOSSIL_.. Ve 13f0: 72 79 20 6e 69 63 65 20 69 64 65 61 20 74 6f 20 ry nice idea to 1400: 75 73 65 20 61 6e 6f 74 68 65 72 20 53 51 4c 69 use another SQLi 1410: 74 65 20 64 61 74 61 62 61 73 65 20 66 6f 72 20 te database for 1420: 74 68 65 20 5f 46 4f 53 53 49 4c 5f 0a 20 20 20 the _FOSSIL_. 1430: 20 63 6f 6e 74 72 6f 6c 20 66 69 6c 65 2e 20 42 control file. B 1440: 55 54 3a 20 57 68 79 20 22 5f 46 4f 53 53 49 4c UT: Why "_FOSSIL 1450: 5f 22 3f 20 43 56 53 27 73 20 22 43 56 53 22 20 _"? CVS's "CVS" 1460: 64 69 72 65 63 74 6f 72 79 20 77 61 73 20 75 67 directory was ug 1470: 6c 79 20 66 6f 72 0a 20 20 20 20 64 65 63 61 64 ly for. decad 1480: 65 73 2e 20 54 6f 64 61 79 20 77 65 20 68 61 76 es. Today we hav 1490: 65 20 22 2e 73 76 6e 22 2c 20 22 2e 67 69 74 22 e ".svn", ".git" 14a0: 2c 20 22 2e 68 67 22 20 61 6e 64 20 22 5f 4d 54 , ".hg" and "_MT 14b0: 4e 22 2f 22 2e 6d 74 6e 22 20 74 6f 20 67 65 74 N"/".mtn" to get 14c0: 0a 20 20 20 20 72 69 64 20 6f 66 20 74 68 6f 73 . rid of thos 14d0: 65 20 75 67 6c 79 20 63 6f 6e 74 72 6f 6c 20 66 e ugly control f 14e0: 69 6c 65 73 20 6f 72 20 64 69 72 65 63 74 6f 72 iles or director 14f0: 69 65 73 20 6f 66 20 74 68 65 20 44 56 43 53 21 ies of the DVCS! 1500: 20 53 75 72 65 2c 0a 20 20 20 20 64 6f 74 2d 66 Sure,. dot-f 1510: 69 6c 65 73 20 61 72 65 20 64 69 73 6c 69 6b 65 iles are dislike 1520: 64 20 62 79 20 57 69 6e 64 6f 77 73 20 70 65 6f d by Windows peo 1530: 70 6c 65 2e 20 42 75 74 20 74 68 61 74 27 73 20 ple. But that's 1540: 6e 6f 20 70 72 6f 62 6c 65 6d 2c 20 6f 6e 65 0a no problem, one. 1550: 20 20 20 20 63 61 6e 20 61 63 63 65 70 74 20 22 can accept " 1560: 5f 58 58 58 22 20 69 6e 20 61 64 64 69 74 69 6f _XXX" in additio 1570: 6e 20 74 6f 20 22 2e 58 58 58 22 20 65 61 73 69 n to ".XXX" easi 1580: 6c 79 2c 20 6f 66 20 63 6f 75 72 73 65 2e 0a 0a ly, of course... 1590: 20 20 20 20 53 6f 2c 20 49 20 72 65 61 6c 6c 79 So, I really 15a0: 20 77 6f 75 6c 64 20 6c 69 6b 65 20 74 6f 20 73 would like to s 15b0: 65 65 20 74 68 65 20 66 69 6c 65 20 22 5f 46 4f ee the file "_FO 15c0: 53 53 49 4c 5f 22 20 74 6f 20 62 65 20 72 65 6e SSIL_" to be ren 15d0: 61 6d 65 64 0a 20 20 20 20 74 6f 20 22 2e 66 6f amed. to ".fo 15e0: 73 73 69 6c 22 20 75 6e 64 65 72 20 55 6e 69 78 ssil" under Unix 15f0: 20 61 6e 64 20 22 5f 66 6f 73 73 69 6c 22 20 75 and "_fossil" u 1600: 6e 64 65 72 20 57 69 6e 64 6f 77 73 20 6f 72 20 nder Windows or 1610: 28 69 66 20 74 68 65 0a 20 20 20 20 75 70 70 65 (if the. uppe 1620: 72 2d 63 61 73 65 20 69 73 20 69 6d 70 6f 72 74 r-case is import 1630: 61 6e 74 20 74 6f 20 79 6f 75 29 20 22 2e 46 4f ant to you) ".FO 1640: 53 53 49 4c 22 20 61 6e 64 20 22 5f 46 4f 53 53 SSIL" and "_FOSS 1650: 49 4c 22 2e 20 42 75 74 20 74 6f 20 73 65 65 0a IL". But to see. 1660: 20 20 20 20 61 6e 20 75 67 6c 79 20 22 5f 46 4f an ugly "_FO 1670: 53 53 49 4c 5f 22 20 61 74 20 74 68 65 20 74 6f SSIL_" at the to 1680: 70 20 6f 66 20 65 76 65 72 79 20 73 6f 75 72 63 p of every sourc 1690: 65 20 74 72 65 65 20 69 73 20 72 65 61 6c 6c 79 e tree is really 16a0: 20 72 61 74 68 65 72 0a 20 20 20 20 62 6f 72 69 rather. bori 16b0: 6e 67 20 66 6f 72 20 55 6e 69 78 20 70 65 6f 70 ng for Unix peop 16c0: 6c 65 21 0a 0a 6f 20 22 66 6f 73 73 69 6c 20 6f le!..o "fossil o 16d0: 70 65 6e 22 2c 20 22 66 6f 73 73 69 6c 20 63 68 pen", "fossil ch 16e0: 65 63 6b 6f 75 74 22 2c 20 22 66 6f 73 73 69 6c eckout", "fossil 16f0: 20 75 70 64 61 74 65 22 2e 0a 0a 20 20 49 27 6d update"... I'm 1700: 20 70 65 72 73 6f 6e 61 6c 6c 79 20 63 6f 6e 66 personally conf 1710: 75 73 65 64 20 74 68 61 74 20 22 66 6f 73 73 69 used that "fossi 1720: 6c 20 6f 70 65 6e 22 20 69 73 20 77 68 61 74 20 l open" is what 1730: 22 63 68 65 63 6b 6f 75 74 22 20 64 6f 65 73 20 "checkout" does 1740: 69 6e 0a 20 20 6f 74 68 65 72 20 44 56 43 53 20 in. other DVCS 1750: 61 6e 64 20 74 68 61 74 20 22 63 68 65 63 6b 6f and that "checko 1760: 75 74 22 20 69 73 20 6a 75 73 74 20 61 20 76 61 ut" is just a va 1770: 72 69 61 6e 74 20 6f 66 20 22 75 70 64 61 74 65 riant of "update 1780: 22 2e 20 48 6d 6d 6d 2e 2e 2e 0a 20 20 66 6f 72 ". Hmmm.... for 1790: 20 6d 65 20 69 74 20 6c 6f 6f 6b 73 20 61 74 20 me it looks at 17a0: 6c 65 61 73 74 20 6f 6e 65 20 73 68 6f 75 6c 64 least one should 17b0: 20 62 65 20 65 6c 65 6d 69 6e 61 74 65 64 20 74 be eleminated t 17c0: 6f 20 72 65 64 75 63 65 20 63 6f 6e 66 75 73 69 o reduce confusi 17d0: 6f 6e 2e 0a 20 20 54 68 65 20 64 69 66 66 65 72 on.. The differ 17e0: 65 6e 63 65 20 62 65 74 77 65 65 6e 20 63 68 65 ence between che 17f0: 63 6b 6f 75 74 20 61 6e 64 20 75 70 64 61 74 65 ckout and update 1800: 20 63 6f 75 6c 64 20 62 65 63 6f 6d 65 20 61 6e could become an 1810: 20 6f 70 74 69 6f 6e 20 6f 66 0a 20 20 61 20 73 option of. a s 1820: 69 6e 67 6c 65 20 6f 70 74 69 6f 6e 2e 20 41 6e ingle option. An 1830: 64 20 74 68 65 20 72 65 6d 61 69 6e 69 6e 67 20 d the remaining 1840: 74 6f 20 70 65 72 68 61 70 73 20 62 65 74 74 65 to perhaps bette 1850: 72 20 73 68 6f 75 6c 64 20 62 65 20 65 69 74 68 r should be eith 1860: 65 72 0a 20 20 22 6f 70 65 6e 22 20 2b 20 22 75 er. "open" + "u 1870: 70 64 61 74 65 22 20 6f 72 20 22 63 68 65 63 6b pdate" or "check 1880: 6f 75 74 22 20 2b 20 22 75 70 64 61 74 65 22 2e out" + "update". 1890: 20 57 65 6c 6c 2c 20 70 65 72 68 61 70 73 20 49 Well, perhaps I 18a0: 27 6d 20 73 74 69 6c 6c 0a 20 20 6e 6f 74 20 75 'm still. not u 18b0: 6e 64 65 72 73 74 61 6e 64 69 6e 67 20 46 6f 73 nderstanding Fos 18c0: 73 69 6c 20 65 6e 6f 75 67 68 2e 20 42 75 74 20 sil enough. But 18d0: 49 20 63 61 6e 20 6f 6e 6c 79 20 74 65 6c 6c 20 I can only tell 18e0: 74 68 61 74 20 49 20 67 6f 74 20 72 61 74 68 65 that I got rathe 18f0: 72 0a 20 20 63 6f 6e 66 75 73 65 64 2e 0a 0a 6f r. confused...o 1900: 20 22 66 6f 73 73 69 6c 20 63 6f 6d 6d 69 74 22 "fossil commit" 1910: 0a 0a 20 20 54 68 65 72 65 20 69 73 20 22 66 6f .. There is "fo 1920: 73 73 69 6c 20 63 6f 6d 6d 69 74 22 20 62 75 74 ssil commit" but 1930: 20 6e 6f 20 73 68 6f 72 74 2d 68 61 6e 64 20 22 no short-hand " 1940: 66 6f 73 73 69 6c 20 63 69 22 2e 20 42 75 74 20 fossil ci". But 1950: 74 68 65 72 65 0a 20 20 69 73 20 22 66 6f 73 73 there. is "foss 1960: 69 6c 20 73 74 61 74 75 73 22 20 61 6e 64 20 65 il status" and e 1970: 76 65 6e 20 6a 75 73 74 20 22 66 6f 73 73 69 6c ven just "fossil 1980: 20 73 74 22 20 77 68 69 63 68 20 63 6c 65 61 72 st" which clear 1990: 6c 79 20 73 68 6f 77 73 0a 20 20 74 68 61 74 20 ly shows. that 19a0: 46 6f 73 73 69 6c 20 61 6c 6c 6f 77 73 20 61 62 Fossil allows ab 19b0: 62 72 65 76 69 61 74 69 6f 6e 73 20 6f 72 20 61 breviations or a 19c0: 74 20 6c 65 61 73 74 20 70 72 65 66 69 78 2d 6d t least prefix-m 19d0: 61 74 63 68 69 6e 67 20 6f 6e 20 74 68 65 0a 20 atching on the. 19e0: 20 63 6f 6d 6d 61 6e 64 73 2e 20 53 75 72 65 2c commands. Sure, 19f0: 20 22 63 69 22 20 69 73 20 6e 6f 74 20 61 20 70 "ci" is not a p 1a00: 72 65 66 69 78 20 6f 66 20 22 63 6f 6d 6d 69 74 refix of "commit 1a10: 22 20 62 75 74 20 6d 6f 73 74 6c 79 20 61 6c 6c " but mostly all 1a20: 20 56 43 53 0a 20 20 73 75 70 70 6f 72 74 20 74 VCS. support t 1a30: 68 65 20 67 6f 6f 64 20 6f 6c 64 20 52 43 53 2f he good old RCS/ 1a40: 43 56 53 20 22 63 69 22 20 61 6e 64 20 73 69 6d CVS "ci" and sim 1a50: 69 6c 61 72 20 61 6c 69 61 73 65 73 2e 20 53 6f ilar aliases. So 1a60: 20 49 20 72 65 63 6f 6d 6d 65 6e 64 0a 20 20 74 I recommend. t 1a70: 68 61 74 20 46 6f 73 73 69 6c 20 64 6f 65 73 20 hat Fossil does 1a80: 6e 6f 74 20 6f 6e 6c 79 20 61 6c 69 61 73 20 6d not only alias m 1a90: 61 74 63 68 69 6e 67 2c 20 62 75 74 20 61 6c 73 atching, but als 1aa0: 6f 20 70 72 6f 76 69 64 65 73 20 61 6c 69 61 73 o provides alias 1ab0: 65 73 3a 0a 20 20 22 63 69 22 20 66 6f 72 20 22 es:. "ci" for " 1ac0: 63 6f 6d 6d 69 74 22 2c 20 22 63 6f 22 20 66 6f commit", "co" fo 1ad0: 72 20 22 63 68 65 63 6b 6f 75 74 22 2c 20 22 6c r "checkout", "l 1ae0: 6f 67 22 20 66 6f 72 20 22 74 69 6d 65 6c 69 6e og" for "timelin 1af0: 65 22 2c 20 65 74 63 2e 0a 20 20 53 6f 72 72 79 e", etc.. Sorry 1b00: 2c 20 68 61 76 69 6e 67 20 74 6f 20 74 79 70 65 , having to type 1b10: 20 74 68 65 20 6c 6f 6e 67 20 22 66 6f 73 73 69 the long "fossi 1b20: 6c 20 63 6f 6d 6d 69 74 22 20 65 76 65 72 79 20 l commit" every 1b30: 74 69 6d 65 20 69 73 20 74 6f 6f 20 6c 6f 6e 67 time is too long 1b40: 0a 20 20 66 6f 72 20 75 73 20 55 6e 69 78 20 68 . for us Unix h 1b50: 61 63 6b 65 72 73 20 3b 2d 29 0a 0a 20 20 41 64 ackers ;-).. Ad 1b60: 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 46 6f 73 73 ditionally, Foss 1b70: 69 6c 20 73 65 65 6d 73 20 74 6f 20 75 73 65 20 il seems to use 1b80: 47 6e 75 50 47 20 77 68 65 6e 20 69 6e 73 74 61 GnuPG when insta 1b90: 6c 6c 65 64 20 61 6e 64 20 2d 2d 6e 6f 73 69 67 lled and --nosig 1ba0: 6e 20 69 73 0a 20 20 6e 6f 74 20 73 70 65 63 69 n is. not speci 1bb0: 66 69 65 64 2e 20 48 6d 6d 2e 2e 2e 20 74 77 6f fied. Hmm... two 1bc0: 20 71 75 65 73 74 69 6f 6e 73 20 61 72 69 73 65 questions arise 1bd0: 20 68 65 72 65 20 66 6f 72 20 6d 65 3a 20 31 2e here for me: 1. 1be0: 20 73 68 6f 75 6c 64 20 74 68 65 0a 20 20 75 73 should the. us 1bf0: 65 20 6f 66 20 61 20 63 72 79 70 74 6f 67 72 61 e of a cryptogra 1c00: 70 68 69 63 61 6c 6c 79 20 73 74 72 6f 6e 67 20 phically strong 1c10: 73 69 67 6e 61 74 75 72 65 20 72 65 61 6c 6c 79 signature really 1c20: 20 62 65 20 6a 75 73 74 20 5f 6f 70 74 69 6f 6e be just _option 1c30: 61 6c 5f 0a 20 20 28 4d 6f 6e 6f 74 6f 6e 65 20 al_. (Monotone 1c40: 66 6f 72 20 69 6e 73 74 61 6e 63 65 20 52 53 41 for instance RSA 1c50: 20 73 69 67 6e 73 20 65 76 65 72 79 20 63 6f 6d signs every com 1c60: 6d 69 74 29 20 61 6e 64 20 32 2e 20 69 73 20 47 mit) and 2. is G 1c70: 6e 75 50 47 20 68 65 72 65 0a 20 20 72 65 61 6c nuPG here. real 1c80: 6c 79 20 74 68 65 20 72 69 67 68 74 20 74 6f 6f ly the right too 1c90: 6c 20 28 4d 6f 6e 6f 74 6f 6e 65 20 64 6f 65 73 l (Monotone does 1ca0: 20 61 20 70 6c 61 69 6e 20 52 53 41 20 73 69 67 a plain RSA sig 1cb0: 6e 69 6e 67 20 61 6e 64 20 69 73 20 65 76 65 6e ning and is even 1cc0: 0a 20 20 61 62 6c 65 20 74 6f 20 6c 65 76 65 72 . able to lever 1cd0: 61 67 65 20 61 20 72 75 6e 6e 69 6e 67 20 53 53 age a running SS 1ce0: 48 20 61 67 65 6e 74 20 66 6f 72 20 74 68 65 20 H agent for the 1cf0: 6f 70 65 72 61 74 69 6f 6e 20 2d 2d 20 73 6f 6d operation -- som 1d00: 65 74 68 69 6e 67 0a 20 20 77 68 69 63 68 20 69 ething. which i 1d10: 73 20 76 65 72 79 20 63 6f 6f 6c 20 62 6f 74 68 s very cool both 1d20: 20 75 6e 64 65 72 20 55 6e 69 78 20 77 69 74 68 under Unix with 1d30: 20 22 73 73 68 2d 61 67 65 6e 74 22 20 61 6e 64 "ssh-agent" and 1d40: 20 75 6e 64 65 72 20 57 69 6e 64 6f 77 73 0a 20 under Windows. 1d50: 20 77 69 74 68 20 22 70 61 67 65 6e 74 22 29 2e with "pagent"). 1d60: 20 4f 54 4f 48 2c 20 47 6e 75 50 47 20 32 2e 78 OTOH, GnuPG 2.x 1d70: 20 73 75 70 70 6f 72 74 73 20 61 20 67 70 67 2d supports a gpg- 1d80: 61 67 65 6e 74 2c 20 73 6f 20 74 68 69 73 20 6d agent, so this m 1d90: 69 67 68 74 20 62 65 0a 20 20 6e 6f 20 6c 6f 6e ight be. no lon 1da0: 67 65 72 20 61 20 62 69 67 20 69 73 73 75 65 2e ger a big issue. 1db0: 20 42 75 74 20 46 6f 73 73 69 6c 20 73 68 6f 75 But Fossil shou 1dc0: 6c 64 20 64 6f 63 75 6d 65 6e 74 20 74 68 69 73 ld document this 1dd0: 20 61 20 6c 69 74 74 6c 65 20 62 69 74 0a 20 20 a little bit. 1de0: 66 75 74 68 65 72 3a 20 68 6f 77 20 74 6f 20 63 futher: how to c 1df0: 72 65 61 74 65 20 74 68 65 20 6e 65 63 65 73 73 reate the necess 1e00: 61 72 79 20 47 6e 75 50 47 20 6b 65 79 2c 20 68 ary GnuPG key, h 1e10: 6f 77 20 74 6f 20 73 65 74 75 70 20 67 70 67 2d ow to setup gpg- 1e20: 61 67 65 6e 74 2c 0a 20 20 65 74 63 2e 0a 0a 6f agent,. etc...o 1e30: 20 22 66 6f 73 73 69 6c 20 64 69 66 66 22 0a 0a "fossil diff".. 1e40: 20 20 54 68 65 72 65 20 69 73 20 22 55 73 61 67 There is "Usag 1e50: 65 3a 20 66 6f 73 73 69 6c 20 64 69 66 66 7c 67 e: fossil diff|g 1e60: 64 69 66 66 20 3f 2d 69 3f 20 3f 2d 72 20 52 45 diff ?-i? ?-r RE 1e70: 56 49 53 49 4f 4e 3f 20 46 49 4c 45 2e 2e 2e 22 VISION? FILE..." 1e80: 2e 20 54 77 6f 0a 20 20 71 75 65 73 74 69 6f 6e . Two. question 1e90: 73 20 61 72 69 73 65 3a 20 57 68 79 20 64 6f 20 s arise: Why do 1ea0: 49 20 68 61 76 65 20 74 6f 20 73 70 65 63 69 66 I have to specif 1eb0: 79 20 61 20 22 46 49 4c 45 22 3f 20 49 20 77 6f y a "FILE"? I wo 1ec0: 75 6c 64 20 65 78 70 65 63 74 0a 20 20 74 68 61 uld expect. tha 1ed0: 74 20 61 20 73 69 6d 70 6c 65 20 22 66 6f 73 73 t a simple "foss 1ee0: 69 6c 20 64 69 66 66 22 20 72 65 63 75 72 73 69 il diff" recursi 1ef0: 76 65 6c 79 20 73 68 6f 77 73 20 61 20 22 64 69 vely shows a "di 1f00: 66 66 22 20 6f 66 20 61 6c 6c 20 63 68 61 6e 67 ff" of all chang 1f10: 65 64 0a 20 20 66 69 6c 65 73 20 69 6e 20 74 68 ed. files in th 1f20: 65 20 73 6f 75 72 63 65 20 74 72 65 65 2e 20 41 e source tree. A 1f30: 64 64 69 74 69 6f 6e 61 6c 6c 79 2c 20 68 6f 77 dditionally, how 1f40: 20 64 6f 65 73 20 6f 6e 65 20 64 6f 20 61 20 64 does one do a d 1f50: 69 66 66 20 62 65 74 77 65 65 6e 0a 20 20 74 77 iff between. tw 1f60: 6f 20 70 61 72 74 69 63 75 6c 61 72 20 72 65 76 o particular rev 1f70: 69 73 69 6f 6e 73 20 28 6f 6e 65 20 73 65 65 6d isions (one seem 1f80: 73 20 74 6f 20 62 65 20 6e 6f 74 20 61 62 6c 65 s to be not able 1f90: 20 74 6f 20 73 70 65 63 69 66 69 79 20 22 2d 72 to specifiy "-r 1fa0: 22 0a 20 20 74 77 69 63 65 29 2e 0a 0a 6f 20 22 ". twice)...o " 1fb0: 6d 61 6e 69 66 65 73 74 22 20 2f 20 22 6d 61 6e manifest" / "man 1fc0: 69 66 65 73 74 2e 75 75 69 64 22 0a 0a 20 20 41 ifest.uuid".. A 1fd0: 62 6f 76 65 20 49 20 77 61 73 20 61 6c 72 65 61 bove I was alrea 1fe0: 64 79 20 62 6f 74 68 65 72 65 64 20 62 79 20 74 dy bothered by t 1ff0: 68 65 20 5f 46 4f 53 53 49 4c 5f 20 66 69 6c 65 he _FOSSIL_ file 2000: 2c 20 62 75 74 20 6e 6f 77 20 74 68 61 74 20 49 , but now that I 2010: 0a 20 20 70 6c 61 79 65 64 20 77 69 74 68 20 46 . played with F 2020: 6f 73 73 69 6c 20 49 20 73 65 65 20 74 68 61 74 ossil I see that 2030: 20 22 6d 61 6e 69 66 65 73 74 22 20 61 6e 64 20 "manifest" and 2040: 22 6d 61 6e 69 66 65 73 74 2e 75 75 69 64 22 20 "manifest.uuid" 2050: 66 69 6c 65 73 0a 20 20 73 68 6f 77 65 64 20 75 files. showed u 2060: 70 20 69 6e 20 6d 79 20 73 6f 75 72 63 65 20 74 p in my source t 2070: 72 65 65 2e 20 57 68 79 20 69 73 20 74 68 69 73 ree. Why is this 2080: 20 6e 6f 74 20 69 6d 70 6c 69 63 69 74 6c 79 20 not implicitly 2090: 69 6e 20 74 68 65 0a 20 20 64 61 74 61 62 61 73 in the. databas 20a0: 65 20 61 6e 64 20 69 6e 73 74 65 61 64 20 65 78 e and instead ex 20b0: 74 65 72 6e 61 6c 6c 79 20 72 65 70 72 65 73 65 ternally represe 20c0: 6e 74 65 64 20 69 6e 20 74 68 65 20 73 6f 75 72 nted in the sour 20d0: 63 65 20 74 72 65 65 2e 0a 20 20 48 6d 6d 6d 2e ce tree.. Hmmm. 20e0: 2e 2e 20 74 68 65 6e 20 49 20 72 65 63 6f 6d 6d .. then I recomm 20f0: 65 6e 64 20 74 68 61 74 20 79 6f 75 20 75 73 65 end that you use 2100: 20 61 20 2e 66 6f 73 73 69 6c 20 2a 44 49 52 45 a .fossil *DIRE 2110: 43 54 4f 52 59 2a 2c 20 70 6c 61 63 65 0a 20 20 CTORY*, place. 2120: 74 68 65 20 63 6f 6e 74 72 6f 6c 20 66 69 6c 65 the control file 2130: 20 69 6e 74 6f 20 2e 66 6f 73 73 69 6c 2f 63 6f into .fossil/co 2140: 6e 74 72 6f 6c 20 28 6f 72 20 77 68 61 74 65 76 ntrol (or whatev 2150: 65 72 29 20 61 6e 64 20 74 68 65 20 6d 61 6e 69 er) and the mani 2160: 66 65 73 74 0a 20 20 73 74 75 66 66 20 69 6e 74 fest. stuff int 2170: 6f 20 2e 66 6f 73 73 69 6c 2f 6d 61 6e 69 66 65 o .fossil/manife 2180: 73 74 20 61 6e 64 20 2e 66 6f 73 73 69 6c 2f 6d st and .fossil/m 2190: 61 6e 69 66 65 73 74 2e 75 75 69 64 2e 20 42 75 anifest.uuid. Bu 21a0: 74 20 70 6c 65 61 73 65 20 64 6f 0a 20 20 6e 6f t please do. no 21b0: 74 20 63 6c 75 74 74 65 72 20 74 68 65 20 74 6f t clutter the to 21c0: 70 2d 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 73 p-level of the s 21d0: 6f 75 72 63 65 20 74 68 72 65 65 20 77 69 74 68 ource three with 21e0: 20 63 6f 6e 74 72 6f 6c 20 64 61 74 61 20 6f 66 control data of 21f0: 20 74 68 65 0a 20 20 44 56 43 53 2e 0a 0a 6f 20 the. DVCS...o 2200: 22 66 6f 73 73 69 6c 20 6d 76 22 0a 0a 20 20 54 "fossil mv".. T 2210: 68 65 72 65 20 69 73 20 22 66 6f 73 73 69 6c 20 here is "fossil 2220: 61 64 64 22 20 61 6e 64 20 22 66 6f 73 73 69 6c add" and "fossil 2230: 20 72 6d 22 2c 20 62 75 74 20 6e 6f 20 22 66 6f rm", but no "fo 2240: 73 73 69 6c 20 6d 76 22 2e 20 48 6f 70 65 66 75 ssil mv". Hopefu 2250: 6c 6c 79 0a 20 20 74 68 69 73 20 64 6f 65 73 6e lly. this doesn 2260: 27 74 20 6d 65 61 6e 20 61 20 66 69 6c 65 20 6d 't mean a file m 2270: 6f 76 65 20 69 73 20 61 6e 20 22 61 64 64 22 20 ove is an "add" 2280: 61 6e 64 20 61 20 22 72 65 6d 6f 76 65 22 20 62 and a "remove" b 2290: 75 6e 64 6c 65 2c 20 61 73 0a 20 20 74 68 69 73 undle, as. this 22a0: 20 77 61 79 20 46 6f 73 73 69 6c 20 77 6f 75 6c way Fossil woul 22b0: 64 20 68 61 76 65 20 74 72 6f 75 62 6c 65 20 74 d have trouble t 22c0: 6f 20 6b 6e 6f 77 20 74 68 61 74 20 74 68 65 20 o know that the 22d0: 66 69 6c 65 20 77 61 73 20 72 65 6e 61 6d 65 64 file was renamed 22e0: 0a 20 20 61 6e 64 20 68 65 6e 63 65 20 74 68 65 . and hence the 22f0: 20 66 75 6c 6c 20 68 69 73 74 6f 72 79 20 74 72 full history tr 2300: 61 63 6b 69 6e 67 20 6f 66 20 61 20 66 69 6c 65 acking of a file 2310: 20 73 65 65 6d 73 20 74 6f 20 62 65 20 62 72 6f seems to be bro 2320: 6b 65 6e 2e 0a 0a 6f 20 22 66 6f 73 73 69 6c 20 ken...o "fossil 2330: 63 68 61 6e 67 65 73 22 20 76 73 2e 20 22 66 6f changes" vs. "fo 2340: 73 73 69 6c 20 73 74 61 74 75 73 22 0a 0a 20 20 ssil status".. 2350: 46 69 6e 61 6c 6c 79 2c 20 49 20 67 6f 74 20 63 Finally, I got c 2360: 6f 6e 66 75 73 65 64 20 62 79 20 74 68 65 20 22 onfused by the " 2370: 66 6f 73 73 69 6c 20 63 68 61 6e 67 65 73 22 20 fossil changes" 2380: 61 6e 64 20 22 66 6f 73 73 69 6c 20 73 74 61 74 and "fossil stat 2390: 75 73 22 0a 20 20 63 6f 6d 6d 61 6e 64 73 2e 20 us". commands. 23a0: 22 66 6f 73 73 69 6c 20 73 74 61 74 75 73 22 20 "fossil status" 23b0: 73 65 65 6d 73 20 74 6f 20 62 65 20 61 20 73 75 seems to be a su 23c0: 70 65 72 2d 73 65 74 20 6f 66 20 22 66 6f 73 73 per-set of "foss 23d0: 69 6c 20 63 68 61 6e 67 65 73 22 2e 0a 20 20 4c il changes".. L 23e0: 6f 6f 6b 73 20 61 20 6c 69 74 74 6c 65 20 62 69 ooks a little bi 23f0: 74 20 6c 65 73 73 20 6f 72 74 68 6f 67 6f 6e 61 t less orthogona 2400: 6c 20 74 68 61 6e 20 6e 65 63 65 73 73 61 72 79 l than necessary 2410: 2e 20 49 20 77 6f 75 6c 64 20 72 65 6d 6f 76 65 . I would remove 2420: 0a 20 20 22 66 6f 73 73 69 6c 20 63 68 61 6e 67 . "fossil chang 2430: 65 73 22 20 6f 72 20 61 74 20 6c 65 61 73 74 20 es" or at least 2440: 64 6f 20 6e 6f 74 20 73 68 6f 77 20 74 68 65 20 do not show the 2450: 66 69 6c 65 20 64 65 74 61 69 6c 73 20 6f 6e 20 file details on 2460: 22 66 6f 73 73 69 6c 0a 20 20 73 74 61 74 75 73 "fossil. status 2470: 22 2e 0a 0a 59 6f 75 72 73 2c 0a 20 20 20 20 20 "...Yours,. 2480: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 24a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 24b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 24c0: 20 20 20 20 20 20 20 52 61 6c 66 20 53 2e 20 45 Ralf S. E 24d0: 6e 67 65 6c 73 63 68 61 6c 6c 0a 0a ngelschall..