Hex Artifact Content
Not logged in

Artifact 7f2e0211184c9d78e65f6c51b2472b601edc6d7d:

File www/cmd_all.wiki part of check-in [44b3fc6b5b] - reference docs -- added 'all', minor edits to others. by kejoki on 2008-11-17 02:07:14.

0000: 3c 68 32 3e 61 6c 6c 3c 2f 68 32 3e 0a 0a 54 68  <h2>all</h2>..Th
0010: 65 20 3c 63 6f 64 65 3e 61 6c 6c 3c 2f 63 6f 64  e <code>all</cod
0020: 65 3e 20 63 6f 6d 6d 61 6e 64 20 77 69 6c 6c 20  e> command will 
0030: 6c 65 74 20 79 6f 75 20 70 65 72 66 6f 72 6d 20  let you perform 
0040: 28 73 6f 6d 65 29 20 63 6f 6d 6d 61 6e 64 73 20  (some) commands 
0050: 6f 6e 0a 3c 65 6d 3e 61 6c 6c 3c 2f 65 6d 3e 20  on.<em>all</em> 
0060: 6f 66 20 79 6f 75 72 20 72 65 70 6f 73 69 74 6f  of your reposito
0070: 72 69 65 73 2c 20 61 6e 64 20 70 72 6f 76 69 64  ries, and provid
0080: 65 73 20 61 20 77 61 79 20 6f 66 20 66 69 6e 64  es a way of find
0090: 69 6e 67 20 61 6c 6c 0a 6f 66 20 79 6f 75 72 20  ing all.of your 
00a0: 72 65 70 6f 73 69 74 6f 72 69 65 73 20 61 73 20  repositories as 
00b0: 77 65 6c 6c 2e 0a 0a 54 68 65 72 65 20 61 72 65  well...There are
00c0: 20 73 6f 6d 65 20 63 6f 6d 6d 61 6e 64 73 20 79   some commands y
00d0: 6f 75 20 6d 69 67 68 74 20 65 73 70 65 63 69 61  ou might especia
00e0: 6c 6c 79 20 77 61 6e 74 20 74 6f 20 70 65 72 66  lly want to perf
00f0: 6f 72 6d 20 6f 6e 20 65 76 65 72 79 0a 72 65 70  orm on every.rep
0100: 6f 73 69 74 6f 72 79 20 79 6f 75 27 76 65 20 67  ository you've g
0110: 6f 74 2c 20 6f 6e 63 65 20 69 6e 20 61 20 77 68  ot, once in a wh
0120: 69 6c 65 2e 20 20 3c 63 6f 64 65 3e 20 66 6f 73  ile.  <code> fos
0130: 73 69 6c 26 6e 62 73 70 3b 61 6c 6c 0a 3c 2f 63  sil&nbsp;all.</c
0140: 6f 64 65 3e 20 69 6e 63 6c 75 64 65 73 20 66 6f  ode> includes fo
0150: 75 72 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 6c  ur of the most l
0160: 69 6b 65 6c 79 20 61 73 20 73 75 62 2d 63 6f 6d  ikely as sub-com
0170: 6d 61 6e 64 73 3a 20 0a 3c 63 6f 64 65 3e 3c 61  mands: .<code><a
0180: 20 68 72 65 66 3d 22 63 6d 64 5f 70 75 6c 6c 2e   href="cmd_pull.
0190: 77 69 6b 69 22 3e 70 75 6c 6c 3c 2f 61 3e 3c 2f  wiki">pull</a></
01a0: 63 6f 64 65 3e 2c 0a 3c 63 6f 64 65 3e 3c 61 20  code>,.<code><a 
01b0: 68 72 65 66 3d 22 63 6d 64 5f 70 75 73 68 2e 77  href="cmd_push.w
01c0: 69 6b 69 22 3e 70 75 73 68 3c 2f 61 3e 3c 2f 63  iki">push</a></c
01d0: 6f 64 65 3e 2c 0a 3c 63 6f 64 65 3e 3c 61 20 68  ode>,.<code><a h
01e0: 72 65 66 3d 22 63 6d 64 5f 72 65 62 75 69 6c 64  ref="cmd_rebuild
01f0: 2e 77 69 6b 69 22 3e 72 65 62 75 69 6c 64 3c 2f  .wiki">rebuild</
0200: 61 3e 3c 2f 63 6f 64 65 3e 20 61 6e 64 20 0a 3c  a></code> and .<
0210: 63 6f 64 65 3e 3c 61 20 68 72 65 66 3d 22 63 6d  code><a href="cm
0220: 64 5f 73 79 6e 63 2e 77 69 6b 69 22 3e 73 79 6e  d_sync.wiki">syn
0230: 63 3c 2f 61 3e 3c 2f 63 6f 64 65 3e 2e 0a 0a 46  c</a></code>...F
0240: 6f 6c 6c 6f 77 20 74 68 65 20 6c 69 6e 6b 73 20  ollow the links 
0250: 74 6f 20 66 69 6e 64 20 6f 75 74 20 77 68 61 74  to find out what
0260: 20 65 61 63 68 20 6f 66 20 74 68 6f 73 65 20 64   each of those d
0270: 6f 2c 20 61 6e 64 20 74 68 65 6e 20 61 20 6d 6f  o, and then a mo
0280: 6d 65 6e 74 0a 6f 66 20 74 68 6f 75 67 68 74 20  ment.of thought 
0290: 77 69 6c 6c 20 74 65 6c 6c 20 79 6f 75 20 77 68  will tell you wh
02a0: 79 20 79 6f 75 20 6d 69 67 68 74 20 77 61 6e 74  y you might want
02b0: 20 74 6f 20 68 61 76 65 20 74 68 65 6d 20 61 76   to have them av
02c0: 61 69 6c 61 62 6c 65 20 66 6f 72 0a 61 6c 6c 20  ailable for.all 
02d0: 72 65 70 6f 73 69 74 6f 72 69 65 73 2e 0a 0a 43  repositories...C
02e0: 65 72 74 61 69 6e 6c 79 20 79 6f 75 27 6c 6c 20  ertainly you'll 
02f0: 77 61 6e 74 20 79 6f 75 72 20 72 65 70 6f 73 69  want your reposi
0300: 74 6f 72 69 65 73 20 61 6c 6c 20 72 65 62 75 69  tories all rebui
0310: 6c 74 20 77 68 65 6e 20 79 6f 75 20 75 70 67 72  lt when you upgr
0320: 61 64 65 0a 3c 62 3e 66 6f 73 73 69 6c 3c 2f 62  ade.<b>fossil</b
0330: 3e 20 61 66 74 65 72 20 74 68 65 72 65 20 68 61  > after there ha
0340: 73 20 62 65 65 6e 20 61 20 63 68 61 6e 67 65 20  s been a change 
0350: 69 6e 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72  in the repositor
0360: 79 0a 73 74 72 75 63 74 75 72 65 2e 20 20 46 6f  y.structure.  Fo
0370: 72 20 74 68 65 20 6f 74 68 65 72 73 2c 20 69 74  r the others, it
0380: 20 64 65 70 65 6e 64 73 2e 20 20 55 73 75 61 6c   depends.  Usual
0390: 6c 79 20 79 6f 75 20 77 6f 75 6c 64 20 77 61 6e  ly you would wan
03a0: 74 0a 61 63 72 6f 73 73 2d 74 68 65 2d 62 6f 61  t.across-the-boa
03b0: 72 64 20 76 65 72 73 69 6f 6e 73 20 69 66 20 79  rd versions if y
03c0: 6f 75 27 76 65 20 62 65 65 6e 20 22 6f 66 66 20  ou've been "off 
03d0: 4e 65 74 22 20 66 6f 72 20 61 20 77 68 69 6c 65  Net" for a while
03e0: 2c 20 61 6e 64 0a 68 61 76 65 20 63 6f 6d 6d 69  , and.have commi
03f0: 74 73 20 74 6f 20 6d 75 6c 74 69 70 6c 65 20 72  ts to multiple r
0400: 65 70 6f 73 69 74 6f 72 69 65 73 20 74 68 61 6e  epositories than
0410: 20 79 6f 75 20 6e 65 65 64 20 74 6f 20 73 68 61   you need to sha
0420: 72 65 2c 20 6f 72 20 77 61 6e 74 0a 74 6f 20 67  re, or want.to g
0430: 65 74 20 74 68 65 20 72 65 70 6f 73 69 74 6f 72  et the repositor
0440: 79 20 63 68 61 6e 67 65 73 20 74 68 61 74 20 68  y changes that h
0450: 61 76 65 20 62 65 65 6e 20 6d 61 64 65 20 62 79  ave been made by
0460: 20 6f 74 68 65 72 73 2c 20 6f 72 20 62 6f 74 68   others, or both
0470: 2e 0a 0a 54 68 65 20 6c 61 73 74 20 73 75 62 2d  ...The last sub-
0480: 63 6f 6d 6d 61 6e 64 20 70 72 6f 76 69 64 65 64  command provided
0490: 20 62 79 20 3c 63 6f 64 65 3e 61 6c 6c 3c 2f 63   by <code>all</c
04a0: 6f 64 65 3e 20 69 73 20 22 3c 63 6f 64 65 3e 6c  ode> is "<code>l
04b0: 69 73 74 3c 2f 63 6f 64 65 3e 2e 22 0a 0a 57 68  ist</code>."..Wh
04c0: 69 6c 65 20 74 68 65 20 6f 74 68 65 72 20 73 75  ile the other su
04d0: 62 2d 63 6f 6d 6d 61 6e 64 73 20 67 69 76 65 20  b-commands give 
04e0: 79 6f 75 20 61 20 77 61 79 20 74 6f 20 63 6f 6e  you a way to con
04f0: 76 65 6e 69 65 6e 74 6c 79 20 74 61 6b 65 20 63  veniently take c
0500: 61 72 65 0a 6f 66 20 61 6c 6c 20 6f 66 20 79 6f  are.of all of yo
0510: 75 72 20 72 65 70 6f 73 69 74 6f 72 69 65 73 20  ur repositories 
0520: 66 6f 72 20 73 6f 6d 65 20 63 6f 6d 6d 6f 6e 20  for some common 
0530: 74 61 73 6b 73 2c 20 74 68 65 0a 3c 63 6f 64 65  tasks, the.<code
0540: 3e 6c 69 73 74 3c 2f 63 6f 64 65 3e 20 70 72 6f  >list</code> pro
0550: 76 69 64 65 73 20 61 20 77 61 79 20 74 6f 20 74  vides a way to t
0560: 61 6b 65 20 63 61 72 65 20 6f 66 20 61 6e 79 20  ake care of any 
0570: 73 75 62 73 65 74 20 6f 66 20 79 6f 75 72 0a 72  subset of your.r
0580: 65 70 6f 73 69 74 6f 72 69 65 73 20 69 6e 20 61  epositories in a
0590: 6e 79 20 77 61 79 20 79 6f 75 20 77 61 6e 74 2e  ny way you want.
05a0: 20 20 49 74 20 70 72 6f 76 69 64 65 73 20 61 20    It provides a 
05b0: 6c 69 73 74 20 6f 66 20 61 6c 6c 20 6f 66 20 79  list of all of y
05c0: 6f 75 72 0a 72 65 70 6f 73 69 74 6f 72 69 65 73  our.repositories
05d0: 27 20 6c 6f 63 61 74 69 6f 6e 73 2e 20 20 3c 63  ' locations.  <c
05e0: 6f 64 65 3e 66 6f 73 73 69 6c 26 6e 62 73 70 3b  ode>fossil&nbsp;
05f0: 61 6c 6c 26 6e 62 73 70 3b 6c 69 73 74 3c 2f 63  all&nbsp;list</c
0600: 6f 64 65 3e 0a 6f 75 74 70 75 74 73 20 61 20 6f  ode>.outputs a o
0610: 6e 65 2d 70 65 72 2d 6c 69 6e 65 20 6c 69 73 74  ne-per-line list
0620: 69 6e 67 20 6f 66 20 74 68 65 20 70 61 74 68 20  ing of the path 
0630: 66 6f 72 20 65 61 63 68 20 6f 66 20 79 6f 75 72  for each of your
0640: 0a 72 65 70 6f 73 69 74 6f 72 69 65 73 2e 20 20  .repositories.  
0650: 57 69 74 68 20 74 68 61 74 20 69 6e 20 68 61 6e  With that in han
0660: 64 2c 20 79 6f 75 20 63 61 6e 20 65 61 73 69 6c  d, you can easil
0670: 79 20 73 63 72 69 70 74 20 6a 75 73 74 20 61 62  y script just ab
0680: 6f 75 74 20 61 6e 79 0a 72 65 70 6f 73 69 74 6f  out any.reposito
0690: 72 79 20 6d 61 6e 69 70 75 6c 61 74 69 6f 6e 73  ry manipulations
06a0: 20 79 6f 75 20 77 61 6e 74 2e 0a 0a 4f 72 2c 20   you want...Or, 
06b0: 79 6f 75 20 63 6f 75 6c 64 20 6a 75 73 74 20 6a  you could just j
06c0: 6f 67 20 79 6f 75 72 20 6d 65 6d 6f 72 79 2e 0a  og your memory..
06d0: 0a 54 68 65 20 3c 63 6f 64 65 3e 61 6c 6c 3c 2f  .The <code>all</
06e0: 63 6f 64 65 3e 20 63 6f 6d 6d 61 6e 64 20 75 73  code> command us
06f0: 65 73 20 74 68 65 20 3c 69 3e 2e 66 6f 73 73 69  es the <i>.fossi
0700: 6c 3c 2f 69 3e 20 66 69 6c 65 20 69 6e 20 74 68  l</i> file in th
0710: 65 20 68 6f 6d 65 0a 64 69 72 65 63 74 6f 72 79  e home.directory
0720: 20 74 6f 20 66 69 6e 64 20 61 6c 6c 20 6f 66 20   to find all of 
0730: 79 6f 75 72 20 72 65 70 6f 73 69 74 6f 72 69 65  your repositorie
0740: 73 2c 20 73 6f 20 79 6f 75 20 63 61 6e 20 6d 65  s, so you can me
0750: 73 73 20 69 74 20 75 70 20 62 79 0a 6d 6f 76 69  ss it up by.movi
0760: 6e 67 20 79 6f 75 72 20 72 65 70 6f 73 69 74 6f  ng your reposito
0770: 72 69 65 73 20 61 72 6f 75 6e 64 2e 20 20 54 68  ries around.  Th
0780: 69 73 20 69 73 20 65 61 73 79 20 74 6f 20 64 6f  is is easy to do
0790: 20 69 6e 61 64 76 65 72 74 65 6e 74 6c 79 20 69   inadvertently i
07a0: 66 0a 79 6f 75 20 68 61 76 65 20 61 20 63 61 76  f.you have a cav
07b0: 61 6c 69 65 72 20 61 74 74 69 74 75 64 65 20 61  alier attitude a
07c0: 62 6f 75 74 20 72 65 70 6f 73 2c 20 62 75 74 20  bout repos, but 
07d0: 79 6f 75 27 6c 6c 20 6b 6e 6f 77 20 70 72 65 74  you'll know pret
07e0: 74 79 0a 71 75 69 63 6b 6c 79 20 74 68 61 74 20  ty.quickly that 
07f0: 79 6f 75 27 76 65 20 64 6f 6e 65 20 69 74 26 23  you've done it&#
0800: 38 32 31 32 3b 6d 61 6e 79 20 63 6f 6d 6d 61 6e  8212;many comman
0810: 64 73 20 79 6f 75 20 74 72 79 20 74 6f 20 75 73  ds you try to us
0820: 65 20 66 72 6f 6d 0a 69 6e 73 69 64 65 20 6f 66  e from.inside of
0830: 20 61 20 63 68 65 63 6b 6f 75 74 20 77 6f 6e 27   a checkout won'
0840: 74 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79  t work correctly
0850: 2e 20 20 54 68 65 20 3c 69 3e 2e 66 6f 73 73 69  .  The <i>.fossi
0860: 6c 3c 2f 69 3e 20 66 69 6c 65 20 69 73 0a 61 6e  l</i> file is.an
0870: 20 3c 62 3e 73 71 6c 69 74 65 3c 2f 62 3e 20 64   <b>sqlite</b> d
0880: 62 20 66 69 6c 65 20 77 68 69 63 68 20 66 6f 73  b file which fos
0890: 73 69 6c 20 75 73 65 73 20 74 6f 20 6b 65 65 70  sil uses to keep
08a0: 69 6e 67 20 74 72 61 63 6b 20 6f 66 0a 72 65 70  ing track of.rep
08b0: 6f 73 69 74 6f 72 79 20 6c 6f 63 61 74 69 6f 6e  ository location
08c0: 73 2e 20 41 64 76 69 63 65 3a 20 69 66 20 79 6f  s. Advice: if yo
08d0: 75 20 6d 6f 76 65 20 79 6f 75 72 20 72 65 70 6f  u move your repo
08e0: 73 69 74 6f 72 69 65 73 20 61 72 6f 75 6e 64 2c  sitories around,
08f0: 0a 6c 65 74 20 66 6f 73 73 69 6c 20 6b 6e 6f 77  .let fossil know
0900: 20 79 6f 75 20 64 69 64 3b 0a 3c 63 6f 64 65 3e   you did;.<code>
0910: 3c 61 20 68 72 65 66 3d 22 63 6d 64 5f 63 6c 6f  <a href="cmd_clo
0920: 73 65 2e 77 69 6b 69 22 3e 63 6c 6f 73 65 3c 2f  se.wiki">close</
0930: 61 3e 3c 2f 63 6f 64 65 3e 20 74 68 65 6d 20 62  a></code> them b
0940: 65 66 6f 72 65 20 79 6f 75 20 6d 6f 76 65 0a 74  efore you move.t
0950: 68 65 6d 2c 20 61 6e 64 20 74 68 65 6e 20 3c 63  hem, and then <c
0960: 6f 64 65 3e 3c 61 20 68 72 65 66 3d 22 63 6d 64  ode><a href="cmd
0970: 5f 6f 70 65 6e 2e 77 69 6b 69 22 3e 6f 70 65 6e  _open.wiki">open
0980: 3c 2f 61 3e 3c 2f 63 6f 64 65 3e 20 74 68 65 6d  </a></code> them
0990: 20 66 72 6f 6d 0a 74 68 65 69 72 20 6e 65 77 20   from.their new 
09a0: 6c 6f 63 61 74 69 6f 6e 73 2e 0a 0a 53 65 65 20  locations...See 
09b0: 61 6c 73 6f 3a 20 3c 61 20 68 72 65 66 3d 22 63  also: <a href="c
09c0: 6d 64 5f 70 75 6c 6c 2e 77 69 6b 69 22 3e 66 6f  md_pull.wiki">fo
09d0: 73 73 69 6c 20 70 75 6c 6c 3c 2f 61 3e 2c 0a 3c  ssil pull</a>,.<
09e0: 61 20 68 72 65 66 3d 22 63 6d 64 5f 70 75 73 68  a href="cmd_push
09f0: 2e 77 69 6b 69 22 3e 66 6f 73 73 69 6c 20 70 75  .wiki">fossil pu
0a00: 73 68 3c 2f 61 3e 2c 0a 3c 61 20 68 72 65 66 3d  sh</a>,.<a href=
0a10: 22 63 6d 64 5f 72 65 62 75 69 6c 64 2e 77 69 6b  "cmd_rebuild.wik
0a20: 69 22 3e 66 6f 73 73 69 6c 20 72 65 62 75 69 6c  i">fossil rebuil
0a30: 64 3c 2f 61 3e 2c 0a 3c 61 20 68 72 65 66 3d 22  d</a>,.<a href="
0a40: 63 6d 64 5f 73 79 6e 63 2e 77 69 6b 69 22 3e 66  cmd_sync.wiki">f
0a50: 6f 73 73 69 6c 20 73 79 6e 63 3c 2f 61 3e 2c 0a  ossil sync</a>,.
0a60: 3c 61 20 68 72 65 66 3d 22 63 6d 64 5f 6f 70 65  <a href="cmd_ope
0a70: 6e 2e 77 69 6b 69 22 3e 66 6f 73 73 69 6c 20 6f  n.wiki">fossil o
0a80: 70 65 6e 3c 2f 61 3e 2c 0a 3c 61 20 68 72 65 66  pen</a>,.<a href
0a90: 3d 22 63 6d 64 5f 63 6c 6f 73 65 2e 77 69 6b 69  ="cmd_close.wiki
0aa0: 22 3e 66 6f 73 73 69 6c 20 63 6c 6f 73 65 3c 2f  ">fossil close</
0ab0: 61 3e 2c 0a 3c 61 20 68 72 65 66 3d 22 72 65 66  a>,.<a href="ref
0ac0: 65 72 65 6e 63 65 2e 77 69 6b 69 22 3e 52 65 66  erence.wiki">Ref
0ad0: 65 72 65 6e 63 65 3c 2f 61 3e 2c 0a 3c 62 3e 3c  erence</a>,.<b><
0ae0: 61 20 68 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77  a href="http://w
0af0: 77 77 2e 73 71 6c 69 74 65 2e 6f 72 67 22 3e 73  ww.sqlite.org">s
0b00: 71 6c 69 74 65 3c 2f 61 3e 3c 2f 62 3e 0a        qlite</a></b>.