Hex Artifact Content
Not logged in

Artifact ba37188db8f11b51f3901506b4d673f94141c7d8:

File www/cmd_new.wiki part of check-in [a9dcbf3ede] - docs by kejoki on 2008-12-16 05:16:57.

0000: 3c 68 32 3e 6e 65 77 3c 2f 68 32 3e 0a 0a 54 68  <h2>new</h2>..Th
0010: 65 20 3c 63 6f 64 65 3e 6e 65 77 3c 2f 63 6f 64  e <code>new</cod
0020: 65 3e 20 63 6f 6d 6d 61 6e 64 20 61 6c 6c 6f 77  e> command allow
0030: 73 20 79 6f 75 20 74 6f 20 63 72 65 61 74 65 20  s you to create 
0040: 61 20 62 72 61 6e 64 20 6e 65 77 0a 72 65 70 6f  a brand new.repo
0050: 73 69 74 6f 72 79 2e 0a 0a 50 72 61 67 6d 61 74  sitory...Pragmat
0060: 69 63 61 6c 6c 79 2c 20 74 68 69 73 20 6d 65 61  ically, this mea
0070: 6e 73 20 74 68 61 74 20 61 6e 20 53 51 4c 69 74  ns that an SQLit
0080: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63 72  e database is cr
0090: 65 61 74 65 64 20 77 69 74 68 0a 77 68 61 74 65  eated with.whate
00a0: 76 65 72 20 6e 61 6d 65 20 79 6f 75 20 73 70 65  ver name you spe
00b0: 63 69 66 69 65 64 2c 20 61 6e 64 20 73 65 74 20  cified, and set 
00c0: 75 70 20 77 69 74 68 20 74 68 65 20 61 70 70 72  up with the appr
00d0: 6f 70 72 69 61 74 65 20 74 61 62 6c 65 73 0a 61  opriate tables.a
00e0: 6e 64 20 69 6e 69 74 69 61 6c 20 64 61 74 61 2e  nd initial data.
00f0: 0a 0a 54 68 65 72 65 27 73 20 6e 6f 74 20 6d 75  ..There's not mu
0100: 63 68 20 74 6f 20 3c 63 6f 64 65 3e 6e 65 77 3c  ch to <code>new<
0110: 2f 63 6f 64 65 3e 2c 20 69 74 27 73 20 77 68 61  /code>, it's wha
0120: 74 20 68 61 70 70 65 6e 73 20 61 66 74 65 72 77  t happens afterw
0130: 61 72 64 20 74 68 61 74 0a 67 65 74 73 20 61 20  ard that.gets a 
0140: 70 72 6f 6a 65 63 74 20 67 6f 69 6e 67 3a 0a 0a  project going:..
0150: 20 20 4f 6e 63 65 20 79 6f 75 20 68 61 76 65 20    Once you have 
0160: 61 20 6e 65 77 20 72 65 70 6f 73 69 74 6f 72 79  a new repository
0170: 20 66 69 6c 65 2c 20 79 6f 75 20 6e 65 65 64 20   file, you need 
0180: 74 6f 20 63 72 65 61 74 65 20 61 6e 64 20 63 64  to create and cd
0190: 20 74 6f 20 61 0a 20 20 64 69 72 65 63 74 6f 72   to a.  director
01a0: 79 20 69 6e 20 77 68 69 63 68 20 79 6f 75 20 77  y in which you w
01b0: 69 6c 6c 20 73 74 6f 72 65 20 79 6f 75 72 20 66  ill store your f
01c0: 69 6c 65 73 2c 20 6f 72 20 6d 6f 76 65 20 69 6e  iles, or move in
01d0: 74 6f 20 61 6e 0a 20 20 65 78 69 73 74 69 6e 67  to an.  existing
01e0: 20 64 69 72 65 63 74 6f 72 79 20 77 68 69 63 68   directory which
01f0: 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 66 69   contains the fi
0200: 6c 65 73 20 66 6f 72 20 61 20 70 72 6f 6a 65 63  les for a projec
0210: 74 2e 0a 0a 20 20 54 68 65 6e 2c 20 79 6f 75 20  t...  Then, you 
0220: 6e 65 65 64 20 74 6f 20 5b 2e 2f 63 6d 64 5f 6f  need to [./cmd_o
0230: 70 65 6e 2e 77 69 6b 69 20 7c 20 3c 63 6f 64 65  pen.wiki | <code
0240: 3e 6f 70 65 6e 3c 2f 63 6f 64 65 3e 5d 20 74 68  >open</code>] th
0250: 65 20 6e 65 77 0a 20 20 72 65 70 6f 73 69 74 6f  e new.  reposito
0260: 72 79 2c 20 61 6e 64 20 67 65 74 20 74 68 65 20  ry, and get the 
0270: 73 65 72 76 65 72 20 72 75 6e 6e 69 6e 67 20 73  server running s
0280: 6f 20 79 6f 75 20 63 61 6e 20 73 65 74 20 75 70  o you can set up
0290: 20 74 68 65 20 70 72 6f 6a 65 63 74 0a 20 20 6e   the project.  n
02a0: 61 6d 65 20 61 6e 64 20 73 6f 20 66 6f 72 74 68  ame and so forth
02b0: 2e 0a 0a 20 20 46 69 6e 61 6c 6c 79 2c 20 79 6f  ...  Finally, yo
02c0: 75 27 6c 6c 20 5b 2e 2f 63 6d 64 5f 61 64 64 2e  u'll [./cmd_add.
02d0: 77 69 6b 69 20 7c 20 3c 63 6f 64 65 3e 61 64 64  wiki | <code>add
02e0: 3c 2f 63 6f 64 65 3e 5d 20 66 69 6c 65 73 20 74  </code>] files t
02f0: 6f 20 69 74 2e 20 20 49 66 0a 20 20 79 6f 75 20  o it.  If.  you 
0300: 61 72 65 20 61 64 64 69 6e 67 20 65 78 69 73 69  are adding exisi
0310: 74 69 6e 67 20 66 69 6c 65 73 2c 20 79 6f 75 20  ting files, you 
0320: 63 61 6e 20 61 64 64 20 74 68 65 6d 20 69 6e 64  can add them ind
0330: 69 76 69 64 75 61 6c 6c 79 2c 20 76 69 61 0a 20  ividually, via. 
0340: 20 67 6c 6f 62 62 69 6e 67 20 66 72 6f 6d 20 74   globbing from t
0350: 68 65 20 73 68 65 6c 6c 2c 20 6f 72 20 62 79 20  he shell, or by 
0360: 61 64 64 69 6e 67 20 74 68 65 20 64 69 72 65 63  adding the direc
0370: 74 6f 72 79 20 28 77 68 69 63 68 20 77 69 6c 6c  tory (which will
0380: 20 61 64 64 0a 20 20 61 6c 6c 20 6f 66 20 74 68   add.  all of th
0390: 65 20 64 69 72 65 63 74 6f 72 79 27 73 20 66 69  e directory's fi
03a0: 6c 65 2d 73 79 73 74 65 6d 20 64 65 73 63 65 6e  le-system descen
03b0: 64 61 6e 74 73 20 72 65 63 75 72 73 69 76 65 6c  dants recursivel
03c0: 79 2e 29 0a 0a 42 75 74 20 79 6f 75 20 63 61 6e  y.)..But you can
03d0: 27 74 20 64 6f 20 61 6c 6c 20 74 68 61 74 20 75  't do all that u
03e0: 6e 74 69 6c 20 79 6f 75 20 63 72 65 61 74 65 20  ntil you create 
03f0: 61 20 72 65 70 6f 73 69 74 6f 72 79 20 66 69 6c  a repository fil
0400: 65 20 77 69 74 68 0a 3c 63 6f 64 65 3e 6e 65 77  e with.<code>new
0410: 3c 2f 63 6f 64 65 3e 2e 0a 0a 53 65 65 20 61 6c  </code>...See al
0420: 73 6f 3a 0a 5b 2e 2f 63 6d 64 5f 6f 70 65 6e 2e  so:.[./cmd_open.
0430: 77 69 6b 69 20 7c 20 66 6f 73 73 69 6c 20 6f 70  wiki | fossil op
0440: 65 6e 5d 2c 0a 5b 2e 2f 63 6d 64 5f 61 64 64 2e  en],.[./cmd_add.
0450: 77 69 6b 69 20 7c 20 66 6f 73 73 69 6c 20 61 64  wiki | fossil ad
0460: 64 5d 2c 0a 5b 2e 2f 63 6d 64 5f 73 65 72 76 65  d],.[./cmd_serve
0470: 72 2e 77 69 6b 69 20 7c 20 66 6f 73 73 69 6c 20  r.wiki | fossil 
0480: 75 69 5d 2c 0a 5b 2e 2f 72 65 66 65 72 65 6e 63  ui],.[./referenc
0490: 65 2e 77 69 6b 69 20 7c 20 52 65 66 65 72 65 6e  e.wiki | Referen
04a0: 63 65 5d 0a                                      ce].