Artifact 032c2fe5ed544c7ce328a107360125bbe71f7bf3:
File
www/faq.tcl
part of check-in
[7a2c37063a]
- merge trunk into creole branch
by
bob on
2009-09-22 07:49:39.
Also file
www/faq.tcl
part of check-in
[713b8be852]
- Deleted some obsolete "todo" files. Updated the FAQ. Modified the the
"vinfo" page to show check-in differences and made "vinfo" the default
display for check-ins instead of "vdiff".
by
drh on
2009-08-28 22:59:27.
0000: 23 21 2f 75 73 72 2f 62 69 6e 2f 74 63 6c 73 68 #!/usr/bin/tclsh
0010: 0a 23 0a 23 20 52 75 6e 20 74 68 69 73 20 74 6f .#.# Run this to
0020: 20 67 65 6e 65 72 61 74 65 20 74 68 65 20 46 41 generate the FA
0030: 51 0a 23 0a 73 65 74 20 63 6e 74 20 31 0a 70 72 Q.#.set cnt 1.pr
0040: 6f 63 20 66 61 71 20 7b 71 75 65 73 74 69 6f 6e oc faq {question
0050: 20 61 6e 73 77 65 72 7d 20 7b 0a 20 20 73 65 74 answer} {. set
0060: 20 3a 3a 66 61 71 28 24 3a 3a 63 6e 74 29 20 5b ::faq($::cnt) [
0070: 6c 69 73 74 20 5b 73 74 72 69 6e 67 20 74 72 69 list [string tri
0080: 6d 20 24 71 75 65 73 74 69 6f 6e 5d 20 5b 73 74 m $question] [st
0090: 72 69 6e 67 20 74 72 69 6d 20 24 61 6e 73 77 65 ring trim $answe
00a0: 72 5d 5d 0a 20 20 69 6e 63 72 20 3a 3a 63 6e 74 r]]. incr ::cnt
00b0: 0a 7d 0a 0a 66 61 71 20 7b 0a 20 20 57 68 61 74 .}..faq {. What
00c0: 20 47 55 49 73 20 61 72 65 20 61 76 61 69 6c 61 GUIs are availa
00d0: 62 6c 65 20 66 6f 72 20 66 6f 73 73 69 6c 3f 0a ble for fossil?.
00e0: 7d 20 7b 0a 20 20 54 68 65 20 66 6f 73 73 69 6c } {. The fossil
00f0: 20 65 78 65 63 75 74 61 62 6c 65 20 63 6f 6d 65 executable come
0100: 73 20 77 69 74 68 20 61 20 77 65 62 2d 62 61 73 s with a web-bas
0110: 65 64 20 47 55 49 20 62 75 69 6c 74 20 69 6e 2e ed GUI built in.
0120: 20 20 4a 75 73 74 20 72 75 6e 3a 0a 0a 20 20 3c Just run:.. <
0130: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 3c 62 blockquote>. <b
0140: 3e 66 6f 73 73 69 6c 20 75 69 3c 2f 62 3e 20 3c >fossil ui</b> <
0150: 69 3e 52 45 50 4f 53 49 54 4f 52 59 2d 46 49 4c i>REPOSITORY-FIL
0160: 45 4e 41 4d 45 3c 2f 69 3e 0a 20 20 3c 2f 62 6c ENAME</i>. </bl
0170: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 20 20 41 6e 64 ockquote>.. And
0180: 20 79 6f 75 72 20 64 65 66 61 75 6c 74 20 77 65 your default we
0190: 62 20 62 72 6f 77 73 65 72 20 73 68 6f 75 6c 64 b browser should
01a0: 20 70 6f 70 20 75 70 20 61 6e 64 20 61 75 74 6f pop up and auto
01b0: 6d 61 74 69 63 61 6c 6c 79 20 70 6f 69 6e 74 20 matically point
01c0: 74 6f 0a 20 20 74 68 65 20 66 6f 73 73 69 6c 20 to. the fossil
01d0: 69 6e 74 65 72 66 61 63 65 2e 20 20 28 48 69 6e interface. (Hin
01e0: 74 3a 20 20 59 6f 75 20 63 61 6e 20 6f 6d 69 74 t: You can omit
01f0: 20 74 68 65 20 3c 69 3e 52 45 50 4f 53 49 54 4f the <i>REPOSITO
0200: 52 59 2d 46 49 4c 45 4e 41 4d 45 3c 2f 69 3e 0a RY-FILENAME</i>.
0210: 20 20 69 66 20 79 6f 75 20 61 72 65 20 77 69 74 if you are wit
0220: 68 69 6e 20 61 6e 20 6f 70 65 6e 20 63 68 65 63 hin an open chec
0230: 6b 2d 6f 75 74 2e 29 0a 7d 0a 0a 66 61 71 20 7b k-out.).}..faq {
0240: 0a 20 20 57 68 61 74 20 69 73 20 74 68 65 20 64 . What is the d
0250: 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 65 65 ifference betwee
0260: 6e 20 61 20 22 62 72 61 6e 63 68 22 20 61 6e 64 n a "branch" and
0270: 20 61 20 22 66 6f 72 6b 22 3f 0a 7d 20 7b 0a 20 a "fork"?.} {.
0280: 20 54 68 69 73 20 69 73 20 61 20 62 69 67 20 71 This is a big q
0290: 75 65 73 74 69 6f 6e 20 2d 20 74 6f 6f 20 62 69 uestion - too bi
02a0: 67 20 74 6f 20 61 6e 73 77 65 72 20 69 6e 20 61 g to answer in a
02b0: 20 46 41 51 2e 20 20 50 6c 65 61 73 65 0a 20 20 FAQ. Please.
02c0: 72 65 61 64 20 74 68 65 20 3c 61 20 68 72 65 66 read the <a href
02d0: 3d 22 62 72 61 6e 63 68 69 6e 67 2e 77 69 6b 69 ="branching.wiki
02e0: 22 3e 42 72 61 6e 63 68 69 6e 67 2c 20 46 6f 72 ">Branching, For
02f0: 6b 69 6e 67 2c 20 4d 65 72 67 69 6e 67 2c 0a 20 king, Merging,.
0300: 20 61 6e 64 20 54 61 67 67 69 6e 67 3c 2f 61 3e and Tagging</a>
0310: 20 64 6f 63 75 6d 65 6e 74 2e 0a 7d 0a 0a 0a 66 document..}...f
0320: 61 71 20 7b 0a 20 20 48 6f 77 20 64 6f 20 49 20 aq {. How do I
0330: 63 72 65 61 74 65 20 61 20 6e 65 77 20 62 72 61 create a new bra
0340: 6e 63 68 20 69 6e 20 66 6f 73 73 69 6c 3f 0a 7d nch in fossil?.}
0350: 20 7b 0a 20 20 54 68 65 72 65 20 61 72 65 20 6c {. There are l
0360: 6f 74 73 20 6f 66 20 77 61 79 73 3a 0a 0a 20 20 ots of ways:..
0370: 57 68 65 6e 20 79 6f 75 20 61 72 65 20 63 68 65 When you are che
0380: 63 6b 69 6e 67 20 69 6e 20 61 20 6e 65 77 20 63 cking in a new c
0390: 68 61 6e 67 65 20 75 73 69 6e 67 20 74 68 65 20 hange using the
03a0: 3c 62 3e 63 6f 6d 6d 69 74 3c 2f 62 3e 0a 20 20 <b>commit</b>.
03b0: 63 6f 6d 6d 61 6e 64 2c 20 79 6f 75 20 63 61 6e command, you can
03c0: 20 61 64 64 20 74 68 65 20 6f 70 74 69 6f 6e 20 add the option
03d0: 20 22 2d 2d 62 72 61 6e 63 68 20 3c 69 3e 42 52 "--branch <i>BR
03e0: 41 4e 43 48 2d 4e 41 4d 45 3c 2f 69 3e 22 20 74 ANCH-NAME</i>" t
03f0: 6f 0a 20 20 6d 61 6b 65 20 74 68 65 20 63 68 61 o. make the cha
0400: 6e 67 65 20 62 65 20 74 68 65 20 66 6f 75 6e 64 nge be the found
0410: 69 6e 67 20 63 68 65 63 6b 2d 69 6e 20 66 6f 72 ing check-in for
0420: 20 61 20 6e 65 77 20 62 72 61 6e 63 68 2e 20 20 a new branch.
0430: 59 6f 75 20 63 61 6e 0a 20 20 61 6c 73 6f 20 61 You can. also a
0440: 64 64 20 74 68 65 20 22 2d 2d 62 67 63 6f 6c 6f dd the "--bgcolo
0450: 72 20 3c 69 3e 43 4f 4c 4f 52 3c 2f 69 3e 22 20 r <i>COLOR</i>"
0460: 6f 70 74 69 6f 6e 20 74 6f 20 67 69 76 65 20 74 option to give t
0470: 68 65 20 62 72 61 6e 63 68 20 61 0a 20 20 73 70 he branch a. sp
0480: 65 63 69 66 69 63 20 62 61 63 6b 67 72 6f 75 6e ecific backgroun
0490: 64 20 63 6f 6c 6f 72 20 6f 6e 20 74 69 6d 65 6c d color on timel
04a0: 69 6e 65 73 2e 0a 0a 20 20 49 66 20 79 6f 75 20 ines... If you
04b0: 77 61 6e 74 20 74 6f 20 63 72 65 61 74 65 20 61 want to create a
04c0: 20 6e 65 77 20 62 72 61 6e 63 68 20 77 68 6f 73 new branch whos
04d0: 65 20 66 6f 75 6e 64 69 6e 67 20 63 68 65 63 6b e founding check
04e0: 2d 69 6e 20 69 73 20 74 68 65 0a 20 20 73 61 6d -in is the. sam
04f0: 65 20 61 73 20 61 6e 20 65 78 69 73 74 69 6e 67 e as an existing
0500: 20 63 68 65 63 6b 2d 69 6e 2c 20 75 73 65 20 74 check-in, use t
0510: 68 69 73 20 63 6f 6d 6d 61 6e 64 3a 0a 0a 20 20 his command:..
0520: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 20 20 3c <blockquote>. <
0530: 62 3e 66 6f 73 73 69 6c 20 62 72 61 6e 63 68 20 b>fossil branch
0540: 6e 65 77 3c 2f 62 3e 20 3c 69 3e 42 52 41 4e 43 new</b> <i>BRANC
0550: 48 2d 4e 41 4d 45 20 42 41 53 49 53 3c 2f 69 3e H-NAME BASIS</i>
0560: 0a 20 20 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e . </blockquote>
0570: 0a 0a 20 20 54 68 65 20 3c 69 3e 42 52 41 4e 43 .. The <i>BRANC
0580: 48 2d 4e 41 4d 45 3c 2f 69 3e 20 61 72 67 75 6d H-NAME</i> argum
0590: 65 6e 74 20 69 73 20 74 68 65 20 6e 61 6d 65 20 ent is the name
05a0: 6f 66 20 74 68 65 20 6e 65 77 20 62 72 61 6e 63 of the new branc
05b0: 68 20 61 6e 64 20 74 68 65 0a 20 20 3c 69 3e 42 h and the. <i>B
05c0: 41 53 49 53 3c 2f 69 3e 20 61 72 67 75 6d 65 6e ASIS</i> argumen
05d0: 74 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 t is the name of
05e0: 20 74 68 65 20 63 68 65 63 6b 2d 69 6e 20 74 68 the check-in th
05f0: 61 74 20 74 68 65 20 62 72 61 6e 63 68 20 73 70 at the branch sp
0600: 6c 69 74 73 0a 20 20 6f 66 66 20 66 72 6f 6d 2e lits. off from.
0610: 0a 0a 20 20 49 66 20 79 6f 75 20 61 6c 72 65 61 .. If you alrea
0620: 64 79 20 68 61 76 65 20 61 20 66 6f 72 6b 20 69 dy have a fork i
0630: 6e 20 79 6f 75 72 20 63 68 65 63 6b 2d 69 6e 20 n your check-in
0640: 74 72 65 65 20 61 6e 64 20 79 6f 75 20 77 61 6e tree and you wan
0650: 74 20 74 6f 20 63 6f 6e 76 65 72 74 0a 20 20 74 t to convert. t
0660: 68 61 74 20 66 6f 72 6b 20 74 6f 20 61 20 62 72 hat fork to a br
0670: 61 6e 63 68 2c 20 79 6f 75 20 63 61 6e 20 64 6f anch, you can do
0680: 20 74 68 69 73 20 66 72 6f 6d 20 74 68 65 20 77 this from the w
0690: 65 62 20 69 6e 74 65 72 66 61 63 65 2e 0a 20 20 eb interface..
06a0: 46 69 72 73 74 20 6c 6f 63 61 74 65 20 74 68 65 First locate the
06b0: 20 63 68 65 63 6b 2d 69 6e 20 74 68 61 74 20 79 check-in that y
06c0: 6f 75 20 77 61 6e 74 20 74 6f 20 62 65 0a 20 20 ou want to be.
06d0: 74 68 65 20 66 6f 75 6e 64 69 6e 67 20 63 68 65 the founding che
06e0: 63 6b 2d 69 6e 20 6f 66 20 79 6f 75 72 20 62 72 ck-in of your br
06f0: 61 6e 63 68 20 6f 6e 20 74 68 65 20 74 69 6d 65 anch on the time
0700: 6c 69 6e 65 20 61 6e 64 20 63 6c 69 63 6b 20 6f line and click o
0710: 6e 20 69 74 73 0a 20 20 6c 69 6e 6b 20 73 6f 20 n its. link so
0720: 74 68 61 74 20 79 6f 75 20 61 72 65 20 6f 6e 20 that you are on
0730: 74 68 65 20 3c 62 3e 63 69 3c 2f 62 3e 20 70 61 the <b>ci</b> pa
0740: 67 65 2e 20 20 54 68 65 6e 20 66 69 6e 64 20 74 ge. Then find t
0750: 68 65 20 22 3c 62 3e 65 64 69 74 3c 2f 62 3e 22 he "<b>edit</b>"
0760: 0a 20 20 6c 69 6e 6b 20 28 6e 65 61 72 20 74 68 . link (near th
0770: 65 20 22 43 6f 6d 6d 61 6e 64 73 3a 22 20 6c 61 e "Commands:" la
0780: 62 65 6c 29 20 61 6e 64 20 63 6c 69 63 6b 20 6f bel) and click o
0790: 6e 20 74 68 61 74 2e 20 20 4f 6e 20 74 68 65 20 n that. On the
07a0: 0a 20 20 22 45 64 69 74 20 43 68 65 63 6b 2d 69 . "Edit Check-i
07b0: 6e 22 20 70 61 67 65 2c 20 63 68 65 63 6b 20 74 n" page, check t
07c0: 68 65 20 62 6f 78 20 62 65 73 69 64 65 20 22 42 he box beside "B
07d0: 72 61 6e 63 68 69 6e 67 3a 22 20 61 6e 64 20 66 ranching:" and f
07e0: 69 6c 6c 20 69 6e 20 0a 20 20 74 68 65 20 6e 61 ill in . the na
07f0: 6d 65 20 6f 66 20 79 6f 75 72 20 6e 65 77 20 62 me of your new b
0800: 72 61 6e 63 68 20 74 6f 20 74 68 65 20 72 69 67 ranch to the rig
0810: 68 74 20 61 6e 64 20 70 72 65 73 73 20 74 68 65 ht and press the
0820: 20 22 41 70 70 6c 79 20 43 68 61 6e 67 65 73 22 "Apply Changes"
0830: 0a 20 20 62 75 74 74 6f 6e 2e 0a 7d 0a 0a 66 61 . button..}..fa
0840: 71 20 7b 0a 20 20 48 6f 77 20 64 6f 20 49 20 63 q {. How do I c
0850: 72 65 61 74 65 20 61 20 70 72 69 76 61 74 65 20 reate a private
0860: 62 72 61 6e 63 68 20 74 68 61 74 20 77 6f 6e 27 branch that won'
0870: 74 20 67 65 74 20 70 75 73 68 65 64 20 62 61 63 t get pushed bac
0880: 6b 20 74 6f 20 74 68 65 0a 20 20 6d 61 69 6e 20 k to the. main
0890: 72 65 70 6f 73 69 74 6f 72 79 2e 0a 7d 20 7b 0a repository..} {.
08a0: 20 20 55 73 65 20 74 68 65 20 3c 62 3e 2d 2d 70 Use the <b>--p
08b0: 72 69 76 61 74 65 3c 2f 62 3e 20 63 6f 6d 6d 61 rivate</b> comma
08c0: 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f 6e 20 6f nd-line option o
08d0: 6e 20 74 68 65 20 0a 20 20 3c 62 3e 63 6f 6d 6d n the . <b>comm
08e0: 69 74 3c 2f 62 3e 20 63 6f 6d 6d 61 6e 64 2e 20 it</b> command.
08f0: 20 54 68 65 20 72 65 73 75 6c 74 20 77 69 6c 6c The result will
0900: 20 62 65 20 61 20 63 68 65 63 6b 2d 69 6e 20 77 be a check-in w
0910: 68 69 63 68 20 65 78 69 73 74 73 20 6f 6e 0a 20 hich exists on.
0920: 20 79 6f 75 72 20 6c 6f 63 61 6c 20 72 65 70 6f your local repo
0930: 73 69 74 6f 72 79 20 6f 6e 6c 79 20 61 6e 64 20 sitory only and
0940: 69 73 20 6e 65 76 65 72 20 70 75 73 68 65 64 20 is never pushed
0950: 74 6f 20 6f 74 68 65 72 20 72 65 70 6f 73 69 74 to other reposit
0960: 6f 72 69 65 73 2e 20 20 0a 20 20 41 6c 6c 20 64 ories. . All d
0970: 65 73 63 65 6e 64 65 6e 74 73 20 6f 66 20 61 20 escendents of a
0980: 70 72 69 76 61 74 65 20 63 68 65 63 6b 2d 69 6e private check-in
0990: 20 61 72 65 20 61 6c 73 6f 20 70 72 69 76 61 74 are also privat
09a0: 65 2e 0a 20 20 0a 20 20 55 6e 6c 65 73 73 20 79 e.. . Unless y
09b0: 6f 75 20 73 70 65 63 69 66 79 20 73 6f 6d 65 74 ou specify somet
09c0: 68 69 6e 67 20 64 69 66 66 65 72 65 6e 74 20 75 hing different u
09d0: 73 69 6e 67 20 74 68 65 20 3c 62 3e 2d 2d 62 72 sing the <b>--br
09e0: 61 6e 63 68 3c 2f 62 3e 20 61 6e 64 2f 6f 72 0a anch</b> and/or.
09f0: 20 20 3c 62 3e 2d 2d 62 67 63 6f 6c 6f 72 3c 2f <b>--bgcolor</
0a00: 62 3e 20 6f 70 74 69 6f 6e 73 2c 20 74 68 65 20 b> options, the
0a10: 6e 65 77 20 70 72 69 76 61 74 65 20 63 68 65 63 new private chec
0a20: 6b 2d 69 6e 20 77 69 6c 6c 20 62 65 20 70 75 74 k-in will be put
0a30: 20 6f 6e 20 61 20 62 72 61 6e 63 68 0a 20 20 6e on a branch. n
0a40: 61 6d 65 64 20 22 70 72 69 76 61 74 65 22 20 77 amed "private" w
0a50: 69 74 68 20 61 6e 20 6f 72 61 6e 67 65 20 62 61 ith an orange ba
0a60: 63 6b 67 72 6f 75 6e 64 20 63 6f 6c 6f 72 2e 0a ckground color..
0a70: 20 20 0a 20 20 59 6f 75 20 63 61 6e 20 6d 65 72 . You can mer
0a80: 67 65 20 66 72 6f 6d 20 74 68 65 20 74 72 75 6e ge from the trun
0a90: 6b 20 69 6e 74 6f 20 79 6f 75 72 20 70 72 69 76 k into your priv
0aa0: 61 74 65 20 62 72 61 6e 63 68 20 69 6e 20 6f 72 ate branch in or
0ab0: 64 65 72 20 74 6f 20 6b 65 65 70 0a 20 20 79 6f der to keep. yo
0ac0: 75 72 20 70 72 69 76 61 74 65 20 62 72 61 6e 63 ur private branc
0ad0: 68 20 69 6e 20 73 79 6e 63 20 77 69 74 68 20 74 h in sync with t
0ae0: 68 65 20 6c 61 74 65 73 74 20 63 68 61 6e 67 65 he latest change
0af0: 73 20 6f 6e 20 74 68 65 20 74 72 75 6e 6b 2e 20 s on the trunk.
0b00: 20 4f 6e 63 65 0a 20 20 79 6f 75 20 68 61 76 65 Once. you have
0b10: 20 65 76 65 72 79 74 68 69 6e 67 20 69 6e 20 79 everything in y
0b20: 6f 75 72 20 70 72 69 76 61 74 65 20 62 72 61 6e our private bran
0b30: 63 68 20 74 68 65 20 77 61 79 20 79 6f 75 20 77 ch the way you w
0b40: 61 6e 74 20 69 74 2c 20 79 6f 75 20 63 61 6e 0a ant it, you can.
0b50: 20 20 74 68 65 6e 20 6d 65 72 67 65 20 79 6f 75 then merge you
0b60: 72 20 70 72 69 76 61 74 65 20 62 72 61 6e 63 68 r private branch
0b70: 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 74 back into the t
0b80: 72 75 6e 6b 20 61 6e 64 20 70 75 73 68 2e 20 20 runk and push.
0b90: 4f 6e 6c 79 20 74 68 65 0a 20 20 66 69 6e 61 6c Only the. final
0ba0: 20 6d 65 72 67 65 20 6f 70 65 72 61 74 69 6f 6e merge operation
0bb0: 20 77 69 6c 6c 20 61 70 70 65 61 72 20 69 6e 20 will appear in
0bc0: 6f 74 68 65 72 20 72 65 70 6f 73 69 74 6f 72 69 other repositori
0bd0: 65 73 2e 20 20 49 74 20 77 69 6c 6c 20 73 65 65 es. It will see
0be0: 6d 0a 20 20 61 73 20 69 66 20 61 6c 6c 20 74 68 m. as if all th
0bf0: 65 20 63 68 61 6e 67 65 73 20 74 68 61 74 20 6f e changes that o
0c00: 63 63 75 72 72 65 64 20 6f 6e 20 79 6f 75 72 20 ccurred on your
0c10: 70 72 69 76 61 74 65 20 62 72 61 6e 63 68 20 6f private branch o
0c20: 63 63 75 72 72 65 64 20 69 6e 0a 20 20 61 20 73 ccurred in. a s
0c30: 69 6e 67 6c 65 20 63 68 65 63 6b 2d 69 6e 2e 0a ingle check-in..
0c40: 20 20 4f 66 20 63 6f 75 72 73 65 2c 20 79 6f 75 Of course, you
0c50: 20 63 61 6e 20 61 6c 73 6f 20 6b 65 65 70 20 79 can also keep y
0c60: 6f 75 72 20 62 72 61 6e 63 68 20 70 72 69 76 61 our branch priva
0c70: 74 65 20 66 6f 72 65 76 65 72 20 73 69 6d 70 6c te forever simpl
0c80: 79 0a 20 20 62 79 20 6e 6f 74 20 6d 65 72 67 69 y. by not mergi
0c90: 6e 67 20 74 68 65 20 63 68 61 6e 67 65 73 20 69 ng the changes i
0ca0: 6e 20 74 68 65 20 70 72 69 76 61 74 65 20 62 72 n the private br
0cb0: 61 6e 63 68 20 62 61 63 6b 20 69 6e 74 6f 20 74 anch back into t
0cc0: 68 65 20 74 72 75 6e 6b 2e 0a 7d 0a 0a 66 61 71 he trunk..}..faq
0cd0: 20 7b 0a 20 20 48 6f 77 20 63 61 6e 20 49 20 64 {. How can I d
0ce0: 65 6c 65 74 65 20 69 6e 61 70 70 72 6f 70 72 69 elete inappropri
0cf0: 61 74 65 20 63 6f 6e 74 65 6e 74 20 66 72 6f 6d ate content from
0d00: 20 6d 79 20 66 6f 73 73 69 6c 20 72 65 70 6f 73 my fossil repos
0d10: 69 74 6f 72 79 3f 0a 7d 20 7b 0a 20 20 53 65 65 itory?.} {. See
0d20: 20 74 68 65 20 61 72 74 69 63 6c 65 20 6f 6e 20 the article on
0d30: 5b 2e 2f 73 68 75 6e 6e 69 6e 67 2e 77 69 6b 69 [./shunning.wiki
0d40: 20 7c 20 22 73 68 75 6e 6e 69 6e 67 22 5d 20 66 | "shunning"] f
0d50: 6f 72 20 64 65 74 61 69 6c 73 2e 0a 7d 0a 0a 66 or details..}..f
0d60: 61 71 20 7b 0a 20 20 48 6f 77 20 64 6f 20 49 20 aq {. How do I
0d70: 6d 61 6b 65 20 61 20 63 6c 6f 6e 65 20 6f 66 20 make a clone of
0d80: 74 68 65 20 66 6f 73 73 69 6c 20 73 65 6c 66 2d the fossil self-
0d90: 68 6f 73 74 69 6e 67 20 72 65 70 6f 73 69 74 6f hosting reposito
0da0: 72 79 3f 0a 7d 20 7b 0a 20 20 41 6e 79 20 6f 66 ry?.} {. Any of
0db0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 the following c
0dc0: 6f 6d 6d 61 6e 64 73 20 73 68 6f 75 6c 64 20 77 ommands should w
0dd0: 6f 72 6b 3a 0a 20 20 3c 62 6c 6f 63 6b 71 75 6f ork:. <blockquo
0de0: 74 65 3e 3c 70 72 65 3e 0a 20 20 66 6f 73 73 69 te><pre>. fossi
0df0: 6c 20 20 63 6c 6f 6e 65 20 20 68 74 74 70 3a 2f l clone http:/
0e00: 2f 77 77 77 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e /www.fossil-scm.
0e10: 6f 72 67 2f 20 20 66 6f 73 73 69 6c 2e 66 6f 73 org/ fossil.fos
0e20: 73 69 6c 3c 62 72 3e 0a 20 20 66 6f 73 73 69 6c sil<br>. fossil
0e30: 20 20 63 6c 6f 6e 65 20 20 68 74 74 70 3a 2f 2f clone http://
0e40: 77 77 77 32 2e 66 6f 73 73 69 6c 2d 73 63 6d 2e www2.fossil-scm.
0e50: 6f 72 67 2f 20 20 66 6f 73 73 69 6c 2e 66 6f 73 org/ fossil.fos
0e60: 73 69 6c 3c 62 72 3e 0a 20 20 66 6f 73 73 69 6c sil<br>. fossil
0e70: 20 20 63 6c 6f 6e 65 20 20 68 74 74 70 3a 2f 2f clone http://
0e80: 77 77 77 2e 68 77 61 63 69 2e 63 6f 6d 2f 63 67 www.hwaci.com/cg
0e90: 69 2d 62 69 6e 2f 66 6f 73 73 69 6c 20 20 66 6f i-bin/fossil fo
0ea0: 73 73 69 6c 2e 66 6f 73 73 69 6c 0a 20 20 3c 2f ssil.fossil. </
0eb0: 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 pre></blockquote
0ec0: 3e 0a 20 20 4f 6e 63 65 20 79 6f 75 20 68 61 76 >. Once you hav
0ed0: 65 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72 79 e the repository
0ee0: 20 63 6c 6f 6e 65 64 2c 20 79 6f 75 20 63 61 6e cloned, you can
0ef0: 20 6f 70 65 6e 20 61 20 6c 6f 63 61 6c 20 63 68 open a local ch
0f00: 65 63 6b 2d 6f 75 74 0a 20 20 61 73 20 66 6f 6c eck-out. as fol
0f10: 6c 6f 77 73 3a 0a 20 20 3c 62 6c 6f 63 6b 71 75 lows:. <blockqu
0f20: 6f 74 65 3e 3c 70 72 65 3e 0a 20 20 6d 6b 64 69 ote><pre>. mkdi
0f30: 72 20 73 72 63 3b 20 63 64 20 73 72 63 3b 20 66 r src; cd src; f
0f40: 6f 73 73 69 6c 20 6f 70 65 6e 20 2e 2e 2f 66 6f ossil open ../fo
0f50: 73 73 69 6c 2e 66 6f 73 73 69 6c 0a 20 20 3c 2f ssil.fossil. </
0f60: 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 pre></blockquote
0f70: 3e 0a 20 20 54 68 65 72 65 61 66 74 65 72 20 79 >. Thereafter y
0f80: 6f 75 20 73 68 6f 75 6c 64 20 62 65 20 61 62 6c ou should be abl
0f90: 65 20 74 6f 20 6b 65 65 70 20 79 6f 75 72 20 6c e to keep your l
0fa0: 6f 63 61 6c 20 63 68 65 63 6b 2d 6f 75 74 20 75 ocal check-out u
0fb0: 70 20 74 6f 20 64 61 74 65 0a 20 20 77 69 74 68 p to date. with
0fc0: 20 74 68 65 20 6c 61 74 65 73 74 20 63 6f 64 65 the latest code
0fd0: 20 69 6e 20 74 68 65 20 70 75 62 6c 69 63 20 72 in the public r
0fe0: 65 70 6f 73 69 74 6f 72 79 20 62 79 20 74 79 70 epository by typ
0ff0: 69 6e 67 3a 0a 20 20 3c 62 6c 6f 63 6b 71 75 6f ing:. <blockquo
1000: 74 65 3e 3c 70 72 65 3e 0a 20 20 66 6f 73 73 69 te><pre>. fossi
1010: 6c 20 75 70 64 61 74 65 0a 20 20 3c 2f 70 72 65 l update. </pre
1020: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 7d ></blockquote>.}
1030: 0a 0a 23 23 23 23 23 23 23 23 23 23 23 23 23 23 ..##############
1040: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 ################
1050: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 ################
1060: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 ################
1070: 23 23 23 23 23 23 23 23 23 23 23 23 23 23 23 0a ###############.
1080: 23 20 43 6f 64 65 20 74 6f 20 61 63 74 75 61 6c # Code to actual
1090: 6c 79 20 67 65 6e 65 72 61 74 65 20 74 68 65 20 ly generate the
10a0: 46 41 51 0a 23 0a 70 75 74 73 20 22 3c 74 69 74 FAQ.#.puts "<tit
10b0: 6c 65 3e 46 6f 73 73 69 6c 20 46 41 51 3c 2f 74 le>Fossil FAQ</t
10c0: 69 74 6c 65 3e 22 0a 70 75 74 73 20 22 3c 68 31 itle>".puts "<h1
10d0: 20 61 6c 69 67 6e 3d 5c 22 63 65 6e 74 65 72 5c align=\"center\
10e0: 22 3e 46 72 65 71 75 65 6e 74 6c 79 20 41 73 6b ">Frequently Ask
10f0: 65 64 20 51 75 65 73 74 69 6f 6e 73 3c 2f 68 31 ed Questions</h1
1100: 3e 5c 6e 22 0a 70 75 74 73 20 22 3c 70 3e 4e 6f >\n".puts "<p>No
1110: 74 65 3a 20 53 65 65 20 61 6c 73 6f 20 3c 61 20 te: See also <a
1120: 68 72 65 66 3d 5c 22 71 61 6e 64 63 2e 77 69 6b href=\"qandc.wik
1130: 69 5c 22 3e 51 75 65 73 74 69 6f 6e 73 20 61 6e i\">Questions an
1140: 64 20 43 72 69 74 69 63 69 73 6d 73 3c 2f 61 3e d Criticisms</a>
1150: 2e 5c 6e 22 0a 0a 70 75 74 73 20 7b 3c 6f 6c 3e .\n"..puts {<ol>
1160: 7d 0a 66 6f 72 20 7b 73 65 74 20 69 20 31 7d 20 }.for {set i 1}
1170: 7b 24 69 3c 24 63 6e 74 7d 20 7b 69 6e 63 72 20 {$i<$cnt} {incr
1180: 69 7d 20 7b 0a 20 20 70 75 74 73 20 22 3c 6c 69 i} {. puts "<li
1190: 3e 3c 61 20 68 72 65 66 3d 5c 22 23 71 24 69 5c ><a href=\"#q$i\
11a0: 22 3e 5b 6c 69 6e 64 65 78 20 24 66 61 71 28 24 ">[lindex $faq($
11b0: 69 29 20 30 5d 3c 2f 61 3e 3c 2f 6c 69 3e 22 0a i) 0]</a></li>".
11c0: 7d 0a 70 75 74 73 20 7b 3c 2f 6f 6c 3e 7d 0a 70 }.puts {</ol>}.p
11d0: 75 74 73 20 7b 3c 68 72 3e 7d 0a 0a 66 6f 72 20 uts {<hr>}..for
11e0: 7b 73 65 74 20 69 20 31 7d 20 7b 24 69 3c 24 63 {set i 1} {$i<$c
11f0: 6e 74 7d 20 7b 69 6e 63 72 20 69 7d 20 7b 0a 20 nt} {incr i} {.
1200: 20 70 75 74 73 20 22 3c 61 20 6e 61 6d 65 3d 5c puts "<a name=\
1210: 22 71 24 69 5c 22 3e 3c 2f 61 3e 22 0a 20 20 70 "q$i\"></a>". p
1220: 75 74 73 20 22 3c 70 3e 3c 62 3e 28 24 69 29 20 uts "<p><b>($i)
1230: 5b 6c 69 6e 64 65 78 20 24 66 61 71 28 24 69 29 [lindex $faq($i)
1240: 20 30 5d 3c 2f 62 3e 3c 2f 70 3e 5c 6e 22 0a 20 0]</b></p>\n".
1250: 20 73 65 74 20 62 6f 64 79 20 5b 6c 69 6e 64 65 set body [linde
1260: 78 20 24 66 61 71 28 24 69 29 20 31 5d 0a 20 20 x $faq($i) 1].
1270: 72 65 67 73 75 62 20 2d 61 6c 6c 20 22 5c 6e 20 regsub -all "\n
1280: 2a 22 20 5b 73 74 72 69 6e 67 20 74 72 69 6d 20 *" [string trim
1290: 24 62 6f 64 79 5d 20 22 5c 6e 22 20 62 6f 64 79 $body] "\n" body
12a0: 0a 20 20 70 75 74 73 20 22 3c 62 6c 6f 63 6b 71 . puts "<blockq
12b0: 75 6f 74 65 3e 24 62 6f 64 79 3c 2f 62 6c 6f 63 uote>$body</bloc
12c0: 6b 71 75 6f 74 65 3e 3c 2f 6c 69 3e 5c 6e 22 0a kquote></li>\n".
12d0: 7d 0a 70 75 74 73 20 7b 3c 2f 6f 6c 3e 7d 0a }.puts {</ol>}.