Artifact bf75283289b41b2624c0496fa6de304fdf470da2:
File
www/pop.html
part of check-in
[dbda8d6ce9]
- Initial check-in of m1 sources.
by
drh on
2007-07-21 14:10:57.
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 6d 6f 73 74 6c 79 20 75 6e is an mostly un
0410: 6f 72 64 65 72 65 64 0a 63 6f 6c 6c 65 63 74 69 ordered.collecti
0420: 6f 6e 20 6f 66 20 66 69 6c 65 73 2e 20 20 45 61 on of files. Ea
0430: 63 68 20 66 69 6c 65 20 69 73 20 6e 61 6d 65 64 ch file is named
0440: 20 62 79 20 0a 69 74 73 20 53 48 41 32 35 36 20 by .its SHA256
0450: 68 61 73 68 2e 20 20 54 68 65 20 6e 61 6d 65 20 hash. The name
0460: 69 73 20 65 6e 63 6f 64 65 64 20 61 73 20 61 20 is encoded as a
0470: 35 32 2d 64 69 67 69 74 20 0a 62 61 73 65 2d 33 52-digit .base-3
0480: 32 20 6e 75 6d 62 65 72 2e 20 20 49 6e 20 6d 61 2 number. In ma
0490: 6e 79 20 63 6f 6e 74 65 78 74 73 2c 20 74 68 65 ny contexts, the
04a0: 20 6e 61 6d 65 20 63 61 6e 20 62 65 0a 61 62 62 name can be.abb
04b0: 72 65 76 69 61 74 65 64 20 74 6f 20 61 20 75 6e reviated to a un
04c0: 69 71 75 65 20 70 72 65 66 69 78 2e 20 20 41 20 ique prefix. A
04d0: 66 69 76 65 2d 20 6f 72 20 73 69 78 2d 63 68 61 five- or six-cha
04e0: 72 61 63 74 65 72 0a 70 72 65 66 69 78 20 75 73 racter.prefix us
04f0: 75 61 6c 6c 79 20 73 75 66 66 69 63 65 73 20 74 ually suffices t
0500: 6f 20 75 6e 69 71 75 65 6c 79 20 69 64 65 6e 74 o uniquely ident
0510: 69 66 79 20 61 20 66 69 6c 65 2e 3c 2f 70 3e 3c ify a file.</p><
0520: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 42 65 63 /li>..<li><p>Bec
0530: 61 75 73 65 20 66 69 6c 65 73 20 61 72 65 20 6e ause files are n
0540: 61 6d 65 64 20 62 79 20 74 68 65 69 72 20 53 48 amed by their SH
0550: 41 32 35 36 20 68 61 73 68 2c 20 61 6c 6c 20 66 A256 hash, all f
0560: 69 6c 65 73 0a 61 72 65 20 69 6d 6d 75 74 61 62 iles.are immutab
0570: 6c 65 2e 20 20 41 6e 79 20 63 68 61 6e 67 65 20 le. Any change
0580: 74 6f 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f to the content o
0590: 66 20 61 20 66 69 6c 65 20 61 6c 73 6f 20 0a 63 f a file also .c
05a0: 68 61 6e 67 65 73 20 74 68 65 20 68 61 73 68 20 hanges the hash
05b0: 74 68 61 74 20 66 6f 72 6d 73 20 74 68 65 20 66 that forms the f
05c0: 69 6c 65 73 20 6e 61 6d 65 2c 20 74 68 75 73 0a iles name, thus.
05d0: 63 72 65 61 74 69 6e 67 20 61 20 6e 65 77 20 66 creating a new f
05e0: 69 6c 65 2e 20 20 42 6f 74 68 20 74 68 65 20 6f ile. Both the o
05f0: 6c 64 20 6f 72 69 67 69 6e 61 6c 20 76 65 72 73 ld original vers
0600: 69 6f 6e 20 6f 66 20 74 68 65 0a 66 69 6c 65 20 ion of the.file
0610: 61 6e 64 20 74 68 65 20 6e 65 77 20 63 68 61 6e and the new chan
0620: 67 65 20 61 72 65 20 70 72 65 73 65 72 76 65 64 ge are preserved
0630: 20 75 6e 64 65 72 20 64 69 66 66 65 72 65 6e 74 under different
0640: 20 6e 61 6d 65 73 2e 3c 2f 70 3e 3c 2f 6c 69 3e names.</p></li>
0650: 0a 0a 3c 6c 69 3e 3c 70 3e 49 74 20 69 73 20 74 ..<li><p>It is t
0660: 68 65 6f 72 65 74 69 63 61 6c 6c 79 20 70 6f 73 heoretically pos
0670: 73 69 62 6c 65 20 66 6f 72 20 74 77 6f 20 66 69 sible for two fi
0680: 6c 65 73 20 77 69 74 68 20 64 69 66 66 65 72 65 les with differe
0690: 6e 74 0a 63 6f 6e 74 65 6e 74 20 74 6f 20 73 68 nt.content to sh
06a0: 61 72 65 20 74 68 65 20 73 61 6d 65 20 68 61 73 are the same has
06b0: 68 2e 20 20 42 75 74 20 66 69 6e 64 69 6e 67 20 h. But finding
06c0: 74 77 6f 20 73 75 63 68 0a 66 69 6c 65 73 20 69 two such.files i
06d0: 73 20 73 6f 20 69 6e 63 72 65 64 69 62 6c 79 20 s so incredibly
06e0: 64 69 66 66 69 63 75 6c 74 20 61 6e 64 20 75 6e difficult and un
06f0: 6c 69 6b 65 6c 79 20 74 68 61 74 20 77 65 0a 63 likely that we.c
0700: 6f 6e 73 69 64 65 72 20 69 74 20 74 6f 20 62 65 onsider it to be
0710: 20 61 6e 20 69 6d 70 6f 73 73 69 62 69 6c 69 74 an impossibilit
0720: 79 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 y.</p></li>..<li
0730: 3e 3c 70 3e 54 68 65 20 66 69 6c 65 73 20 74 68 ><p>The files th
0740: 61 74 20 63 6f 6d 70 72 69 73 65 20 74 68 65 20 at comprise the
0750: 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 6f 66 20 global state of
0760: 61 20 72 65 70 6f 73 69 74 6f 72 79 0a 63 6f 6e a repository.con
0770: 73 69 73 74 20 6f 66 20 61 20 68 65 61 64 65 72 sist of a header
0780: 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6f 70 74 followed by opt
0790: 69 6f 6e 61 6c 20 63 6f 6e 74 65 6e 74 2e 20 20 ional content.
07a0: 45 76 65 72 79 0a 66 69 6c 65 20 63 6f 6e 74 61 Every.file conta
07b0: 69 6e 73 20 61 6e 20 52 53 41 20 73 69 67 6e 61 ins an RSA signa
07c0: 74 75 72 65 20 69 6e 20 74 68 65 20 68 65 61 64 ture in the head
07d0: 65 72 2e 20 20 41 6e 64 20 65 76 65 72 79 20 0a er. And every .
07e0: 66 69 6c 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 file contains a
07f0: 22 66 69 6c 65 20 74 79 70 65 22 20 64 65 73 69 "file type" desi
0800: 67 6e 61 74 6f 72 20 69 6e 20 74 68 65 20 68 65 gnator in the he
0810: 61 64 65 72 2e 0a 41 64 64 69 74 69 6f 6e 61 6c ader..Additional
0820: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 information is
0830: 61 6c 73 6f 20 66 6f 75 6e 64 20 69 6e 20 74 68 also found in th
0840: 65 20 68 65 61 64 65 72 20 64 65 70 65 6e 64 69 e header dependi
0850: 6e 67 0a 6f 6e 20 74 68 65 20 66 69 6c 65 20 74 ng.on the file t
0860: 79 70 65 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c ype.</p></li>..<
0870: 6c 69 3e 3c 70 3e 54 68 65 20 66 69 6c 65 20 74 li><p>The file t
0880: 68 61 74 20 63 6f 6d 70 72 69 73 65 20 74 68 65 hat comprise the
0890: 20 67 6c 6f 62 61 6c 20 73 74 61 74 65 20 6f 66 global state of
08a0: 20 61 20 72 65 70 6f 73 69 74 6f 72 79 0a 61 72 a repository.ar
08b0: 65 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 20 67 e the complete g
08c0: 6c 6f 62 61 6c 20 73 74 61 74 65 20 6f 66 20 74 lobal state of t
08d0: 68 61 74 20 72 65 70 6f 73 69 74 6f 72 79 2e 20 hat repository.
08e0: 20 54 68 65 20 53 51 4c 69 74 65 0a 64 61 74 61 The SQLite.data
08f0: 62 61 73 65 20 74 68 61 74 20 68 6f 6c 64 73 20 base that holds
0900: 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 20 63 the repository c
0910: 6f 6e 74 61 69 6e 73 20 61 64 64 69 74 69 6f 6e ontains addition
0920: 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 61 al information.a
0930: 62 6f 75 74 20 6c 69 6e 6b 61 67 65 73 20 62 65 bout linkages be
0940: 74 77 65 65 6e 20 66 69 6c 65 73 2c 20 62 75 74 tween files, but
0950: 20 61 6c 6c 20 6f 66 20 74 68 61 74 20 61 64 64 all of that add
0960: 65 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 63 ed information.c
0970: 61 6e 20 62 65 20 64 69 73 63 61 72 64 65 64 20 an be discarded
0980: 61 6e 64 20 72 65 63 6f 6e 73 74 72 75 63 74 65 and reconstructe
0990: 64 20 62 79 20 73 63 61 6e 6e 69 6e 67 20 74 68 d by scanning th
09a0: 65 20 63 6f 6e 74 65 6e 74 0a 66 69 6c 65 73 2e e content.files.
09b0: 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c </p></li>..<li><
09c0: 70 3e 54 77 6f 20 72 65 70 6f 73 69 74 6f 72 69 p>Two repositori
09d0: 65 73 20 66 6f 72 20 74 68 65 20 73 61 6d 65 20 es for the same
09e0: 70 72 6f 6a 65 63 74 20 63 61 6e 20 73 79 6e 63 project can sync
09f0: 68 72 6f 6e 69 7a 65 0a 74 68 65 69 72 20 67 6c hronize.their gl
0a00: 6f 62 61 6c 20 73 74 61 74 65 73 20 73 69 6d 70 obal states simp
0a10: 6c 79 20 62 79 20 73 68 61 72 69 6e 67 20 66 69 ly by sharing fi
0a20: 6c 65 73 2e 20 20 54 68 65 20 6c 6f 63 61 6c 0a les. The local.
0a30: 73 74 61 74 65 20 6f 66 20 72 65 70 6f 73 69 74 state of reposit
0a40: 6f 72 69 65 73 20 69 73 20 6e 6f 74 20 6e 6f 72 ories is not nor
0a50: 6d 61 6c 6c 79 20 73 79 6e 63 68 72 6f 6e 69 7a mally synchroniz
0a60: 65 64 20 6f 72 0a 73 68 61 72 65 64 2e 3c 2f 70 ed or.shared.</p
0a70: 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 54 ></li>..<li><p>T
0a80: 68 65 20 6e 61 6d 65 20 6f 66 20 61 20 66 69 6c he name of a fil
0a90: 65 20 69 73 20 69 74 73 20 53 48 41 32 35 36 20 e is its SHA256
0aa0: 68 61 73 68 20 69 6e 20 61 20 62 61 73 65 2d 33 hash in a base-3
0ab0: 32 20 0a 65 6e 63 6f 64 69 6e 67 2e 20 20 54 68 2 .encoding. Th
0ac0: 65 20 64 69 67 69 74 73 20 6f 66 20 74 68 65 20 e digits of the
0ad0: 62 61 73 65 2d 33 32 20 65 6e 63 6f 64 65 20 61 base-32 encode a
0ae0: 72 65 20 61 73 20 0a 66 6f 6c 6c 6f 77 73 3a 0a re as .follows:.
0af0: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 62 3e .<blockquote><b>
0b00: 0a 20 20 20 20 30 31 32 33 34 35 36 37 38 39 61 . 0123456789a
0b10: 62 63 64 65 66 67 68 6a 6b 6d 6e 70 71 72 73 74 bcdefghjkmnpqrst
0b20: 75 76 77 78 79 0a 3c 2f 62 3e 3c 2f 62 6c 6f 63 uvwxy.</b></bloc
0b30: 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 54 68 65 20 kquote>..<p>The
0b40: 6c 65 74 74 65 72 73 20 22 6f 22 2c 20 22 69 22 letters "o", "i"
0b50: 2c 20 61 6e 64 20 22 6c 22 20 61 72 65 20 6f 6d , and "l" are om
0b60: 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65 0a 65 itted from the.e
0b70: 6e 63 6f 64 69 6e 67 20 63 68 61 72 61 63 74 65 ncoding characte
0b80: 72 20 73 65 74 20 74 6f 20 61 76 6f 69 64 20 63 r set to avoid c
0b90: 6f 6e 66 75 73 69 6f 6e 20 77 69 74 68 20 74 68 onfusion with th
0ba0: 65 20 0a 64 69 67 69 74 73 20 22 30 22 20 61 6e e .digits "0" an
0bb0: 64 20 22 31 22 2e 20 20 4f 6e 20 69 6e 70 75 74 d "1". On input
0bc0: 2c 20 75 70 70 65 72 20 61 6e 64 20 6c 6f 77 65 , upper and lowe
0bd0: 72 20 63 61 73 65 20 0a 6c 65 74 74 65 72 73 20 r case .letters
0be0: 61 72 65 20 74 72 65 61 74 65 64 20 74 68 65 20 are treated the
0bf0: 73 61 6d 65 2c 20 74 68 65 20 6c 65 74 74 65 72 same, the letter
0c00: 20 22 6f 22 20 69 73 20 0a 69 6e 74 65 72 70 72 "o" is .interpr
0c10: 65 74 65 64 20 61 73 20 61 20 7a 65 72 6f 20 28 eted as a zero (
0c20: 22 30 22 29 20 61 6e 64 20 74 68 65 20 6c 65 74 "0") and the let
0c30: 74 65 72 73 20 22 69 22 20 61 6e 64 20 0a 22 6c ters "i" and ."l
0c40: 22 20 61 72 65 20 69 6e 74 65 72 70 72 65 74 65 " are interprete
0c50: 64 20 61 73 20 61 20 6f 6e 65 20 28 22 31 22 29 d as a one ("1")
0c60: 2e 20 20 54 68 65 20 66 75 6c 6c 20 6e 61 6d 65 . The full name
0c70: 20 6f 66 20 0a 61 20 66 69 6c 65 20 69 73 20 35 of .a file is 5
0c80: 32 20 63 68 61 72 61 63 74 65 72 73 20 6c 6f 6e 2 characters lon
0c90: 67 2e 20 20 54 68 65 20 66 69 72 73 74 20 34 20 g. The first 4
0ca0: 62 69 74 73 20 6f 66 20 74 68 65 0a 53 48 41 32 bits of the.SHA2
0cb0: 35 36 20 68 61 73 20 61 72 65 20 72 65 70 65 61 56 has are repea
0cc0: 74 65 64 20 6f 6e 74 6f 20 74 68 65 20 65 6e 64 ted onto the end
0cd0: 20 6f 66 20 74 68 65 20 68 61 73 68 20 73 6f 20 of the hash so
0ce0: 74 68 61 74 0a 74 68 65 20 6c 61 73 74 20 64 69 that.the last di
0cf0: 67 69 74 20 69 6e 20 74 68 65 20 62 61 73 65 2d git in the base-
0d00: 33 32 20 65 6e 63 6f 64 69 6e 67 20 77 69 6c 6c 32 encoding will
0d10: 20 63 6f 6e 74 61 69 6e 20 61 0a 66 75 6c 6c 20 contain a.full
0d20: 35 20 62 69 74 73 2e 0a 46 6f 72 20 63 6f 6e 76 5 bits..For conv
0d30: 65 6e 69 65 6e 63 65 2c 20 66 69 6c 65 73 0a 6d enience, files.m
0d40: 61 79 20 6f 66 74 65 6e 20 62 65 20 61 62 62 72 ay often be abbr
0d50: 65 76 69 61 74 65 64 20 74 6f 20 61 20 75 6e 69 eviated to a uni
0d60: 71 75 65 20 70 72 65 66 69 78 20 61 6e 64 20 74 que prefix and t
0d70: 68 65 20 0a 72 65 70 6f 73 69 74 6f 72 79 20 77 he .repository w
0d80: 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c ill automaticall
0d90: 79 20 65 78 70 61 6e 64 20 74 68 65 20 6e 61 6d y expand the nam
0da0: 65 20 74 6f 0a 69 74 73 20 66 75 6c 6c 20 35 32 e to.its full 52
0db0: 20 63 68 61 72 61 63 74 65 72 73 2e 20 20 49 6e characters. In
0dc0: 20 70 72 61 63 74 69 63 65 2c 20 35 20 6f 72 20 practice, 5 or
0dd0: 36 0a 63 68 61 72 61 63 74 65 72 73 20 61 72 65 6.characters are
0de0: 20 75 73 75 61 6c 6c 79 20 73 75 66 66 69 63 69 usually suffici
0df0: 65 6e 74 20 74 6f 20 67 69 76 65 20 61 20 75 6e ent to give a un
0e00: 69 71 75 65 20 0a 6e 61 6d 65 20 70 72 65 66 69 ique .name prefi
0e10: 78 20 74 6f 20 66 69 6c 65 73 20 65 76 65 6e 20 x to files even
0e20: 69 6e 20 74 68 65 20 6c 61 72 67 65 73 74 20 6f in the largest o
0e30: 66 20 70 72 6f 6a 65 63 74 73 2e 3c 2f 70 3e 3c f projects.</p><
0e40: 2f 6c 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 2f 62 6f /li>.</ul>..</bo
0e50: 64 79 3e 0a 3c 2f 68 74 6d 6c 3e 0a dy>.</html>.