Artifact be259767d3cdade46dc5e77584af5d9f4e3dc7c9:
File www/pop.html part of check-in [469002ccdf] - Added navbar to all pages, linking back to the index. Fixed typo in the index page. by aku on 2007-09-12 04:19:59. Also file www/pop.html part of check-in [bbcb6326c9] - Pulled in the navbar and timeline changes. by aku on 2007-09-17 00:58:51.
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 70 3e lor="white">.<p> 0060: 5b 20 3c 61 20 68 72 65 66 3d 22 69 6e 64 65 78 [ <a href="index 0070: 2e 68 74 6d 6c 22 3e 49 6e 64 65 78 3c 2f 61 3e .html">Index</a> 0080: 20 5d 3c 2f 70 3e 0a 3c 68 72 3e 0a 3c 68 31 3e ]</p>.<hr>.<h1> 0090: 50 72 69 6e 63 69 70 6c 65 73 20 4f 66 20 4f 70 Principles Of Op 00a0: 65 72 61 74 69 6f 6e 3c 2f 68 31 3e 0a 0a 3c 70 eration</h1>..<p 00b0: 3e 0a 54 68 69 73 20 70 61 67 65 20 61 74 74 65 >.This page atte 00c0: 6d 70 74 73 20 74 6f 20 64 65 66 69 6e 65 20 74 mpts to define t 00d0: 68 65 20 66 6f 75 6e 64 61 74 69 6f 6e 61 6c 20 he foundational 00e0: 70 72 69 6e 63 69 70 61 6c 73 20 75 70 6f 6e 0a principals upon. 00f0: 77 68 69 63 68 20 46 6f 73 73 69 6c 20 69 73 20 which Fossil is 0100: 62 75 69 6c 74 2e 0a 3c 2f 70 3e 0a 0a 3c 75 6c built..</p>..<ul 0110: 3e 0a 3c 6c 69 3e 3c 70 3e 41 20 70 72 6f 6a 65 >.<li><p>A proje 0120: 63 74 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 73 ct consists of s 0130: 6f 75 72 63 65 20 66 69 6c 65 73 2c 20 77 69 6b ource files, wik 0140: 69 20 70 61 67 65 73 2c 20 61 6e 64 20 0a 74 72 i pages, and .tr 0150: 6f 75 62 6c 65 20 74 69 63 6b 65 74 73 2e 20 20 ouble tickets. 0160: 41 6c 6c 20 68 69 73 74 6f 72 69 63 61 6c 20 63 All historical c 0170: 6f 70 69 65 73 20 6f 66 20 61 6c 6c 20 74 68 65 opies of all the 0180: 73 65 0a 65 6e 74 69 74 69 65 73 20 61 72 65 20 se.entities are 0190: 73 61 76 65 64 2e 20 20 54 68 65 20 70 72 6f 6a saved. The proj 01a0: 65 63 74 20 6d 61 69 6e 74 61 69 6e 73 20 61 6e ect maintains an 01b0: 20 61 75 64 69 74 0a 74 72 61 69 6c 2e 3c 2f 70 audit.trail.</p 01c0: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 41 ></li>..<li><p>A 01d0: 20 70 72 6f 6a 65 63 74 20 72 65 73 69 64 65 73 project resides 01e0: 20 69 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 in one or more 01f0: 72 65 70 6f 73 69 74 6f 72 69 65 73 2e 20 20 45 repositories. E 0200: 61 63 68 0a 72 65 70 6f 73 69 74 6f 72 79 20 69 ach.repository i 0210: 73 20 61 64 6d 69 6e 69 73 74 65 72 65 64 20 61 s administered a 0220: 6e 64 20 6f 70 65 72 61 74 65 73 20 69 6e 64 65 nd operates inde 0230: 70 65 6e 64 65 6e 74 6c 79 20 0a 6f 66 20 74 68 pendently .of th 0240: 65 20 6f 74 68 65 72 73 2e 3c 2f 70 3e 3c 2f 6c e others.</p></l 0250: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 45 61 63 68 20 i>..<li><p>Each 0260: 72 65 70 6f 73 69 74 6f 72 79 20 68 61 73 20 62 repository has b 0270: 6f 74 68 20 67 6c 6f 62 61 6c 20 61 6e 64 20 6c oth global and l 0280: 6f 63 61 6c 20 73 74 61 74 65 2e 20 20 54 68 65 ocal state. The 0290: 0a 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 69 73 .global state is 02a0: 20 63 6f 6d 6d 6f 6e 20 74 6f 20 61 6c 6c 20 72 common to all r 02b0: 65 70 6f 73 69 74 6f 72 69 65 73 20 28 6f 72 20 epositories (or 02c0: 61 74 20 6c 65 61 73 74 0a 68 61 73 20 74 68 65 at least.has the 02d0: 20 70 6f 74 65 6e 74 69 61 6c 20 74 6f 20 62 65 potential to be 02e0: 20 73 68 61 72 65 64 20 69 6e 20 63 6f 6d 6d 6f shared in commo 02f0: 6e 20 77 68 65 6e 20 74 68 65 0a 72 65 70 6f 73 n when the.repos 0300: 69 74 6f 72 69 65 73 20 61 72 65 20 66 75 6c 6c itories are full 0310: 79 20 73 79 6e 63 68 72 6f 6e 69 7a 65 64 29 2e y synchronized). 0320: 20 20 54 68 65 20 6c 6f 63 61 6c 20 73 74 61 74 The local stat 0330: 65 0a 66 6f 72 20 65 61 63 68 20 72 65 70 6f 73 e.for each repos 0340: 69 74 6f 72 79 20 69 73 20 70 72 69 76 61 74 65 itory is private 0350: 20 74 6f 20 74 68 61 74 20 72 65 70 6f 73 69 74 to that reposit 0360: 6f 72 79 2e 0a 54 68 65 20 67 6c 6f 62 61 6c 20 ory..The global 0370: 73 74 61 74 65 20 72 65 70 72 65 73 65 6e 74 73 state represents 0380: 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 the content of 0390: 74 68 65 20 70 72 6f 6a 65 63 74 2e 0a 54 68 65 the project..The 03a0: 20 6c 6f 63 61 6c 20 73 74 61 74 65 20 69 64 65 local state ide 03b0: 6e 74 69 66 69 65 73 20 74 68 65 20 61 75 74 68 ntifies the auth 03c0: 6f 72 69 7a 65 64 20 75 73 65 72 73 20 61 6e 64 orized users and 03d0: 0a 61 63 63 65 73 73 20 70 6f 6c 69 63 69 65 73 .access policies 03e0: 20 66 6f 72 20 61 20 70 61 72 74 69 63 75 6c 61 for a particula 03f0: 72 20 72 65 70 6f 73 69 74 6f 72 79 2e 3c 2f 70 r repository.</p 0400: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 ></li>..<li><p>T 0410: 68 65 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 he global state 0420: 6f 66 20 61 20 72 65 70 6f 73 69 74 6f 72 79 20 of a repository 0430: 69 73 20 61 6e 20 75 6e 6f 72 64 65 72 65 64 0a is an unordered. 0440: 63 6f 6c 6c 65 63 74 69 6f 6e 20 6f 66 20 66 69 collection of fi 0450: 6c 65 73 2e 20 20 45 61 63 68 20 66 69 6c 65 20 les. Each file 0460: 69 73 20 6e 61 6d 65 64 20 62 79 20 0a 69 74 73 is named by .its 0470: 20 53 48 41 31 20 68 61 73 68 20 65 6e 63 6f 64 SHA1 hash encod 0480: 65 64 20 69 6e 20 68 65 78 61 64 65 63 69 6d 61 ed in hexadecima 0490: 6c 2e 0a 49 6e 20 6d 61 6e 79 20 63 6f 6e 74 65 l..In many conte 04a0: 78 74 73 2c 20 74 68 65 20 6e 61 6d 65 20 63 61 xts, the name ca 04b0: 6e 20 62 65 0a 61 62 62 72 65 76 69 61 74 65 64 n be.abbreviated 04c0: 20 74 6f 20 61 20 75 6e 69 71 75 65 20 70 72 65 to a unique pre 04d0: 66 69 78 2e 20 20 41 20 66 69 76 65 2d 20 6f 72 fix. A five- or 04e0: 20 73 69 78 2d 63 68 61 72 61 63 74 65 72 0a 70 six-character.p 04f0: 72 65 66 69 78 20 75 73 75 61 6c 6c 79 20 73 75 refix usually su 0500: 66 66 69 63 65 73 20 74 6f 20 75 6e 69 71 75 65 ffices to unique 0510: 6c 79 20 69 64 65 6e 74 69 66 79 20 61 20 66 69 ly identify a fi 0520: 6c 65 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c le.</p></li>..<l 0530: 69 3e 3c 70 3e 42 65 63 61 75 73 65 20 66 69 6c i><p>Because fil 0540: 65 73 20 61 72 65 20 6e 61 6d 65 64 20 62 79 20 es are named by 0550: 74 68 65 69 72 20 53 48 41 31 20 68 61 73 68 2c their SHA1 hash, 0560: 20 61 6c 6c 20 66 69 6c 65 73 0a 61 72 65 20 69 all files.are i 0570: 6d 6d 75 74 61 62 6c 65 2e 20 20 41 6e 79 20 63 mmutable. Any c 0580: 68 61 6e 67 65 20 74 6f 20 74 68 65 20 63 6f 6e hange to the con 0590: 74 65 6e 74 20 6f 66 20 61 20 66 69 6c 65 20 61 tent of a file a 05a0: 6c 73 6f 20 0a 63 68 61 6e 67 65 73 20 74 68 65 lso .changes the 05b0: 20 68 61 73 68 20 74 68 61 74 20 66 6f 72 6d 73 hash that forms 05c0: 20 74 68 65 20 66 69 6c 65 73 20 6e 61 6d 65 2c the files name, 05d0: 20 74 68 75 73 0a 63 72 65 61 74 69 6e 67 20 61 thus.creating a 05e0: 20 6e 65 77 20 66 69 6c 65 2e 20 20 42 6f 74 68 new file. Both 05f0: 20 74 68 65 20 6f 6c 64 20 6f 72 69 67 69 6e 61 the old origina 0600: 6c 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 65 l version of the 0610: 0a 66 69 6c 65 20 61 6e 64 20 74 68 65 20 6e 65 .file and the ne 0620: 77 20 63 68 61 6e 67 65 20 61 72 65 20 70 72 65 w change are pre 0630: 73 65 72 76 65 64 20 75 6e 64 65 72 20 64 69 66 served under dif 0640: 66 65 72 65 6e 74 20 6e 61 6d 65 73 2e 3c 2f 70 ferent names.</p 0650: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 49 ></li>..<li><p>I 0660: 74 20 69 73 20 74 68 65 6f 72 65 74 69 63 61 6c t is theoretical 0670: 6c 79 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 ly possible for 0680: 74 77 6f 20 66 69 6c 65 73 20 77 69 74 68 20 64 two files with d 0690: 69 66 66 65 72 65 6e 74 0a 63 6f 6e 74 65 6e 74 ifferent.content 06a0: 20 74 6f 20 73 68 61 72 65 20 74 68 65 20 73 61 to share the sa 06b0: 6d 65 20 68 61 73 68 2e 20 20 42 75 74 20 66 69 me hash. But fi 06c0: 6e 64 69 6e 67 20 74 77 6f 20 73 75 63 68 0a 66 nding two such.f 06d0: 69 6c 65 73 20 69 73 20 73 6f 20 69 6e 63 72 65 iles is so incre 06e0: 64 69 62 6c 79 20 64 69 66 66 69 63 75 6c 74 20 dibly difficult 06f0: 61 6e 64 20 75 6e 6c 69 6b 65 6c 79 20 74 68 61 and unlikely tha 0700: 74 20 77 65 0a 63 6f 6e 73 69 64 65 72 20 69 74 t we.consider it 0710: 20 74 6f 20 62 65 20 61 6e 20 69 6d 70 6f 73 73 to be an imposs 0720: 69 62 69 6c 69 74 79 2e 3c 2f 70 3e 3c 2f 6c 69 ibility.</p></li 0730: 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 68 65 20 73 69 >..<li><p>The si 0740: 67 6e 61 74 75 72 65 20 6f 66 20 61 20 66 69 6c gnature of a fil 0750: 65 20 69 73 20 74 68 65 20 53 48 41 31 20 68 61 e is the SHA1 ha 0760: 73 68 20 6f 66 20 74 68 65 20 0a 66 69 6c 65 20 sh of the .file 0770: 69 74 73 65 6c 66 2c 20 65 78 61 63 74 6c 79 20 itself, exactly 0780: 61 73 20 69 74 20 61 70 70 65 61 72 73 20 6f 6e as it appears on 0790: 20 64 69 73 6b 2e 20 20 4e 6f 20 70 72 65 66 69 disk. No prefi 07a0: 78 0a 6f 72 20 6d 65 74 61 2d 69 6e 66 6f 72 6d x.or meta-inform 07b0: 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 ation about the 07c0: 66 69 6c 65 20 69 73 20 61 64 64 65 64 20 62 65 file is added be 07d0: 66 6f 72 65 20 63 6f 6d 70 75 74 69 6e 67 0a 74 fore computing.t 07e0: 68 65 20 68 61 73 68 2e 20 20 53 6f 20 79 6f 75 he hash. So you 07f0: 20 63 61 6e 0a 61 6c 77 61 79 73 20 66 69 6e 64 can.always find 0800: 20 74 68 65 20 53 48 41 31 20 73 69 67 6e 61 74 the SHA1 signat 0810: 75 72 65 20 6f 66 20 61 20 66 69 6c 65 20 62 79 ure of a file by 0820: 20 75 73 69 6e 67 20 74 68 65 0a 22 73 68 61 31 using the."sha1 0830: 73 75 6d 22 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e sum" command-lin 0840: 65 20 75 74 69 6c 69 74 79 2e 3c 2f 70 3e 3c 2f e utility.</p></ 0850: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 68 65 20 li>..<li><p>The 0860: 66 69 6c 65 73 20 74 68 61 74 20 63 6f 6d 70 72 files that compr 0870: 69 73 65 20 74 68 65 20 67 6c 6f 62 61 6c 20 73 ise the global s 0880: 74 61 74 65 20 6f 66 20 61 20 72 65 70 6f 73 69 tate of a reposi 0890: 74 6f 72 79 0a 61 72 65 20 74 68 65 20 63 6f 6d tory.are the com 08a0: 70 6c 65 74 65 20 67 6c 6f 62 61 6c 20 73 74 61 plete global sta 08b0: 74 65 20 6f 66 20 74 68 61 74 20 72 65 70 6f 73 te of that repos 08c0: 69 74 6f 72 79 2e 20 20 54 68 65 20 53 51 4c 69 itory. The SQLi 08d0: 74 65 0a 64 61 74 61 62 61 73 65 20 74 68 61 74 te.database that 08e0: 20 68 6f 6c 64 73 20 74 68 65 20 72 65 70 6f 73 holds the repos 08f0: 69 74 6f 72 79 20 63 6f 6e 74 61 69 6e 73 20 61 itory contains a 0900: 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d dditional inform 0910: 61 74 69 6f 6e 0a 61 62 6f 75 74 20 6c 69 6e 6b ation.about link 0920: 61 67 65 73 20 62 65 74 77 65 65 6e 20 66 69 6c ages between fil 0930: 65 73 2c 20 62 75 74 20 61 6c 6c 20 6f 66 20 74 es, but all of t 0940: 68 61 74 20 61 64 64 65 64 20 69 6e 66 6f 72 6d hat added inform 0950: 61 74 69 6f 6e 0a 63 61 6e 20 62 65 20 64 69 73 ation.can be dis 0960: 63 61 72 64 65 64 20 61 6e 64 20 72 65 63 6f 6e carded and recon 0970: 73 74 72 75 63 74 65 64 20 62 79 20 72 65 73 63 structed by resc 0980: 61 6e 6e 69 6e 67 20 74 68 65 20 63 6f 6e 74 65 anning the conte 0990: 6e 74 0a 66 69 6c 65 73 2e 3c 2f 70 3e 3c 2f 6c nt.files.</p></l 09a0: 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 77 6f 20 72 i>..<li><p>Two r 09b0: 65 70 6f 73 69 74 6f 72 69 65 73 20 66 6f 72 20 epositories for 09c0: 74 68 65 20 73 61 6d 65 20 70 72 6f 6a 65 63 74 the same project 09d0: 20 63 61 6e 20 73 79 6e 63 68 72 6f 6e 69 7a 65 can synchronize 09e0: 0a 74 68 65 69 72 20 67 6c 6f 62 61 6c 20 73 74 .their global st 09f0: 61 74 65 73 20 73 69 6d 70 6c 79 20 62 79 20 73 ates simply by s 0a00: 68 61 72 69 6e 67 20 66 69 6c 65 73 2e 20 20 54 haring files. T 0a10: 68 65 20 6c 6f 63 61 6c 0a 73 74 61 74 65 20 6f he local.state o 0a20: 66 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20 69 f repositories i 0a30: 73 20 6e 6f 74 20 6e 6f 72 6d 61 6c 6c 79 20 73 s not normally s 0a40: 79 6e 63 68 72 6f 6e 69 7a 65 64 20 6f 72 0a 73 ynchronized or.s 0a50: 68 61 72 65 64 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a hared.</p></li>. 0a60: 0a 3c 6c 69 3e 3c 70 3e 45 76 65 72 79 20 72 65 .<li><p>Every re 0a70: 70 6f 73 69 74 6f 72 79 20 68 61 73 20 61 20 73 pository has a s 0a80: 70 65 63 69 61 6c 20 66 69 6c 65 20 61 74 20 74 pecial file at t 0a90: 68 65 20 74 6f 70 2d 6c 65 76 65 6c 0a 6e 61 6d he top-level.nam 0aa0: 65 64 20 22 6d 61 6e 69 66 65 73 74 22 20 77 68 ed "manifest" wh 0ab0: 69 63 68 20 69 73 20 61 6e 20 69 6e 64 65 78 20 ich is an index 0ac0: 6f 66 20 61 6c 6c 20 6f 74 68 65 72 20 66 69 6c of all other fil 0ad0: 65 73 20 69 6e 0a 74 68 65 20 73 79 73 74 65 6d es in.the system 0ae0: 2e 20 20 54 68 65 20 6d 61 6e 69 66 65 73 74 20 . The manifest 0af0: 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 is automatically 0b00: 20 63 72 65 61 74 65 64 20 61 6e 64 0a 6d 61 69 created and.mai 0b10: 6e 74 61 69 6e 65 64 20 62 79 20 74 68 65 20 73 ntained by the s 0b20: 79 73 74 65 6d 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a ystem.</p></li>. 0b30: 0a 3c 6c 69 3e 3c 70 3e 54 68 65 20 3c 61 20 68 .<li><p>The <a h 0b40: 72 65 66 3d 22 66 69 6c 65 66 6f 72 6d 61 74 2e ref="fileformat. 0b50: 68 74 6d 6c 22 3e 66 69 6c 65 20 66 6f 72 6d 61 html">file forma 0b60: 74 73 3c 2f 61 3e 0a 75 73 65 64 20 62 79 20 46 ts</a>.used by F 0b70: 6f 73 73 69 6c 20 61 72 65 20 61 6c 6c 20 76 65 ossil are all ve 0b80: 72 79 20 73 69 6d 70 6c 65 20 73 6f 20 74 68 61 ry simple so tha 0b90: 74 20 77 69 74 68 20 61 63 63 65 73 73 0a 74 6f t with access.to 0ba0: 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 63 6f the original co 0bb0: 6e 74 65 6e 74 20 66 69 6c 65 73 2c 20 6f 6e 65 ntent files, one 0bc0: 20 63 61 6e 20 65 61 73 69 6c 79 20 72 65 63 6f can easily reco 0bd0: 6e 73 74 72 75 63 74 0a 74 68 65 20 63 6f 6e 74 nstruct.the cont 0be0: 65 6e 74 20 6f 66 20 61 20 62 61 73 65 6c 69 6e ent of a baselin 0bf0: 65 20 77 69 74 68 6f 75 74 20 74 68 65 20 6e 65 e without the ne 0c00: 65 64 20 66 6f 72 20 61 6e 79 0a 73 70 65 63 69 ed for any.speci 0c10: 61 6c 20 74 6f 6f 6c 73 20 6f 72 20 73 6f 66 74 al tools or soft 0c20: 77 61 72 65 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a ware.</p></li>.. 0c30: 3c 2f 62 6f 64 79 3e 0a 3c 2f 68 74 6d 6c 3e 0a </body>.</html>.