Artifact c4c7a9be7e5e2e1c939909b215817c6163365c49:
File www/pop.html part of check-in [b110d77c36] - Website updates. by drh on 2007-08-09 01:08:19.
0000: 3c 68 74 6d 6c 3e 0a 3c 68 65 61 64 3e 0a 3c 74 <html>.<head>.<t 0010: 69 74 6c 65 3e 46 6f 73 73 69 6c 20 2d 20 50 72 itle>Fossil - Pr 0020: 69 6e 63 69 70 6c 65 73 20 6f 66 20 4f 70 65 72 inciples of Oper 0030: 61 74 69 6f 6e 3c 2f 74 69 74 6c 65 3e 0a 3c 2f ation</title>.</ 0040: 68 65 61 64 3e 0a 3c 62 6f 64 79 20 62 67 63 6f head>.<body bgco 0050: 6c 6f 72 3d 22 77 68 69 74 65 22 3e 0a 3c 68 31 lor="white">.<h1 0060: 3e 50 72 69 6e 63 69 70 6c 65 73 20 4f 66 20 4f >Principles Of O 0070: 70 65 72 61 74 69 6f 6e 3c 2f 68 31 3e 0a 0a 3c peration</h1>..< 0080: 70 3e 0a 54 68 69 73 20 70 61 67 65 20 61 74 74 p>.This page att 0090: 65 6d 70 74 73 20 74 6f 20 64 65 66 69 6e 65 20 empts to define 00a0: 74 68 65 20 66 6f 75 6e 64 61 74 69 6f 6e 61 6c the foundational 00b0: 20 70 72 69 6e 63 69 70 61 6c 73 20 75 70 6f 6e principals upon 00c0: 0a 77 68 69 63 68 20 46 6f 73 73 69 6c 20 69 73 .which Fossil is 00d0: 20 62 75 69 6c 74 2e 0a 3c 2f 70 3e 0a 0a 3c 75 built..</p>..<u 00e0: 6c 3e 0a 3c 6c 69 3e 3c 70 3e 41 20 70 72 6f 6a l>.<li><p>A proj 00f0: 65 63 74 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 ect consists of 0100: 73 6f 75 72 63 65 20 66 69 6c 65 73 2c 20 77 69 source files, wi 0110: 6b 69 20 70 61 67 65 73 2c 20 61 6e 64 20 0a 74 ki pages, and .t 0120: 72 6f 75 62 6c 65 20 74 69 63 6b 65 74 73 2e 20 rouble tickets. 0130: 20 41 6c 6c 20 68 69 73 74 6f 72 69 63 61 6c 20 All historical 0140: 63 6f 70 69 65 73 20 6f 66 20 61 6c 6c 20 74 68 copies of all th 0150: 65 73 65 0a 65 6e 74 69 74 69 65 73 20 61 72 65 ese.entities are 0160: 20 73 61 76 65 64 2e 20 20 54 68 65 20 70 72 6f saved. The pro 0170: 6a 65 63 74 20 6d 61 69 6e 74 61 69 6e 73 20 61 ject maintains a 0180: 6e 20 61 75 64 69 74 0a 74 72 61 69 6c 2e 3c 2f n audit.trail.</ 0190: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e p></li>..<li><p> 01a0: 41 20 70 72 6f 6a 65 63 74 20 72 65 73 69 64 65 A project reside 01b0: 73 20 69 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 s in one or more 01c0: 20 72 65 70 6f 73 69 74 6f 72 69 65 73 2e 20 20 repositories. 01d0: 45 61 63 68 0a 72 65 70 6f 73 69 74 6f 72 79 20 Each.repository 01e0: 69 73 20 61 64 6d 69 6e 69 73 74 65 72 65 64 20 is administered 01f0: 61 6e 64 20 6f 70 65 72 61 74 65 73 20 69 6e 64 and operates ind 0200: 65 70 65 6e 64 65 6e 74 6c 79 20 0a 6f 66 20 74 ependently .of t 0210: 68 65 20 6f 74 68 65 72 73 2e 3c 2f 70 3e 3c 2f he others.</p></ 0220: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 45 61 63 68 li>..<li><p>Each 0230: 20 72 65 70 6f 73 69 74 6f 72 79 20 68 61 73 20 repository has 0240: 62 6f 74 68 20 67 6c 6f 62 61 6c 20 61 6e 64 20 both global and 0250: 6c 6f 63 61 6c 20 73 74 61 74 65 2e 20 20 54 68 local state. Th 0260: 65 0a 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 69 e.global state i 0270: 73 20 63 6f 6d 6d 6f 6e 20 74 6f 20 61 6c 6c 20 s common to all 0280: 72 65 70 6f 73 69 74 6f 72 69 65 73 20 28 6f 72 repositories (or 0290: 20 61 74 20 6c 65 61 73 74 0a 68 61 73 20 74 68 at least.has th 02a0: 65 20 70 6f 74 65 6e 74 69 61 6c 20 74 6f 20 62 e potential to b 02b0: 65 20 73 68 61 72 65 64 20 69 6e 20 63 6f 6d 6d e shared in comm 02c0: 6f 6e 20 77 68 65 6e 20 74 68 65 0a 72 65 70 6f on when the.repo 02d0: 73 69 74 6f 72 69 65 73 20 61 72 65 20 66 75 6c sitories are ful 02e0: 6c 79 20 73 79 6e 63 68 72 6f 6e 69 7a 65 64 29 ly synchronized) 02f0: 2e 20 20 54 68 65 20 6c 6f 63 61 6c 20 73 74 61 . The local sta 0300: 74 65 0a 66 6f 72 20 65 61 63 68 20 72 65 70 6f te.for each repo 0310: 73 69 74 6f 72 79 20 69 73 20 70 72 69 76 61 74 sitory is privat 0320: 65 20 74 6f 20 74 68 61 74 20 72 65 70 6f 73 69 e to that reposi 0330: 74 6f 72 79 2e 0a 54 68 65 20 67 6c 6f 62 61 6c tory..The global 0340: 20 73 74 61 74 65 20 72 65 70 72 65 73 65 6e 74 state represent 0350: 73 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 s the content of 0360: 20 74 68 65 20 70 72 6f 6a 65 63 74 2e 0a 54 68 the project..Th 0370: 65 20 6c 6f 63 61 6c 20 73 74 61 74 65 20 69 64 e local state id 0380: 65 6e 74 69 66 69 65 73 20 74 68 65 20 61 75 74 entifies the aut 0390: 68 6f 72 69 7a 65 64 20 75 73 65 72 73 20 61 6e horized users an 03a0: 64 0a 61 63 63 65 73 73 20 70 6f 6c 69 63 69 65 d.access policie 03b0: 73 20 66 6f 72 20 61 20 70 61 72 74 69 63 75 6c s for a particul 03c0: 61 72 20 72 65 70 6f 73 69 74 6f 72 79 2e 3c 2f ar repository.</ 03d0: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e p></li>..<li><p> 03e0: 54 68 65 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 The global state 03f0: 20 6f 66 20 61 20 72 65 70 6f 73 69 74 6f 72 79 of a repository 0400: 20 69 73 20 61 6e 20 75 6e 6f 72 64 65 72 65 64 is an unordered 0410: 0a 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 20 66 .collection of f 0420: 69 6c 65 73 2e 20 20 45 61 63 68 20 66 69 6c 65 iles. Each file 0430: 20 69 73 20 6e 61 6d 65 64 20 62 79 20 0a 69 74 is named by .it 0440: 73 20 53 48 41 31 20 68 61 73 68 20 65 6e 63 6f s SHA1 hash enco 0450: 64 65 64 20 69 6e 20 68 65 78 61 64 65 63 69 6d ded in hexadecim 0460: 61 6c 2e 0a 49 6e 20 6d 61 6e 79 20 63 6f 6e 74 al..In many cont 0470: 65 78 74 73 2c 20 74 68 65 20 6e 61 6d 65 20 63 exts, the name c 0480: 61 6e 20 62 65 0a 61 62 62 72 65 76 69 61 74 65 an be.abbreviate 0490: 64 20 74 6f 20 61 20 75 6e 69 71 75 65 20 70 72 d to a unique pr 04a0: 65 66 69 78 2e 20 20 41 20 66 69 76 65 2d 20 6f efix. A five- o 04b0: 72 20 73 69 78 2d 63 68 61 72 61 63 74 65 72 0a r six-character. 04c0: 70 72 65 66 69 78 20 75 73 75 61 6c 6c 79 20 73 prefix usually s 04d0: 75 66 66 69 63 65 73 20 74 6f 20 75 6e 69 71 75 uffices to uniqu 04e0: 65 6c 79 20 69 64 65 6e 74 69 66 79 20 61 20 66 ely identify a f 04f0: 69 6c 65 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c ile.</p></li>..< 0500: 6c 69 3e 3c 70 3e 42 65 63 61 75 73 65 20 66 69 li><p>Because fi 0510: 6c 65 73 20 61 72 65 20 6e 61 6d 65 64 20 62 79 les are named by 0520: 20 74 68 65 69 72 20 53 48 41 31 20 68 61 73 68 their SHA1 hash 0530: 2c 20 61 6c 6c 20 66 69 6c 65 73 0a 61 72 65 20 , all files.are 0540: 69 6d 6d 75 74 61 62 6c 65 2e 20 20 41 6e 79 20 immutable. Any 0550: 63 68 61 6e 67 65 20 74 6f 20 74 68 65 20 63 6f change to the co 0560: 6e 74 65 6e 74 20 6f 66 20 61 20 66 69 6c 65 20 ntent of a file 0570: 61 6c 73 6f 20 0a 63 68 61 6e 67 65 73 20 74 68 also .changes th 0580: 65 20 68 61 73 68 20 74 68 61 74 20 66 6f 72 6d e hash that form 0590: 73 20 74 68 65 20 66 69 6c 65 73 20 6e 61 6d 65 s the files name 05a0: 2c 20 74 68 75 73 0a 63 72 65 61 74 69 6e 67 20 , thus.creating 05b0: 61 20 6e 65 77 20 66 69 6c 65 2e 20 20 42 6f 74 a new file. Bot 05c0: 68 20 74 68 65 20 6f 6c 64 20 6f 72 69 67 69 6e h the old origin 05d0: 61 6c 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 al version of th 05e0: 65 0a 66 69 6c 65 20 61 6e 64 20 74 68 65 20 6e e.file and the n 05f0: 65 77 20 63 68 61 6e 67 65 20 61 72 65 20 70 72 ew change are pr 0600: 65 73 65 72 76 65 64 20 75 6e 64 65 72 20 64 69 eserved under di 0610: 66 66 65 72 65 6e 74 20 6e 61 6d 65 73 2e 3c 2f fferent names.</ 0620: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e p></li>..<li><p> 0630: 49 74 20 69 73 20 74 68 65 6f 72 65 74 69 63 61 It is theoretica 0640: 6c 6c 79 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 lly possible for 0650: 20 74 77 6f 20 66 69 6c 65 73 20 77 69 74 68 20 two files with 0660: 64 69 66 66 65 72 65 6e 74 0a 63 6f 6e 74 65 6e different.conten 0670: 74 20 74 6f 20 73 68 61 72 65 20 74 68 65 20 73 t to share the s 0680: 61 6d 65 20 68 61 73 68 2e 20 20 42 75 74 20 66 ame hash. But f 0690: 69 6e 64 69 6e 67 20 74 77 6f 20 73 75 63 68 0a inding two such. 06a0: 66 69 6c 65 73 20 69 73 20 73 6f 20 69 6e 63 72 files is so incr 06b0: 65 64 69 62 6c 79 20 64 69 66 66 69 63 75 6c 74 edibly difficult 06c0: 20 61 6e 64 20 75 6e 6c 69 6b 65 6c 79 20 74 68 and unlikely th 06d0: 61 74 20 77 65 0a 63 6f 6e 73 69 64 65 72 20 69 at we.consider i 06e0: 74 20 74 6f 20 62 65 20 61 6e 20 69 6d 70 6f 73 t to be an impos 06f0: 73 69 62 69 6c 69 74 79 2e 3c 2f 70 3e 3c 2f 6c sibility.</p></l 0700: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 68 65 20 73 i>..<li><p>The s 0710: 69 67 6e 61 74 75 72 65 20 6f 66 20 61 20 66 69 ignature of a fi 0720: 6c 65 20 69 73 20 74 68 65 20 53 48 41 31 20 68 le is the SHA1 h 0730: 61 73 68 20 6f 66 20 74 68 65 20 0a 66 69 6c 65 ash of the .file 0740: 20 69 74 73 65 6c 66 2c 20 65 78 61 63 74 6c 79 itself, exactly 0750: 20 61 73 20 69 74 20 61 70 70 65 61 72 73 20 6f as it appears o 0760: 6e 20 64 69 73 6b 2e 20 20 4e 6f 20 70 72 65 66 n disk. No pref 0770: 69 78 0a 6f 72 20 6d 65 74 61 2d 69 6e 66 6f 72 ix.or meta-infor 0780: 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 mation about the 0790: 20 66 69 6c 65 20 69 73 20 61 64 64 65 64 20 62 file is added b 07a0: 65 66 6f 72 65 20 63 6f 6d 70 75 74 69 6e 67 0a efore computing. 07b0: 74 68 65 20 68 61 73 68 2e 20 20 53 6f 20 79 6f the hash. So yo 07c0: 75 20 63 61 6e 0a 61 6c 77 61 79 73 20 66 69 6e u can.always fin 07d0: 64 20 74 68 65 20 53 48 41 31 20 73 69 67 6e 61 d the SHA1 signa 07e0: 74 75 72 65 20 6f 66 20 61 20 66 69 6c 65 20 62 ture of a file b 07f0: 79 20 75 73 69 6e 67 20 74 68 65 0a 22 73 68 61 y using the."sha 0800: 31 73 75 6d 22 20 63 6f 6d 6d 61 6e 64 2d 6c 69 1sum" command-li 0810: 6e 65 20 75 74 69 6c 69 74 79 2e 3c 2f 70 3e 3c ne utility.</p>< 0820: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 68 65 /li>..<li><p>The 0830: 20 66 69 6c 65 73 20 74 68 61 74 20 63 6f 6d 70 files that comp 0840: 72 69 73 65 20 74 68 65 20 67 6c 6f 62 61 6c 20 rise the global 0850: 73 74 61 74 65 20 6f 66 20 61 20 72 65 70 6f 73 state of a repos 0860: 69 74 6f 72 79 0a 61 72 65 20 74 68 65 20 63 6f itory.are the co 0870: 6d 70 6c 65 74 65 20 67 6c 6f 62 61 6c 20 73 74 mplete global st 0880: 61 74 65 20 6f 66 20 74 68 61 74 20 72 65 70 6f ate of that repo 0890: 73 69 74 6f 72 79 2e 20 20 54 68 65 20 53 51 4c sitory. The SQL 08a0: 69 74 65 0a 64 61 74 61 62 61 73 65 20 74 68 61 ite.database tha 08b0: 74 20 68 6f 6c 64 73 20 74 68 65 20 72 65 70 6f t holds the repo 08c0: 73 69 74 6f 72 79 20 63 6f 6e 74 61 69 6e 73 20 sitory contains 08d0: 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 additional infor 08e0: 6d 61 74 69 6f 6e 0a 61 62 6f 75 74 20 6c 69 6e mation.about lin 08f0: 6b 61 67 65 73 20 62 65 74 77 65 65 6e 20 66 69 kages between fi 0900: 6c 65 73 2c 20 62 75 74 20 61 6c 6c 20 6f 66 20 les, but all of 0910: 74 68 61 74 20 61 64 64 65 64 20 69 6e 66 6f 72 that added infor 0920: 6d 61 74 69 6f 6e 0a 63 61 6e 20 62 65 20 64 69 mation.can be di 0930: 73 63 61 72 64 65 64 20 61 6e 64 20 72 65 63 6f scarded and reco 0940: 6e 73 74 72 75 63 74 65 64 20 62 79 20 72 65 73 nstructed by res 0950: 63 61 6e 6e 69 6e 67 20 74 68 65 20 63 6f 6e 74 canning the cont 0960: 65 6e 74 0a 66 69 6c 65 73 2e 3c 2f 70 3e 3c 2f ent.files.</p></ 0970: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 77 6f 20 li>..<li><p>Two 0980: 72 65 70 6f 73 69 74 6f 72 69 65 73 20 66 6f 72 repositories for 0990: 20 74 68 65 20 73 61 6d 65 20 70 72 6f 6a 65 63 the same projec 09a0: 74 20 63 61 6e 20 73 79 6e 63 68 72 6f 6e 69 7a t can synchroniz 09b0: 65 0a 74 68 65 69 72 20 67 6c 6f 62 61 6c 20 73 e.their global s 09c0: 74 61 74 65 73 20 73 69 6d 70 6c 79 20 62 79 20 tates simply by 09d0: 73 68 61 72 69 6e 67 20 66 69 6c 65 73 2e 20 20 sharing files. 09e0: 54 68 65 20 6c 6f 63 61 6c 0a 73 74 61 74 65 20 The local.state 09f0: 6f 66 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 of repositories 0a00: 69 73 20 6e 6f 74 20 6e 6f 72 6d 61 6c 6c 79 20 is not normally 0a10: 73 79 6e 63 68 72 6f 6e 69 7a 65 64 20 6f 72 0a synchronized or. 0a20: 73 68 61 72 65 64 2e 3c 2f 70 3e 3c 2f 6c 69 3e shared.</p></li> 0a30: 0a 0a 3c 6c 69 3e 3c 70 3e 45 76 65 72 79 20 72 ..<li><p>Every r 0a40: 65 70 6f 73 69 74 6f 72 79 20 68 61 73 20 61 20 epository has a 0a50: 73 70 65 63 69 61 6c 20 66 69 6c 65 20 61 74 20 special file at 0a60: 74 68 65 20 74 6f 70 2d 6c 65 76 65 6c 0a 6e 61 the top-level.na 0a70: 6d 65 64 20 22 6d 61 6e 69 66 65 73 74 22 20 77 med "manifest" w 0a80: 68 69 63 68 20 69 73 20 61 6e 20 69 6e 64 65 78 hich is an index 0a90: 20 6f 66 20 61 6c 6c 20 6f 74 68 65 72 20 66 69 of all other fi 0aa0: 6c 65 73 20 69 6e 0a 74 68 65 20 73 79 73 74 65 les in.the syste 0ab0: 6d 2e 20 20 54 68 65 20 6d 61 6e 69 66 65 73 74 m. The manifest 0ac0: 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c is automaticall 0ad0: 79 20 63 72 65 61 74 65 64 20 61 6e 64 0a 6d 61 y created and.ma 0ae0: 69 6e 74 61 69 6e 65 64 20 62 79 20 74 68 65 20 intained by the 0af0: 73 79 73 74 65 6d 2e 3c 2f 70 3e 3c 2f 6c 69 3e system.</p></li> 0b00: 0a 0a 3c 6c 69 3e 3c 70 3e 54 68 65 20 3c 61 20 ..<li><p>The <a 0b10: 68 72 65 66 3d 22 66 69 6c 65 66 6f 72 6d 61 74 href="fileformat 0b20: 2e 68 74 6d 6c 22 3e 66 69 6c 65 20 66 6f 72 6d .html">file form 0b30: 61 74 73 3c 2f 61 3e 0a 75 73 65 64 20 62 79 20 ats</a>.used by 0b40: 46 6f 73 73 69 6c 20 61 72 65 20 61 6c 6c 20 76 Fossil are all v 0b50: 65 72 79 20 73 69 6d 70 6c 65 20 73 6f 20 74 68 ery simple so th 0b60: 61 74 20 77 69 74 68 20 61 63 63 65 73 73 0a 74 at with access.t 0b70: 6f 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 63 o the original c 0b80: 6f 6e 74 65 6e 74 20 66 69 6c 65 73 2c 20 6f 6e ontent files, on 0b90: 65 20 63 61 6e 20 65 61 73 69 6c 79 20 72 65 63 e can easily rec 0ba0: 6f 6e 73 74 72 75 63 74 0a 74 68 65 20 63 6f 6e onstruct.the con 0bb0: 74 65 6e 74 20 6f 66 20 61 20 62 61 73 65 6c 69 tent of a baseli 0bc0: 6e 65 20 77 69 74 68 6f 75 74 20 74 68 65 20 6e ne without the n 0bd0: 65 65 64 20 66 6f 72 20 61 6e 79 0a 73 70 65 63 eed for any.spec 0be0: 69 61 6c 20 74 6f 6f 6c 73 20 6f 72 20 73 6f 66 ial tools or sof 0bf0: 74 77 61 72 65 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a tware.</p></li>. 0c00: 0a 3c 2f 62 6f 64 79 3e 0a 3c 2f 68 74 6d 6c 3e .</body>.</html> 0c10: 0a .