0000: 23 20 48 61 63 6b 69 6e 67 20 6f 6e 20 4d 79 53 # Hacking on MyS
0010: 51 4c 2b 2b 0a 0a 49 66 20 79 6f 75 20 61 72 65 QL++..If you are
0020: 20 67 6f 69 6e 67 20 74 6f 20 6d 61 6b 65 20 61 going to make a
0030: 6e 79 20 63 68 61 6e 67 65 73 20 74 6f 20 4d 79 ny changes to My
0040: 53 51 4c 2b 2b 2c 20 74 68 69 73 20 66 69 6c 65 SQL++, this file
0050: 20 68 61 73 20 73 6f 6d 65 0a 68 69 6e 74 73 20 has some.hints
0060: 61 6e 64 20 63 6f 6d 6d 65 6e 74 61 72 79 20 79 and commentary y
0070: 6f 75 20 6d 61 79 20 66 69 6e 64 20 68 65 6c 70 ou may find help
0080: 66 75 6c 2e 0a 0a 0a 23 23 20 43 6f 64 65 20 52 ful....## Code R
0090: 65 70 6f 73 69 74 6f 72 79 20 41 63 63 65 73 73 epository Access
00a0: 0a 0a 4d 79 53 51 4c 2b 2b 20 75 73 65 73 20 74 ..MySQL++ uses t
00b0: 68 65 20 5b 46 6f 73 73 69 6c 5d 5b 66 73 6c 5d he [Fossil][fsl]
00c0: 20 5b 64 69 73 74 72 69 62 75 74 65 64 20 76 65 [distributed ve
00d0: 72 73 69 6f 6e 20 63 6f 6e 74 72 6f 6c 0a 73 79 rsion control.sy
00e0: 73 74 65 6d 5d 5b 64 76 63 73 5d 2e 20 53 65 65 stem][dvcs]. See
00f0: 20 69 74 73 20 5b 71 75 69 63 6b 20 73 74 61 72 its [quick star
0100: 74 20 67 75 69 64 65 5d 5b 66 73 6c 71 5d 20 69 t guide][fslq] i
0110: 66 20 79 6f 75 20 61 72 65 20 75 6e 66 61 6d 69 f you are unfami
0120: 6c 61 72 0a 77 69 74 68 20 46 6f 73 73 69 6c 2e lar.with Fossil.
0130: 0a 0a 59 6f 75 20 6d 75 73 74 20 62 65 20 72 75 ..You must be ru
0140: 6e 6e 69 6e 67 20 46 6f 73 73 69 6c 20 76 65 72 nning Fossil ver
0150: 73 69 6f 6e 20 32 2e 31 20 6f 72 20 68 69 67 68 sion 2.1 or high
0160: 65 72 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 er to access the
0170: 20 4d 79 53 51 4c 2b 2b 0a 72 65 70 6f 73 69 74 MySQL++.reposit
0180: 6f 72 79 2e 20 49 66 20 79 6f 75 72 20 6f 70 65 ory. If your ope
0190: 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 69 6e rating system in
01a0: 63 6c 75 64 65 73 20 61 6e 20 6f 6c 64 65 72 20 cludes an older
01b0: 46 6f 73 73 69 6c 20 70 61 63 6b 61 67 65 2c 0a Fossil package,.
01c0: 79 6f 75 20 77 69 6c 6c 20 65 69 74 68 65 72 20 you will either
01d0: 68 61 76 65 20 74 6f 20 69 6e 73 74 61 6c 6c 20 have to install
01e0: 5b 61 6e 20 6f 66 66 69 63 69 61 6c 20 62 69 6e [an official bin
01f0: 61 72 79 5d 5b 66 73 6c 62 5d 20 6f 72 20 5b 62 ary][fslb] or [b
0200: 75 69 6c 64 0a 69 74 20 66 72 6f 6d 20 73 6f 75 uild.it from sou
0210: 72 63 65 5d 5b 66 73 6c 73 5d 2e 0a 0a 54 6f 20 rce][fsls]...To
0220: 63 6c 6f 6e 65 20 74 68 65 20 4d 79 53 51 4c 2b clone the MySQL+
0230: 2b 20 72 65 70 6f 73 69 74 6f 72 79 20 61 6e 6f + repository ano
0240: 6e 79 6d 6f 75 73 6c 79 2c 20 73 61 79 3a 0a 0a nymously, say:..
0250: 20 20 20 20 24 20 66 6f 73 73 69 6c 20 63 6c 6f $ fossil clo
0260: 6e 65 20 68 74 74 70 73 3a 2f 2f 74 61 6e 67 65 ne https://tange
0270: 6e 74 73 6f 66 74 2e 63 6f 6d 2f 6d 79 73 71 6c ntsoft.com/mysql
0280: 70 70 20 6d 79 73 71 6c 70 70 2e 66 6f 73 73 69 pp mysqlpp.fossi
0290: 6c 0a 0a 49 66 20 79 6f 75 20 68 61 76 65 20 61 l..If you have a
02a0: 20 64 65 76 65 6c 6f 70 65 72 20 61 63 63 6f 75 developer accou
02b0: 6e 74 20 6f 6e 20 74 68 65 20 4d 79 53 51 4c 2b nt on the MySQL+
02c0: 2b 20 46 6f 73 73 69 6c 20 69 6e 73 74 61 6e 63 + Fossil instanc
02d0: 65 2c 20 6a 75 73 74 20 61 64 64 0a 79 6f 75 72 e, just add.your
02e0: 20 75 73 65 72 6e 61 6d 65 20 74 6f 20 74 68 65 username to the
02f0: 20 55 52 4c 20 6c 69 6b 65 20 73 6f 3a 0a 0a 20 URL like so:..
0300: 20 20 20 24 20 66 6f 73 73 69 6c 20 63 6c 6f 6e $ fossil clon
0310: 65 20 68 74 74 70 73 3a 2f 2f 75 73 65 72 6e 61 e https://userna
0320: 6d 65 40 74 61 6e 65 6e 74 73 6f 66 74 2e 63 6f me@tanentsoft.co
0330: 6d 2f 6d 79 73 71 6c 70 70 20 6d 79 73 71 6c 70 m/mysqlpp mysqlp
0340: 70 2e 66 6f 73 73 69 6c 0a 0a 54 68 61 74 20 77 p.fossil..That w
0350: 69 6c 6c 20 67 65 74 20 79 6f 75 20 61 20 66 69 ill get you a fi
0360: 6c 65 20 63 61 6c 6c 65 64 20 60 6d 79 73 71 6c le called `mysql
0370: 70 70 2e 66 6f 73 73 69 6c 60 20 63 6f 6e 74 61 pp.fossil` conta
0380: 69 6e 69 6e 67 20 74 68 65 20 5b 61 62 72 69 64 ining the [abrid
0390: 67 65 64 0a 76 65 72 73 69 6f 6e 20 68 69 73 74 ged.version hist
03a0: 6f 72 79 5d 5b 61 76 68 5d 20 6f 66 20 4d 79 53 ory][avh] of MyS
03b0: 51 4c 2b 2b 20 62 61 63 6b 20 74 6f 20 74 68 65 QL++ back to the
03c0: 20 70 72 6f 6a 65 63 74 27 73 20 66 6f 75 6e 64 project's found
03d0: 69 6e 67 2e 0a 0a 54 68 65 20 72 65 70 6f 73 69 ing...The reposi
03e0: 74 6f 72 79 20 63 6c 6f 6e 65 20 66 69 6c 65 20 tory clone file
03f0: 63 61 6e 20 62 65 20 6e 61 6d 65 64 20 61 6e 79 can be named any
0400: 74 68 69 6e 67 20 79 6f 75 20 6c 69 6b 65 2e 20 thing you like.
0410: 45 76 65 6e 20 74 68 65 0a 60 2e 66 6f 73 73 69 Even the.`.fossi
0420: 6c 60 20 65 78 74 65 6e 73 69 6f 6e 20 69 73 20 l` extension is
0430: 6a 75 73 74 20 61 20 63 6f 6e 76 65 6e 74 69 6f just a conventio
0440: 6e 2c 20 6e 6f 74 20 61 20 72 65 71 75 69 72 65 n, not a require
0450: 6d 65 6e 74 2e 0a 0a 54 6f 20 22 6f 70 65 6e 22 ment...To "open"
0460: 20 74 68 65 20 72 65 70 6f 20 63 6c 6f 6e 65 20 the repo clone
0470: 73 6f 20 79 6f 75 20 63 61 6e 20 68 61 63 6b 20 so you can hack
0480: 6f 6e 20 69 74 2c 20 73 61 79 3a 0a 0a 20 20 20 on it, say:..
0490: 20 24 20 6d 6b 64 69 72 20 6d 79 73 71 6c 70 70 $ mkdir mysqlpp
04a0: 0a 20 20 20 20 24 20 63 64 20 6d 79 73 71 6c 70 . $ cd mysqlp
04b0: 70 0a 20 20 20 20 24 20 66 6f 73 73 69 6c 20 6f p. $ fossil o
04c0: 70 65 6e 20 2e 2e 2f 6d 79 73 71 6c 70 70 2e 66 pen ../mysqlpp.f
04d0: 6f 73 73 69 6c 0a 0a 57 65 20 63 72 65 61 74 65 ossil..We create
04e0: 64 20 61 20 6e 65 77 20 73 75 62 64 69 72 65 63 d a new subdirec
04f0: 74 6f 72 79 20 62 65 63 61 75 73 65 20 74 68 65 tory because the
0500: 20 60 6f 70 65 6e 60 20 63 6f 6d 6d 61 6e 64 20 `open` command
0510: 63 68 65 63 6b 73 20 6f 75 74 20 74 68 65 0a 74 checks out the.t
0520: 69 70 20 6f 66 20 74 68 65 20 72 65 70 6f 73 69 ip of the reposi
0530: 74 6f 72 79 27 73 20 74 72 75 6e 6b 20 69 6e 74 tory's trunk int
0540: 6f 20 74 68 65 20 63 75 72 72 65 6e 74 20 64 69 o the current di
0550: 72 65 63 74 6f 72 79 20 62 79 20 64 65 66 61 75 rectory by defau
0560: 6c 74 2e 0a 0a 41 73 20 77 69 74 68 20 60 6d 79 lt...As with `my
0570: 73 71 6c 70 70 2e 66 6f 73 73 69 6c 60 2c 20 79 sqlpp.fossil`, y
0580: 6f 75 20 63 61 6e 20 63 61 6c 6c 20 74 68 65 20 ou can call the
0590: 77 6f 72 6b 69 6e 67 20 64 69 72 65 63 74 6f 72 working director
05a0: 79 20 61 6e 79 74 68 69 6e 67 0a 79 6f 75 20 6c y anything.you l
05b0: 69 6b 65 2e 20 49 20 61 63 74 75 61 6c 6c 79 20 ike. I actually
05c0: 70 72 65 66 65 72 20 61 20 77 6f 72 6b 69 6e 67 prefer a working
05d0: 20 74 72 65 65 20 74 68 61 74 20 6c 6f 6f 6b 73 tree that looks
05e0: 20 6c 69 6b 65 20 74 68 69 73 3a 0a 0a 20 20 20 like this:..
05f0: 20 7e 2f 6d 75 73 65 75 6d 2f 20 20 20 20 20 20 ~/museum/
0600: 20 20 20 20 20 20 20 20 20 20 20 20 23 20 57 68 # Wh
0610: 65 72 65 20 66 6f 73 73 69 6c 73 20 61 72 65 20 ere fossils are
0620: 6b 65 70 74 0a 20 20 20 20 20 20 20 20 6d 79 73 kept. mys
0630: 71 6c 70 70 2e 66 6f 73 73 69 6c 0a 20 20 20 20 qlpp.fossil.
0640: 7e 2f 73 72 63 2f 20 20 20 20 20 20 20 20 20 20 ~/src/
0650: 20 20 20 20 20 20 20 20 20 20 20 23 20 57 6f 72 # Wor
0660: 6b 69 6e 67 20 74 72 65 65 20 66 6f 72 20 73 6f king tree for so
0670: 66 74 77 61 72 65 20 70 72 6f 6a 65 63 74 73 0a ftware projects.
0680: 20 20 20 20 20 20 20 20 6d 79 73 71 6c 70 70 2f mysqlpp/
0690: 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 6b 75 . sku
06a0: 6c 6c 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 ll/
06b0: 23 20 46 6f 73 73 69 6c 20 68 65 61 64 2c 20 67 # Fossil head, g
06c0: 65 74 20 69 74 3f 20 20 20 49 20 63 72 61 63 6b et it? I crack
06d0: 20 6d 65 20 75 70 2e 0a 20 20 20 20 20 20 20 20 me up..
06e0: 20 20 20 20 74 72 75 6e 6b 20 2d 3e 20 73 6b 75 trunk -> sku
06f0: 6c 6c 2f 20 20 20 20 23 20 41 6c 69 61 73 20 74 ll/ # Alias t
0700: 6f 20 6d 61 74 63 68 20 46 6f 73 73 69 6c 20 62 o match Fossil b
0710: 72 61 6e 63 68 20 6e 61 6d 69 6e 67 0a 20 20 20 ranch naming.
0720: 20 20 20 20 20 20 20 20 20 73 6f 6d 65 2d 62 72 some-br
0730: 61 6e 63 68 2f 20 20 20 20 20 20 20 23 20 53 65 anch/ # Se
0740: 70 61 72 61 74 65 6c 79 2d 6f 70 65 6e 65 64 20 parately-opened
0750: 77 6f 72 6b 69 6e 67 20 62 72 61 6e 63 68 0a 20 working branch.
0760: 20 20 20 20 20 20 20 20 20 20 20 33 2e 32 2e 33 3.2.3
0770: 2f 20 20 20 20 20 20 20 20 20 20 20 20 20 23 20 / #
0780: 54 61 67 67 65 64 20 72 65 6c 65 61 73 65 20 63 Tagged release c
0790: 68 65 63 6b 6f 75 74 0a 0a 46 6f 73 73 69 6c 20 heckout..Fossil
07a0: 77 69 6c 6c 20 6c 65 74 20 79 6f 75 20 6d 61 6b will let you mak
07b0: 65 20 61 6e 79 20 6d 6f 64 69 66 69 63 61 74 69 e any modificati
07c0: 6f 6e 73 20 79 6f 75 20 6c 69 6b 65 20 74 6f 20 ons you like to
07d0: 79 6f 75 72 20 6c 6f 63 61 6c 0a 72 65 70 6f 73 your local.repos
07e0: 69 74 6f 72 79 20 63 6f 70 79 2e 20 46 6f 72 20 itory copy. For
07f0: 74 68 6f 73 65 20 77 69 74 68 20 70 72 69 76 69 those with privi
0800: 6c 65 67 65 73 20 6f 6e 20 74 68 65 20 75 70 73 leges on the ups
0810: 74 72 65 61 6d 20 63 6f 70 79 2c 0a 63 68 65 63 tream copy,.chec
0820: 6b 69 6e 73 20 67 65 74 20 61 75 74 6f 6d 61 74 kins get automat
0830: 69 63 61 6c 6c 79 20 73 79 6e 63 65 64 20 77 69 ically synced wi
0840: 74 68 20 69 74 20 62 79 20 64 65 66 61 75 6c 74 th it by default
0850: 2e 20 28 49 66 20 79 6f 75 20 70 72 65 66 65 72 . (If you prefer
0860: 0a 47 69 74 20 6f 72 20 4d 65 72 63 75 72 69 61 .Git or Mercuria
0870: 6c 20 73 74 79 6c 65 20 74 77 6f 2d 70 68 61 73 l style two-phas
0880: 65 20 63 6f 6d 6d 69 74 73 2c 20 79 6f 75 20 63 e commits, you c
0890: 61 6e 20 73 61 79 20 60 66 6f 73 73 69 6c 20 73 an say `fossil s
08a0: 65 74 74 69 6e 67 73 0a 61 75 74 6f 73 79 6e 63 ettings.autosync
08b0: 20 6f 66 66 60 2e 29 20 49 66 20 79 6f 75 20 64 off`.) If you d
08c0: 6f 6e 27 74 20 68 61 76 65 20 73 75 63 68 20 70 on't have such p
08d0: 65 72 6d 69 73 73 69 6f 6e 73 2c 20 79 6f 75 20 ermissions, you
08e0: 6a 75 73 74 20 6d 6f 64 69 66 79 0a 79 6f 75 72 just modify.your
08f0: 20 6c 6f 63 61 6c 20 63 6f 70 79 2c 20 74 68 65 local copy, the
0900: 6e 20 68 61 76 65 20 74 6f 20 6d 65 72 67 65 20 n have to merge
0910: 69 6e 20 75 70 73 74 72 65 61 6d 20 63 68 61 6e in upstream chan
0920: 67 65 73 20 77 68 65 6e 20 75 70 64 61 74 69 6e ges when updatin
0930: 67 0a 79 6f 75 72 20 6c 6f 63 61 6c 20 63 6c 6f g.your local clo
0940: 6e 65 2e 0a 0a 44 65 76 65 6c 6f 70 65 72 73 20 ne...Developers
0950: 61 72 65 20 65 78 70 65 63 74 65 64 20 74 6f 20 are expected to
0960: 6d 61 6b 65 20 61 6c 6c 20 63 68 61 6e 67 65 73 make all changes
0970: 20 74 68 61 74 20 61 66 66 65 63 74 20 74 68 65 that affect the
0980: 20 6c 69 62 61 72 79 27 73 0a 41 50 49 2c 20 41 libary's.API, A
0990: 42 49 2c 20 6f 72 20 62 65 68 61 76 69 6f 72 20 BI, or behavior
09a0: 6f 6e 20 61 20 62 72 61 6e 63 68 2c 20 72 61 74 on a branch, rat
09b0: 68 65 72 20 74 68 61 6e 20 63 68 65 63 6b 20 73 her than check s
09c0: 75 63 68 20 63 68 61 6e 67 65 73 0a 64 69 72 65 uch changes.dire
09d0: 63 74 6c 79 20 69 6e 74 6f 20 74 68 65 20 74 72 ctly into the tr
09e0: 75 6e 6b 2e 20 4f 6e 63 65 20 77 65 20 68 61 76 unk. Once we hav
09f0: 65 20 64 69 73 63 75 73 73 65 64 20 74 68 65 20 e discussed the
0a00: 63 68 61 6e 67 65 20 6f 6e 20 74 68 65 0a 5b 6d change on the.[m
0a10: 61 69 6c 69 6e 67 20 6c 69 73 74 5d 5b 6d 6c 5d ailing list][ml]
0a20: 20 61 6e 64 20 72 65 73 6f 6c 76 65 64 20 61 6e and resolved an
0a30: 79 20 69 73 73 73 75 65 73 20 77 69 74 68 20 74 y isssues with t
0a40: 68 65 20 65 78 70 65 72 69 6d 65 6e 74 61 6c 0a he experimental.
0a50: 62 72 61 6e 63 68 2c 20 69 74 20 77 69 6c 6c 20 branch, it will
0a60: 62 65 20 6d 65 72 67 65 64 20 69 6e 74 6f 20 74 be merged into t
0a70: 68 65 20 74 72 75 6e 6b 2e 0a 0a 43 72 65 61 74 he trunk...Creat
0a80: 69 6e 67 20 61 20 62 72 61 6e 63 68 20 69 6e 20 ing a branch in
0a90: 46 6f 73 73 69 6c 20 69 73 20 73 63 61 72 79 2d Fossil is scary-
0aa0: 73 69 6d 70 6c 65 2c 20 74 6f 20 74 68 65 20 70 simple, to the p
0ab0: 6f 69 6e 74 20 74 68 61 74 20 74 68 6f 73 65 0a oint that those.
0ac0: 63 6f 6d 69 6e 67 20 66 72 6f 6d 20 6f 74 68 65 coming from othe
0ad0: 72 20 76 65 72 73 69 6f 6e 20 63 6f 6e 74 72 6f r version contro
0ae0: 6c 20 73 79 73 74 65 6d 73 20 6d 61 79 20 61 73 l systems may as
0af0: 6b 2c 20 22 49 73 20 74 68 61 74 20 72 65 61 6c k, "Is that real
0b00: 6c 79 20 61 6c 6c 0a 74 68 65 72 65 20 69 73 20 ly all.there is
0b10: 74 6f 20 69 74 3f 22 20 59 65 73 2c 20 72 65 61 to it?" Yes, rea
0b20: 6c 6c 79 2c 20 74 68 69 73 20 69 73 20 69 74 3a lly, this is it:
0b30: 0a 0a 20 20 20 20 24 20 66 6f 73 73 69 6c 20 63 .. $ fossil c
0b40: 68 65 63 6b 69 6e 20 2d 2d 62 72 61 6e 63 68 20 heckin --branch
0b50: 6e 65 77 2d 62 72 61 6e 63 68 2d 6e 61 6d 65 0a new-branch-name.
0b60: 0a 54 68 61 74 20 69 73 20 74 6f 20 73 61 79 2c .That is to say,
0b70: 20 79 6f 75 20 6d 61 6b 65 20 79 6f 75 72 20 63 you make your c
0b80: 68 61 6e 67 65 73 20 61 73 20 79 6f 75 20 6e 6f hanges as you no
0b90: 72 6d 61 6c 6c 79 20 77 6f 75 6c 64 3b 20 74 68 rmally would; th
0ba0: 65 6e 20 77 68 65 6e 0a 79 6f 75 20 67 6f 20 74 en when.you go t
0bb0: 6f 20 63 68 65 63 6b 20 74 68 65 6d 20 69 6e 2c o check them in,
0bc0: 20 79 6f 75 20 67 69 76 65 20 74 68 65 20 60 2d you give the `-
0bd0: 2d 62 72 61 6e 63 68 60 20 6f 70 74 69 6f 6e 20 -branch` option
0be0: 74 6f 20 74 68 65 0a 60 63 69 2f 63 68 65 63 6b to the.`ci/check
0bf0: 69 6e 60 20 63 6f 6d 6d 61 6e 64 20 74 6f 20 70 in` command to p
0c00: 75 74 20 74 68 65 20 63 68 61 6e 67 65 73 20 6f ut the changes o
0c10: 6e 20 61 20 6e 65 77 20 62 72 61 6e 63 68 2c 20 n a new branch,
0c20: 72 61 74 68 65 72 20 74 68 61 6e 20 61 64 64 0a rather than add.
0c30: 74 68 65 6d 20 74 6f 20 74 68 65 20 73 61 6d 65 them to the same
0c40: 20 62 72 61 6e 63 68 20 74 68 65 20 63 68 61 6e branch the chan
0c50: 67 65 73 20 77 65 72 65 20 6d 61 64 65 20 61 67 ges were made ag
0c60: 61 69 6e 73 74 2e 0a 0a 41 74 20 73 6f 6d 65 20 ainst...At some
0c70: 70 6f 69 6e 74 2c 20 74 68 65 20 74 72 75 6e 6b point, the trunk
0c80: 20 76 65 72 73 69 6f 6e 20 62 65 63 6f 6d 65 73 version becomes
0c90: 20 74 68 65 20 6e 65 78 74 20 6d 61 6a 6f 72 20 the next major
0ca0: 76 65 72 73 69 6f 6e 2e 20 53 74 61 62 6c 65 0a version. Stable.
0cb0: 76 65 72 73 69 6f 6e 73 20 62 65 63 6f 6d 65 20 versions become
0cc0: 65 69 74 68 65 72 20 74 61 67 73 20 6f 72 20 62 either tags or b
0cd0: 72 61 6e 63 68 65 73 2e 20 28 54 68 65 20 6f 6e ranches. (The on
0ce0: 6c 79 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 ly difference be
0cf0: 74 77 65 65 6e 0a 74 61 67 73 20 61 6e 64 20 62 tween.tags and b
0d00: 72 61 6e 63 68 65 73 20 69 6e 20 46 6f 73 73 69 ranches in Fossi
0d10: 6c 20 69 73 20 74 68 61 74 20 62 72 61 6e 63 68 l is that branch
0d20: 65 73 20 6d 61 79 20 68 61 76 65 20 73 75 62 73 es may have subs
0d30: 65 71 75 65 6e 74 20 63 68 61 6e 67 65 73 0a 6d equent changes.m
0d40: 61 64 65 20 74 6f 20 74 68 65 6d 2e 29 0a 0a 5b ade to them.)..[
0d50: 61 76 68 5d 3a 20 20 68 74 74 70 73 3a 2f 2f 74 avh]: https://t
0d60: 61 6e 67 65 6e 74 73 6f 66 74 2e 63 6f 6d 2f 6d angentsoft.com/m
0d70: 79 73 71 6c 70 70 2f 77 69 6b 69 3f 6e 61 6d 65 ysqlpp/wiki?name
0d80: 3d 41 62 72 69 64 67 65 64 2b 56 65 72 73 69 6f =Abridged+Versio
0d90: 6e 2b 48 69 73 74 6f 72 79 0a 5b 64 76 63 73 5d n+History.[dvcs]
0da0: 3a 20 68 74 74 70 3a 2f 2f 65 6e 2e 77 69 6b 69 : http://en.wiki
0db0: 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 44 pedia.org/wiki/D
0dc0: 69 73 74 72 69 62 75 74 65 64 5f 72 65 76 69 73 istributed_revis
0dd0: 69 6f 6e 5f 63 6f 6e 74 72 6f 6c 0a 5b 66 73 6c ion_control.[fsl
0de0: 5d 3a 20 20 68 74 74 70 3a 2f 2f 66 6f 73 73 69 ]: http://fossi
0df0: 6c 2d 73 63 6d 2e 6f 72 67 2f 0a 5b 66 73 6c 62 l-scm.org/.[fslb
0e00: 5d 3a 20 68 74 74 70 3a 2f 2f 66 6f 73 73 69 6c ]: http://fossil
0e10: 2d 73 63 6d 2e 6f 72 67 2f 69 6e 64 65 78 2e 68 -scm.org/index.h
0e20: 74 6d 6c 2f 75 76 2f 64 6f 77 6e 6c 6f 61 64 2e tml/uv/download.
0e30: 68 74 6d 6c 0a 5b 66 73 6c 71 5d 3a 20 68 74 74 html.[fslq]: htt
0e40: 70 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f p://fossil-scm.o
0e50: 72 67 2f 69 6e 64 65 78 2e 68 74 6d 6c 2f 64 6f rg/index.html/do
0e60: 63 2f 74 72 75 6e 6b 2f 77 77 77 2f 71 75 69 63 c/trunk/www/quic
0e70: 6b 73 74 61 72 74 2e 77 69 6b 69 0a 5b 66 73 6c kstart.wiki.[fsl
0e80: 73 5d 3a 20 68 74 74 70 3a 2f 2f 66 6f 73 73 69 s]: http://fossi
0e90: 6c 2d 73 63 6d 2e 6f 72 67 2f 69 6e 64 65 78 2e l-scm.org/index.
0ea0: 68 74 6d 6c 2f 64 6f 63 2f 74 72 75 6e 6b 2f 77 html/doc/trunk/w
0eb0: 77 77 2f 62 75 69 6c 64 2e 77 69 6b 69 0a 5b 6d ww/build.wiki.[m
0ec0: 6c 5d 3a 20 20 20 68 74 74 70 73 3a 2f 2f 6c 69 l]: https://li
0ed0: 73 74 73 2e 6d 79 73 71 6c 2e 63 6f 6d 2f 70 6c sts.mysql.com/pl
0ee0: 75 73 70 6c 75 73 2f 0a 0a 0a 23 23 20 42 6f 6f usplus/...## Boo
0ef0: 74 73 74 72 61 70 70 69 6e 67 20 74 68 65 20 4c tstrapping the L
0f00: 69 62 72 61 72 79 0a 0a 57 68 65 6e 20 79 6f 75 ibrary..When you
0f10: 20 63 68 65 63 6b 20 6f 75 74 20 4d 79 53 51 4c check out MySQL
0f20: 2b 2b 20 66 72 6f 6d 20 46 6f 73 73 69 6c 2c 20 ++ from Fossil,
0f30: 74 68 65 72 65 20 61 72 65 20 61 20 6c 6f 74 20 there are a lot
0f40: 6f 66 20 74 68 69 6e 67 73 0a 22 6d 69 73 73 69 of things."missi
0f50: 6e 67 22 20 61 73 20 63 6f 6d 70 61 72 65 64 20 ng" as compared
0f60: 74 6f 20 61 20 64 69 73 74 72 69 62 75 74 65 64 to a distributed
0f70: 20 74 61 72 62 61 6c 6c 2c 20 62 65 63 61 75 73 tarball, becaus
0f80: 65 20 74 68 65 20 46 6f 73 73 69 6c 0a 72 65 70 e the Fossil.rep
0f90: 6f 73 69 74 6f 72 79 20 63 6f 6e 74 61 69 6e 73 ository contains
0fa0: 20 6f 6e 6c 79 20 73 6f 75 72 63 65 20 66 69 6c only source fil
0fb0: 65 73 2c 20 6e 6f 20 67 65 6e 65 72 61 74 65 64 es, no generated
0fc0: 20 66 69 6c 65 73 2e 20 20 54 68 65 0a 70 72 6f files. The.pro
0fd0: 63 65 73 73 20 74 68 61 74 20 74 75 72 6e 73 20 cess that turns
0fe0: 61 20 66 72 65 73 68 20 4d 79 53 51 4c 2b 2b 20 a fresh MySQL++
0ff0: 72 65 70 6f 73 69 74 6f 72 79 20 63 68 65 63 6b repository check
1000: 6f 75 74 20 69 6e 74 6f 0a 73 6f 6d 65 74 68 69 out into.somethi
1010: 6e 67 20 79 6f 75 20 63 61 6e 20 62 75 69 6c 64 ng you can build
1020: 20 61 6e 64 20 68 61 63 6b 20 6f 6e 20 69 73 20 and hack on is
1030: 63 61 6c 6c 65 64 20 62 6f 6f 74 73 74 72 61 70 called bootstrap
1040: 70 69 6e 67 2e 0a 0a 42 6f 6f 73 74 72 61 70 70 ping...Boostrapp
1050: 69 6e 67 20 69 73 20 62 65 73 74 20 64 6f 6e 65 ing is best done
1060: 20 6f 6e 20 61 20 6d 6f 64 65 72 6e 20 55 6e 69 on a modern Uni
1070: 78 20 74 79 70 65 20 70 6c 61 74 66 6f 72 6d 3a x type platform:
1080: 20 4c 69 6e 75 78 2c 20 4f 53 0a 58 2c 20 42 53 Linux, OS.X, BS
1090: 44 2c 20 53 6f 6c 61 72 69 73 2e 2e 2e 61 6e 79 D, Solaris...any
10a0: 20 76 65 72 73 69 6f 6e 20 72 65 6c 65 61 73 65 version release
10b0: 64 20 73 69 6e 63 65 20 32 30 30 35 20 6f 72 20 d since 2005 or
10c0: 73 6f 2e 20 49 74 27 73 0a 70 6f 73 73 69 62 6c so. It's.possibl
10d0: 65 20 74 6f 20 64 6f 20 69 74 20 6f 6e 20 57 69 e to do it on Wi
10e0: 6e 64 6f 77 73 2c 20 62 75 74 20 6d 75 63 68 20 ndows, but much
10f0: 68 61 72 64 65 72 3b 20 77 65 20 63 6f 76 65 72 harder; we cover
1100: 20 74 68 65 20 6f 70 74 69 6f 6e 73 0a 62 65 6c the options.bel
1110: 6f 77 20 69 6e 20 61 20 73 65 70 61 72 61 74 65 ow in a separate
1120: 20 73 65 63 74 69 6f 6e 2e 0a 0a 54 77 6f 20 6f section...Two o
1130: 66 20 74 68 65 20 74 6f 6f 6c 73 20 79 6f 75 20 f the tools you
1140: 6e 65 65 64 20 74 6f 20 64 6f 20 74 68 69 73 20 need to do this
1150: 61 72 65 20 63 6f 6d 6d 6f 6e 6c 79 20 61 76 61 are commonly ava
1160: 69 6c 61 62 6c 65 20 6f 6e 20 55 6e 69 78 79 0a ilable on Unixy.
1170: 73 79 73 74 65 6d 73 2c 20 61 74 20 6c 65 61 73 systems, at leas
1180: 74 20 61 73 20 61 6e 20 6f 70 74 69 6f 6e 3a 20 t as an option:
1190: 50 65 72 6c 20 35 2c 20 61 6e 64 20 47 4e 55 20 Perl 5, and GNU
11a0: 41 75 74 6f 63 6f 6e 66 20 31 2e 35 39 20 6f 72 Autoconf 1.59 or
11b0: 20 68 69 67 68 65 72 2e 0a 49 66 20 74 68 65 79 higher..If they
11c0: 27 72 65 20 6e 6f 74 20 69 6e 73 74 61 6c 6c 65 're not installe
11d0: 64 2c 20 79 6f 75 20 63 61 6e 20 70 72 6f 62 61 d, you can proba
11e0: 62 6c 79 20 72 75 6e 20 79 6f 75 72 20 73 79 73 bly run your sys
11f0: 74 65 6d 27 73 20 70 61 63 6b 61 67 65 0a 6d 61 tem's package.ma
1200: 6e 61 67 65 72 20 74 6f 20 69 6e 73 74 61 6c 6c nager to install
1210: 20 73 75 69 74 61 62 6c 65 20 76 65 72 73 69 6f suitable versio
1220: 6e 73 2e 0a 0a 54 68 65 72 65 27 73 20 61 20 74 ns...There's a t
1230: 68 69 72 64 20 74 6f 6f 6c 20 79 6f 75 27 6c 6c hird tool you'll
1240: 20 6e 65 65 64 20 74 6f 20 62 6f 6f 74 73 74 72 need to bootstr
1250: 61 70 20 4d 79 53 51 4c 2b 2b 20 63 61 6c 6c 65 ap MySQL++ calle
1260: 64 0a 5b 42 61 6b 65 66 69 6c 65 5d 5b 62 66 5d d.[Bakefile][bf]
1270: 2e 20 59 6f 75 20 77 69 6c 6c 20 6e 65 65 64 20 . You will need
1280: 42 61 6b 65 66 69 6c 65 20 30 2e 32 2e 35 20 6f Bakefile 0.2.5 o
1290: 72 20 68 69 67 68 65 72 2c 20 77 68 69 63 68 20 r higher, which
12a0: 69 6e 20 74 75 72 6e 0a 72 65 71 75 69 72 65 73 in turn.requires
12b0: 20 50 79 74 68 6f 6e 20 32 2e 33 20 6f 72 20 68 Python 2.3 or h
12c0: 69 67 68 65 72 20 74 6f 20 72 75 6e 2e 20 28 4d igher to run. (M
12d0: 79 53 51 4c 2b 2b 20 69 73 20 63 75 72 72 65 6e ySQL++ is curren
12e0: 74 6c 79 20 6e 6f 74 0a 63 6f 6d 70 61 74 69 62 tly not.compatib
12f0: 6c 65 20 77 69 74 68 20 42 61 6b 65 66 69 6c 65 le with Bakefile
1300: 20 31 2e 78 2c 20 61 73 20 69 74 20 69 73 20 73 1.x, as it is s
1310: 74 69 6c 6c 20 61 20 77 6f 72 6b 20 69 6e 20 70 till a work in p
1320: 72 6f 67 72 65 73 73 20 61 73 20 6f 66 0a 74 68 rogress as of.th
1330: 69 73 20 77 72 69 74 69 6e 67 2e 29 20 54 6f 20 is writing.) To
1340: 62 75 69 6c 64 20 42 61 6b 65 66 69 6c 65 20 66 build Bakefile f
1350: 72 6f 6d 20 73 6f 75 72 63 65 2c 20 79 6f 75 20 rom source, you
1360: 77 69 6c 6c 20 61 6c 73 6f 20 6e 65 65 64 20 53 will also need S
1370: 57 49 47 2c 0a 73 6f 20 69 66 20 79 6f 75 20 64 WIG,.so if you d
1380: 6f 6e 27 74 20 68 61 76 65 20 74 68 61 74 2c 20 on't have that,
1390: 79 6f 75 27 6c 6c 20 77 61 6e 74 20 74 6f 20 75 you'll want to u
13a0: 73 65 20 6f 6e 65 20 6f 66 20 74 68 65 20 62 69 se one of the bi
13b0: 6e 61 72 79 20 62 75 69 6c 64 73 0a 6f 66 20 42 nary builds.of B
13c0: 61 6b 65 66 69 6c 65 2e 0a 0a 4f 6e 63 65 20 79 akefile...Once y
13d0: 6f 75 20 68 61 76 65 20 61 6c 6c 20 74 68 65 20 ou have all the
13e0: 74 6f 6f 6c 73 20 69 6e 20 70 6c 61 63 65 2c 20 tools in place,
13f0: 79 6f 75 20 63 61 6e 20 62 6f 6f 74 73 74 72 61 you can bootstra
1400: 70 20 4d 79 53 51 4c 2b 2b 20 77 69 74 68 20 61 p MySQL++ with a
1410: 0a 42 6f 75 72 6e 65 20 73 68 65 6c 6c 20 73 63 .Bourne shell sc
1420: 72 69 70 74 20 63 61 6c 6c 65 64 20 60 62 6f 6f ript called `boo
1430: 74 73 74 72 61 70 60 2c 20 77 68 69 63 68 20 79 tstrap`, which y
1440: 6f 75 20 67 65 74 20 61 73 20 70 61 72 74 20 6f ou get as part o
1450: 66 20 74 68 65 0a 46 6f 73 73 69 6c 20 63 68 65 f the.Fossil che
1460: 63 6b 6f 75 74 2e 20 49 74 27 73 20 66 61 69 72 ckout. It's fair
1470: 6c 79 20 70 6f 77 65 72 66 75 6c 2c 20 77 69 74 ly powerful, wit
1480: 68 20 6d 61 6e 79 20 6f 70 74 69 6f 6e 73 2e 20 h many options.
1490: 20 46 6f 72 20 6d 6f 73 74 0a 63 61 73 65 73 2c For most.cases,
14a0: 20 69 74 20 73 75 66 66 69 63 65 73 20 74 6f 20 it suffices to
14b0: 6a 75 73 74 20 72 75 6e 20 69 74 20 77 69 74 68 just run it with
14c0: 6f 75 74 20 61 6e 79 20 61 72 67 75 6d 65 6e 74 out any argument
14d0: 73 3a 0a 0a 20 20 20 20 24 20 2e 2f 62 6f 6f 74 s:.. $ ./boot
14e0: 73 74 72 61 70 0a 0a 46 6f 72 20 6d 6f 72 65 20 strap..For more
14f0: 75 6e 75 73 75 61 6c 20 73 69 74 75 61 74 69 6f unusual situatio
1500: 6e 73 2c 20 68 65 72 65 27 73 20 74 68 65 20 63 ns, here's the c
1510: 6f 6d 70 6c 65 74 65 20 75 73 61 67 65 3a 0a 0a omplete usage:..
1520: 20 20 20 20 24 20 2e 2f 62 6f 6f 74 73 74 72 61 $ ./bootstra
1530: 70 20 5b 6e 6f 7b 64 6f 63 2c 65 78 2c 6c 69 62 p [no{doc,ex,lib
1540: 2c 6f 70 74 7d 5d 20 5b 70 65 64 61 6e 74 69 63 ,opt}] [pedantic
1550: 5d 20 5b 62 61 74 5d 20 5b 63 6f 6e 66 69 67 75 ] [bat] [configu
1560: 72 65 20 66 6c 61 67 73 5d 0a 0a 41 72 67 75 6d re flags]..Argum
1570: 65 6e 74 73 3a 0a 0a 2a 20 20 20 60 6e 6f 64 6f ents:..* `nodo
1580: 63 60 0a 0a 20 20 20 20 54 68 65 20 64 6f 63 75 c`.. The docu
1590: 6d 65 6e 74 61 74 69 6f 6e 20 77 6f 6e 27 74 20 mentation won't
15a0: 62 65 20 63 6f 6e 73 69 64 65 72 65 64 20 61 20 be considered a
15b0: 70 72 65 72 65 71 75 69 73 69 74 65 20 66 6f 72 prerequisite for
15c0: 20 62 75 69 6c 64 69 6e 67 0a 20 20 20 20 74 68 building. th
15d0: 65 20 64 69 73 74 72 69 62 75 74 69 6f 6e 20 74 e distribution t
15e0: 61 72 62 61 6c 6c 2e 20 54 68 69 73 20 69 73 20 arball. This is
15f0: 75 73 65 66 75 6c 20 6f 6e 20 73 79 73 74 65 6d useful on system
1600: 73 20 77 68 65 72 65 20 74 68 65 0a 20 20 20 20 s where the.
1610: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 64 6f documentation do
1620: 65 73 6e 27 74 20 62 75 69 6c 64 20 63 6f 72 72 esn't build corr
1630: 65 63 74 6c 79 2c 20 61 6e 64 20 79 6f 75 20 6f ectly, and you o
1640: 6e 6c 79 20 6e 65 65 64 20 74 6f 20 6d 61 6b 65 nly need to make
1650: 20 61 0a 20 20 20 20 62 69 6e 61 72 79 20 52 50 a. binary RP
1660: 4d 2e 20 54 68 61 74 20 70 72 6f 63 65 73 73 20 M. That process
1670: 72 65 71 75 69 72 65 73 20 61 20 74 61 72 62 61 requires a tarba
1680: 6c 6c 2c 20 62 75 74 20 64 6f 65 73 6e 27 74 20 ll, but doesn't
1690: 6e 65 65 64 20 74 68 65 0a 20 20 20 20 64 6f 63 need the. doc
16a0: 75 6d 65 6e 74 61 74 69 6f 6e 2e 20 44 6f 6e 27 umentation. Don'
16b0: 74 20 64 69 73 74 72 69 62 75 74 65 20 74 68 65 t distribute the
16c0: 20 74 61 72 62 61 6c 6c 20 6f 72 20 53 52 50 4d tarball or SRPM
16d0: 20 74 68 61 74 20 72 65 73 75 6c 74 73 2c 20 61 that results, a
16e0: 73 0a 20 20 20 20 74 68 65 79 20 61 72 65 20 6e s. they are n
16f0: 6f 20 67 6f 6f 64 20 66 6f 72 20 61 6e 79 20 6f o good for any o
1700: 74 68 65 72 20 70 75 72 70 6f 73 65 2e 0a 0a 2a ther purpose...*
1710: 20 20 20 60 6e 6f 65 78 60 0a 0a 20 20 20 20 54 `noex`.. T
1720: 68 65 20 67 65 6e 65 72 61 74 65 64 20 60 4d 61 he generated `Ma
1730: 6b 65 66 69 6c 65 73 60 20 61 6e 64 20 70 72 6f kefiles` and pro
1740: 6a 65 63 74 20 66 69 6c 65 73 20 77 6f 6e 27 74 ject files won't
1750: 20 74 72 79 20 74 6f 20 62 75 69 6c 64 20 61 6e try to build an
1760: 79 20 6f 66 0a 20 20 20 20 74 68 65 20 65 78 61 y of. the exa
1770: 6d 70 6c 65 73 2e 0a 0a 2a 20 20 20 60 6e 6f 6c mples...* `nol
1780: 69 62 60 0a 0a 20 20 20 20 54 68 65 20 67 65 6e ib`.. The gen
1790: 65 72 61 74 65 64 20 60 4d 61 6b 65 66 69 6c 65 erated `Makefile
17a0: 73 60 20 61 6e 64 20 70 72 6f 6a 65 63 74 20 66 s` and project f
17b0: 69 6c 65 73 20 77 6f 6e 27 74 20 74 72 79 20 74 iles won't try t
17c0: 6f 20 62 75 69 6c 64 20 74 68 65 0a 20 20 20 20 o build the.
17d0: 4d 79 53 51 4c 2b 2b 20 6c 69 62 72 61 72 79 2e MySQL++ library.
17e0: 0a 0a 2a 20 20 20 60 6e 6f 6d 61 69 6e 74 60 0a ..* `nomaint`.
17f0: 0a 20 20 20 20 54 75 72 6e 20 6f 66 66 20 22 6d . Turn off "m
1800: 61 69 6e 74 61 69 6e 65 72 20 6d 6f 64 65 22 20 aintainer mode"
1810: 73 74 75 66 66 20 69 6e 20 74 68 65 20 62 75 69 stuff in the bui
1820: 6c 64 2e 20 54 68 65 73 65 20 61 72 65 20 66 65 ld. These are fe
1830: 61 74 75 72 65 73 0a 20 20 20 20 75 73 65 64 20 atures. used
1840: 6f 6e 6c 79 20 62 79 20 74 68 6f 73 65 20 62 75 only by those bu
1850: 69 6c 64 69 6e 67 20 4d 79 53 51 4c 2b 2b 20 66 ilding MySQL++ f
1860: 72 6f 6d 20 46 6f 73 73 69 6c 2e 20 54 68 65 20 rom Fossil. The
1870: 60 64 69 73 74 60 20 62 75 69 6c 64 0a 20 20 20 `dist` build.
1880: 20 74 61 72 67 65 74 20 75 73 65 73 20 74 68 69 target uses thi
1890: 73 20 77 68 65 6e 20 63 72 65 61 74 69 6e 67 20 s when creating
18a0: 74 68 65 20 74 61 72 62 61 6c 6c 2e 0a 0a 2a 20 the tarball...*
18b0: 20 20 60 6e 6f 6f 70 74 60 0a 0a 20 20 20 20 43 `noopt`.. C
18c0: 6f 6d 70 69 6c 65 72 20 6f 70 74 69 6d 69 7a 61 ompiler optimiza
18d0: 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 74 75 72 tion will be tur
18e0: 6e 65 64 20 6f 66 66 2e 20 28 54 68 69 73 20 63 ned off. (This c
18f0: 75 72 72 65 6e 74 6c 79 20 68 61 73 20 6e 6f 0a urrently has no.
1900: 20 20 20 20 65 66 66 65 63 74 20 6f 6e 20 4d 69 effect on Mi
1910: 6e 47 57 20 6f 72 20 56 69 73 75 61 6c 20 43 2b nGW or Visual C+
1920: 2b 2e 29 0a 0a 2a 20 20 20 60 70 65 64 61 6e 74 +.)..* `pedant
1930: 69 63 60 0a 0a 20 20 20 20 54 75 72 6e 73 20 6f ic`.. Turns o
1940: 6e 20 61 6c 6c 20 6f 66 20 47 43 43 27 73 20 77 n all of GCC's w
1950: 61 72 6e 69 6e 67 73 20 61 6e 64 20 70 6f 72 74 arnings and port
1960: 61 62 69 6c 69 74 79 20 63 68 65 63 6b 73 2e 20 ability checks.
1970: 20 47 6f 6f 64 20 66 6f 72 0a 20 20 20 20 63 68 Good for. ch
1980: 65 63 6b 69 6e 67 20 63 68 61 6e 67 65 73 20 62 ecking changes b
1990: 65 66 6f 72 65 20 6d 61 6b 69 6e 67 20 61 20 70 efore making a p
19a0: 75 62 6c 69 63 20 72 65 6c 65 61 73 65 2e 0a 0a ublic release...
19b0: 2a 20 20 20 60 62 61 74 60 0a 0a 20 20 20 20 41 * `bat`.. A
19c0: 73 6b 73 20 60 63 6d 64 2e 65 78 65 60 20 74 6f sks `cmd.exe` to
19d0: 20 72 75 6e 20 60 62 6f 6f 74 73 74 72 61 70 2e run `bootstrap.
19e0: 62 61 74 60 20 66 6f 72 20 79 6f 75 2e 20 54 68 bat` for you. Th
19f0: 69 73 20 69 73 20 75 73 65 66 75 6c 20 77 68 65 is is useful whe
1a00: 6e 0a 20 20 20 20 75 73 69 6e 67 20 43 79 67 77 n. using Cygw
1a10: 69 6e 20 6a 75 73 74 20 61 73 20 61 20 63 6f 6d in just as a com
1a20: 6d 61 6e 64 20 73 68 65 6c 6c 20 69 6e 20 70 72 mand shell in pr
1a30: 65 66 65 72 65 6e 63 65 20 74 6f 20 60 63 6d 64 eference to `cmd
1a40: 2e 65 78 65 60 2c 20 61 73 0a 20 20 20 20 6f 70 .exe`, as. op
1a50: 70 6f 73 65 64 20 74 6f 20 75 73 69 6e 67 20 43 posed to using C
1a60: 79 67 77 69 6e 20 74 6f 20 62 75 69 6c 64 20 4d ygwin to build M
1a70: 79 53 51 4c 2b 2b 20 75 73 69 6e 67 20 69 74 73 ySQL++ using its
1a80: 20 6e 61 74 69 76 65 20 74 6f 6f 6c 73 2e 0a 20 native tools..
1a90: 20 20 20 50 61 73 73 69 6e 67 20 27 62 61 74 27 Passing 'bat'
1aa0: 20 73 74 6f 70 73 20 61 6c 6c 20 63 6f 6d 6d 61 stops all comma
1ab0: 6e 64 20 6c 69 6e 65 20 70 72 6f 63 65 73 73 69 nd line processi
1ac0: 6e 67 20 69 6e 20 74 68 65 20 62 6f 6f 74 73 74 ng in the bootst
1ad0: 72 61 70 0a 20 20 20 20 73 63 72 69 70 74 2c 20 rap. script,
1ae0: 73 6f 20 69 66 20 79 6f 75 20 61 6c 73 6f 20 70 so if you also p
1af0: 61 73 73 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 ass some of the
1b00: 6f 74 68 65 72 20 6f 70 74 69 6f 6e 73 2c 20 6d other options, m
1b10: 61 6b 65 20 22 60 62 61 74 60 22 0a 20 20 20 20 ake "`bat`".
1b20: 6c 61 73 74 2e 20 20 54 68 65 20 6f 6e 6c 79 20 last. The only
1b30: 6f 70 74 69 6f 6e 73 20 74 68 61 74 20 61 66 66 options that aff
1b40: 65 63 74 20 74 68 65 20 62 75 69 6c 74 20 70 72 ect the built pr
1b50: 6f 6a 65 63 74 20 66 69 6c 65 73 20 61 6e 64 0a oject files and.
1b60: 20 20 20 20 60 4d 61 6b 65 66 69 6c 65 73 60 20 `Makefiles`
1b70: 77 6f 72 6b 20 61 72 65 20 74 68 65 20 6e 6f 2a work are the no*
1b80: 20 6f 6e 65 73 2e 0a 0a 2a 20 20 20 60 63 6f 6e ones...* `con
1b90: 66 69 67 75 72 65 60 20 73 63 72 69 70 74 20 6f figure` script o
1ba0: 70 74 69 6f 6e 73 0a 0a 20 20 20 20 41 73 20 73 ptions.. As s
1bb0: 6f 6f 6e 20 61 73 20 74 68 65 20 62 6f 6f 74 73 oon as the boots
1bc0: 74 72 61 70 20 73 63 72 69 70 74 20 73 65 65 73 trap script sees
1bd0: 20 61 6e 20 6f 70 74 69 6f 6e 20 74 68 61 74 20 an option that
1be0: 69 74 20 64 6f 65 73 6e 27 74 0a 20 20 20 20 75 it doesn't. u
1bf0: 6e 64 65 72 73 74 61 6e 64 2c 20 69 74 20 73 74 nderstand, it st
1c00: 6f 70 73 20 70 72 6f 63 65 73 73 69 6e 67 20 74 ops processing t
1c10: 68 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2e he command line.
1c20: 20 20 41 6e 79 20 73 75 62 73 65 71 75 65 6e 74 Any subsequent
1c30: 0a 20 20 20 20 6f 70 74 69 6f 6e 73 20 61 72 65 . options are
1c40: 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 20 60 passed to the `
1c50: 63 6f 6e 66 69 67 75 72 65 60 20 73 63 72 69 70 configure` scrip
1c60: 74 2e 20 53 65 65 0a 20 20 20 20 5b 52 45 41 44 t. See. [READ
1c70: 4d 45 2d 55 6e 69 78 2e 74 78 74 5d 5b 72 6d 75 ME-Unix.txt][rmu
1c80: 5d 20 66 6f 72 20 6d 6f 72 65 20 6f 6e 20 60 63 ] for more on `c
1c90: 6f 6e 66 69 67 75 72 65 60 20 73 63 72 69 70 74 onfigure` script
1ca0: 20 6f 70 74 69 6f 6e 73 2e 0a 0a 5b 62 66 5d 3a options...[bf]:
1cb0: 20 20 68 74 74 70 3a 2f 2f 62 61 6b 65 66 69 6c http://bakefil
1cc0: 65 2e 6f 72 67 2f 0a 5b 72 6d 75 5d 3a 20 68 74 e.org/.[rmu]: ht
1cd0: 74 70 73 3a 2f 2f 74 61 6e 67 65 6e 74 73 6f 66 tps://tangentsof
1ce0: 74 2e 63 6f 6d 2f 6d 79 73 71 6c 70 70 2f 66 69 t.com/mysqlpp/fi
1cf0: 6c 65 2f 52 45 41 44 4d 45 2d 55 6e 69 78 2e 74 le/README-Unix.t
1d00: 78 74 0a 0a 0a 23 23 20 42 6f 6f 74 73 74 72 61 xt...## Bootstra
1d10: 70 70 69 6e 67 20 74 68 65 20 4c 69 62 72 61 72 pping the Librar
1d20: 79 20 55 73 69 6e 67 20 4f 6e 6c 79 20 57 69 6e y Using Only Win
1d30: 64 6f 77 73 0a 0a 54 68 65 20 74 68 69 6e 67 20 dows..The thing
1d40: 74 68 61 74 20 6d 61 6b 65 73 20 62 6f 6f 74 73 that makes boots
1d50: 74 72 61 70 70 69 6e 67 20 6f 6e 20 57 69 6e 64 trapping on Wind
1d60: 6f 77 73 20 64 69 66 66 69 63 75 6c 74 20 69 73 ows difficult is
1d70: 20 74 68 61 74 20 6f 6e 65 20 6f 66 0a 74 68 65 that one of.the
1d80: 20 72 65 71 75 69 72 65 64 20 73 74 65 70 73 20 required steps
1d90: 75 73 65 73 20 61 20 55 6e 69 78 2d 63 65 6e 74 uses a Unix-cent
1da0: 72 69 63 20 74 6f 6f 6c 2c 20 60 61 75 74 6f 63 ric tool, `autoc
1db0: 6f 6e 66 60 2e 20 20 54 68 69 73 20 73 65 63 74 onf`. This sect
1dc0: 69 6f 6e 0a 69 73 20 61 62 6f 75 74 20 77 6f 72 ion.is about wor
1dd0: 6b 69 6e 67 20 6f 75 74 20 61 20 77 61 79 20 74 king out a way t
1de0: 6f 20 67 65 74 20 74 68 61 74 20 77 6f 72 6b 69 o get that worki
1df0: 6e 67 20 6f 6e 20 57 69 6e 64 6f 77 73 2c 20 6f ng on Windows, o
1e00: 72 20 61 76 6f 69 64 69 6e 67 0a 74 68 65 20 6e r avoiding.the n
1e10: 65 65 64 20 66 6f 72 20 69 74 2c 20 73 6f 20 79 eed for it, so y
1e20: 6f 75 20 63 61 6e 20 67 65 74 20 6f 6e 20 77 69 ou can get on wi
1e30: 74 68 20 68 61 63 6b 69 6e 67 20 6f 6e 20 4d 79 th hacking on My
1e40: 53 51 4c 2b 2b 20 6f 6e 20 57 69 6e 64 6f 77 73 SQL++ on Windows
1e50: 2e 0a 0a 54 68 65 20 74 68 69 6e 67 20 60 61 75 ...The thing `au
1e60: 74 6f 63 6f 6e 66 60 20 64 6f 65 73 20 74 68 61 toconf` does tha
1e70: 74 27 73 20 72 65 6c 65 76 61 6e 74 20 74 6f 20 t's relevant to
1e80: 57 69 6e 64 6f 77 73 20 62 75 69 6c 64 73 20 6f Windows builds o
1e90: 66 20 4d 79 53 51 4c 2b 2b 0a 69 73 20 74 68 61 f MySQL++.is tha
1ea0: 74 20 69 74 20 73 75 62 73 74 69 74 75 74 65 73 t it substitutes
1eb0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 4d 79 53 the current MyS
1ec0: 51 4c 2b 2b 20 76 65 72 73 69 6f 6e 20 6e 75 6d QL++ version num
1ed0: 62 65 72 20 69 6e 74 6f 20 73 65 76 65 72 61 6c ber into several
1ee0: 0a 73 6f 75 72 63 65 20 66 69 6c 65 73 2e 20 54 .source files. T
1ef0: 68 69 73 20 61 6c 6c 6f 77 73 20 75 73 20 74 6f his allows us to
1f00: 20 63 68 61 6e 67 65 20 74 68 65 20 76 65 72 73 change the vers
1f10: 69 6f 6e 20 6e 75 6d 62 65 72 20 69 6e 20 6a 75 ion number in ju
1f20: 73 74 20 6f 6e 65 0a 70 6c 61 63 65 20 e2 80 94 st one.place —
1f30: 20 60 63 6f 6e 66 69 67 75 72 65 2e 61 63 60 20 `configure.ac`
1f40: e2 80 94 20 61 6e 64 20 68 61 76 65 20 69 74 20 — and have it
1f50: 61 70 70 6c 69 65 64 20 74 6f 20 61 6c 6c 20 74 applied to all t
1f60: 68 65 73 65 20 6f 74 68 65 72 20 70 6c 61 63 65 hese other place
1f70: 73 2e 0a 55 6e 74 69 6c 20 79 6f 75 20 64 6f 20 s..Until you do
1f80: 74 68 69 73 20 73 74 65 70 2c 20 61 6e 20 46 6f this step, an Fo
1f90: 73 73 69 6c 20 63 68 65 63 6b 6f 75 74 20 6f 66 ssil checkout of
1fa0: 20 4d 79 53 51 4c 2b 2b 20 77 6f 6e 27 74 20 62 MySQL++ won't b
1fb0: 75 69 6c 64 2c 0a 62 65 63 61 75 73 65 20 74 68 uild,.because th
1fc0: 65 73 65 20 66 69 6c 65 73 20 77 69 74 68 20 74 ese files with t
1fd0: 68 65 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 he version numbe
1fe0: 72 73 20 69 6e 20 74 68 65 6d 20 77 6f 6e 27 74 rs in them won't
1ff0: 20 62 65 20 67 65 6e 65 72 61 74 65 64 2e 0a 0a be generated...
2000: 0a 23 23 23 20 4f 70 74 69 6f 6e 20 31 3a 20 43 .### Option 1: C
2010: 6f 70 79 20 74 68 65 20 67 65 6e 65 72 61 74 65 opy the generate
2020: 64 20 66 69 6c 65 73 20 6f 76 65 72 20 66 72 6f d files over fro
2030: 6d 20 61 20 72 65 6c 65 61 73 65 64 20 76 65 72 m a released ver
2040: 73 69 6f 6e 0a 0a 4f 6e 6c 79 20 6f 6e 65 20 6f sion..Only one o
2050: 66 20 74 68 65 73 65 20 67 65 6e 65 72 61 74 65 f these generate
2060: 64 20 66 69 6c 65 73 20 69 73 20 61 62 73 6f 6c d files is absol
2070: 75 74 65 6c 79 20 63 72 69 74 69 63 61 6c 20 74 utely critical t
2080: 6f 20 61 6c 6c 6f 77 69 6e 67 0a 4d 79 53 51 4c o allowing.MySQL
2090: 2b 2b 20 74 6f 20 62 75 69 6c 64 3a 20 60 6c 69 ++ to build: `li
20a0: 62 2f 6d 79 73 71 6c 2b 2b 2e 68 60 2e 20 53 6f b/mysql++.h`. So
20b0: 2c 20 74 68 65 20 73 69 6d 70 6c 65 73 74 20 6f , the simplest o
20c0: 70 74 69 6f 6e 20 79 6f 75 20 68 61 76 65 20 74 ption you have t
20d0: 6f 0a 62 6f 6f 74 73 74 72 61 70 20 4d 79 53 51 o.bootstrap MySQ
20e0: 4c 2b 2b 20 65 6e 74 69 72 65 6c 79 20 6f 6e 20 L++ entirely on
20f0: 57 69 6e 64 6f 77 73 20 69 73 20 74 6f 20 63 6f Windows is to co
2100: 70 79 20 60 6c 69 62 2f 6d 79 73 71 6c 2b 2b 2e py `lib/mysql++.
2110: 68 60 20 6f 76 65 72 0a 66 72 6f 6d 20 61 20 72 h` over.from a r
2120: 65 6c 65 61 73 65 64 20 76 65 72 73 69 6f 6e 20 eleased version
2130: 6f 66 20 4d 79 53 51 4c 2b 2b 2e 20 57 68 69 6c of MySQL++. Whil
2140: 65 20 79 6f 75 27 72 65 20 64 6f 69 6e 67 20 74 e you're doing t
2150: 68 61 74 2c 20 79 6f 75 20 6d 69 67 68 74 0a 63 hat, you might.c
2160: 6f 70 79 20 6f 76 65 72 20 74 68 65 20 6f 74 68 opy over the oth
2170: 65 72 20 73 75 63 68 20 67 65 6e 65 72 61 74 65 er such generate
2180: 64 20 66 69 6c 65 73 3a 0a 0a 20 20 20 20 69 6e d files:.. in
2190: 73 74 61 6c 6c 2e 68 74 61 0a 20 20 20 20 6d 79 stall.hta. my
21a0: 73 71 6c 2b 2b 2e 73 70 65 63 0a 20 20 20 20 64 sql++.spec. d
21b0: 6f 63 2f 75 73 65 72 6d 61 6e 2f 75 73 65 72 6d oc/userman/userm
21c0: 61 6e 2e 64 62 78 0a 20 20 20 20 6c 69 62 2f 44 an.dbx. lib/D
21d0: 6f 78 79 66 69 6c 65 0a 0a 48 61 76 69 6e 67 20 oxyfile..Having
21e0: 64 6f 6e 65 20 74 68 61 74 2c 20 79 6f 75 20 63 done that, you c
21f0: 61 6e 20 63 6f 6d 70 6c 65 74 65 20 74 68 65 20 an complete the
2200: 62 6f 6f 74 73 74 72 61 70 70 69 6e 67 20 70 72 bootstrapping pr
2210: 6f 63 65 73 73 20 62 79 20 72 75 6e 6e 69 6e 67 ocess by running
2220: 0a 60 62 6f 6f 74 73 74 72 61 70 2e 62 61 74 60 .`bootstrap.bat`
2230: 2e 20 49 74 20 68 61 73 20 74 68 65 20 73 61 6d . It has the sam
2240: 65 20 70 75 72 70 6f 73 65 20 61 73 20 74 68 65 e purpose as the
2250: 20 42 6f 75 72 6e 65 20 73 68 65 6c 6c 20 73 63 Bourne shell sc
2260: 72 69 70 74 0a 64 65 73 63 72 69 62 65 64 20 61 ript.described a
2270: 62 6f 76 65 2c 20 62 75 74 20 6d 75 63 68 20 73 bove, but much s
2280: 69 6d 70 6c 65 72 2e 20 49 74 20 68 61 73 20 6e impler. It has n
2290: 6f 6e 65 20 6f 66 20 74 68 65 20 63 6f 6d 6d 61 one of the comma
22a0: 6e 64 20 6c 69 6e 65 0a 6f 70 74 69 6f 6e 73 20 nd line.options
22b0: 64 65 73 63 72 69 62 65 64 20 61 62 6f 76 65 2c described above,
22c0: 20 66 6f 72 20 6f 6e 65 20 74 68 69 6e 67 2e 0a for one thing..
22d0: 0a 54 68 65 20 6d 61 69 6e 20 64 6f 77 6e 73 69 .The main downsi
22e0: 64 65 20 6f 66 20 64 6f 69 6e 67 20 69 74 20 74 de of doing it t
22f0: 68 69 73 20 77 61 79 20 69 73 20 74 68 61 74 20 his way is that
2300: 79 6f 75 72 20 63 68 61 6e 67 65 64 20 76 65 72 your changed ver
2310: 73 69 6f 6e 20 77 69 6c 6c 0a 68 61 76 65 20 74 sion will.have t
2320: 68 65 20 73 61 6d 65 20 76 65 72 73 69 6f 6e 20 he same version
2330: 6e 75 6d 62 65 72 20 61 73 20 74 68 65 20 72 65 number as the re
2340: 6c 65 61 73 65 20 6f 66 20 4d 79 53 51 4c 2b 2b lease of MySQL++
2350: 20 79 6f 75 20 63 6f 70 69 65 64 20 74 68 65 0a you copied the.
2360: 66 69 6c 65 73 20 66 72 6f 6d 2c 20 75 6e 6c 65 files from, unle
2370: 73 73 20 79 6f 75 20 67 6f 20 69 6e 74 6f 20 65 ss you go into e
2380: 61 63 68 20 66 69 6c 65 20 61 6e 64 20 63 68 61 ach file and cha
2390: 6e 67 65 20 74 68 65 20 76 65 72 73 69 6f 6e 20 nge the version
23a0: 6e 75 6d 62 65 72 73 2e 0a 0a 0a 23 23 23 20 4f numbers....### O
23b0: 70 74 69 6f 6e 20 32 3a 20 43 79 67 77 69 6e 0a ption 2: Cygwin.
23c0: 0a 49 66 20 79 6f 75 27 64 20 6c 69 6b 65 20 74 .If you'd like t
23d0: 6f 20 68 61 63 6b 20 6f 6e 20 4d 79 53 51 4c 2b o hack on MySQL+
23e0: 2b 20 65 6e 74 69 72 65 6c 79 20 6f 6e 20 57 69 + entirely on Wi
23f0: 6e 64 6f 77 73 20 61 6e 64 20 68 61 76 65 20 61 ndows and have a
2400: 6c 6c 20 74 68 65 0a 62 75 69 6c 64 20 66 72 65 ll the.build fre
2410: 65 64 6f 6d 73 20 65 6e 6a 6f 79 65 64 20 62 79 edoms enjoyed by
2420: 20 74 68 6f 73 65 20 77 6f 72 6b 69 6e 67 20 6f those working o
2430: 6e 20 55 6e 69 78 79 20 70 6c 61 74 66 6f 72 6d n Unixy platform
2440: 73 2c 20 74 68 65 20 73 69 6d 70 6c 65 73 74 0a s, the simplest.
2450: 73 6f 6c 75 74 69 6f 6e 20 69 73 20 70 72 6f 62 solution is prob
2460: 61 62 6c 79 20 74 6f 20 5b 69 6e 73 74 61 6c 6c ably to [install
2470: 20 43 79 67 77 69 6e 5d 5b 63 79 67 36 34 5d 2e Cygwin][cyg64].
2480: 20 28 36 34 2d 62 69 74 2e 20 41 20 5b 33 32 2d (64-bit. A [32-
2490: 62 69 74 0a 69 6e 73 74 61 6c 6c 65 72 5d 5b 63 bit.installer][c
24a0: 79 67 33 32 5d 20 69 73 20 61 6c 73 6f 20 61 76 yg32] is also av
24b0: 61 69 6c 61 62 6c 65 2e 29 0a 0a 57 68 65 6e 20 ailable.)..When
24c0: 79 6f 75 20 72 75 6e 20 69 74 2c 20 69 74 20 77 you run it, it w
24d0: 69 6c 6c 20 77 61 6c 6b 20 79 6f 75 20 74 68 72 ill walk you thr
24e0: 6f 75 67 68 20 74 68 65 20 73 74 65 70 73 20 74 ough the steps t
24f0: 6f 20 69 6e 73 74 61 6c 6c 20 43 79 67 77 69 6e o install Cygwin
2500: 2e 0a 41 75 74 6f 63 6f 6e 66 20 61 6e 64 20 50 ..Autoconf and P
2510: 65 72 6c 20 35 20 61 72 65 6e 27 74 20 69 6e 73 erl 5 aren't ins
2520: 74 61 6c 6c 65 64 20 69 6e 20 43 79 67 77 69 6e talled in Cygwin
2530: 20 62 79 20 64 65 66 61 75 6c 74 2c 20 73 6f 20 by default, so
2540: 77 68 65 6e 20 79 6f 75 0a 67 65 74 20 74 6f 20 when you.get to
2550: 74 68 65 20 70 61 63 6b 61 67 65 73 20 6c 69 73 the packages lis
2560: 74 2c 20 62 65 20 73 75 72 65 20 74 6f 20 73 65 t, be sure to se
2570: 6c 65 63 74 20 74 68 65 6d 2e 20 41 75 74 6f 63 lect them. Autoc
2580: 6f 6e 66 20 69 73 20 69 6e 20 74 68 65 0a 44 65 onf is in the.De
2590: 76 65 6c 20 63 61 74 65 67 6f 72 79 2c 20 61 6e vel category, an
25a0: 64 20 50 65 72 6c 20 35 20 69 6e 20 74 68 65 20 d Perl 5 in the
25b0: 49 6e 74 65 72 70 72 65 74 65 72 73 20 63 61 74 Interpreters cat
25c0: 65 67 6f 72 79 2e 0a 0a 59 6f 75 20 77 69 6c 6c egory...You will
25d0: 20 61 6c 73 6f 20 6e 65 65 64 20 74 6f 20 69 6e also need to in
25e0: 73 74 61 6c 6c 20 74 68 65 20 6e 61 74 69 76 65 stall the native
25f0: 20 57 69 6e 64 6f 77 73 20 62 69 6e 61 72 79 20 Windows binary
2600: 76 65 72 73 69 6f 6e 20 6f 66 0a 5b 42 61 6b 65 version of.[Bake
2610: 66 69 6c 65 5d 28 68 74 74 70 3a 2f 2f 62 61 6b file](http://bak
2620: 65 66 69 6c 65 2e 6f 72 67 2f 29 2e 20 20 44 6f efile.org/). Do
2630: 6e 27 74 20 67 65 74 20 74 68 65 20 73 6f 75 72 n't get the sour
2640: 63 65 20 76 65 72 73 69 6f 6e 20 61 6e 64 20 74 ce version and t
2650: 72 79 0a 74 6f 20 62 75 69 6c 64 20 42 61 6b 65 ry.to build Bake
2660: 66 69 6c 65 20 75 6e 64 65 72 20 43 79 67 77 69 file under Cygwi
2670: 6e 3b 20 69 74 20 77 6f 6e 27 74 20 77 6f 72 6b n; it won't work
2680: 2e 20 54 68 65 20 57 69 6e 64 6f 77 73 20 62 69 . The Windows bi
2690: 6e 61 72 79 0a 76 65 72 73 69 6f 6e 20 6f 66 20 nary.version of
26a0: 42 61 6b 65 66 69 6c 65 20 69 6e 63 6c 75 64 65 Bakefile include
26b0: 73 20 61 6e 20 65 6d 62 65 64 64 65 64 20 76 65 s an embedded ve
26c0: 72 73 69 6f 6e 20 6f 66 20 50 79 74 68 6f 6e 2c rsion of Python,
26d0: 20 73 6f 20 79 6f 75 20 77 6f 6e 27 74 0a 6e 65 so you won't.ne
26e0: 65 64 20 74 6f 20 69 6e 73 74 61 6c 6c 20 43 79 ed to install Cy
26f0: 67 77 69 6e 27 73 20 50 79 74 68 6f 6e 2e 0a 0a gwin's Python...
2700: 48 61 76 69 6e 67 20 64 6f 6e 65 20 61 6c 6c 20 Having done all
2710: 74 68 69 73 2c 20 79 6f 75 20 63 61 6e 20 66 6f this, you can fo
2720: 6c 6c 6f 77 20 74 68 65 20 55 6e 69 78 20 62 6f llow the Unix bo
2730: 6f 74 73 74 72 61 70 70 69 6e 67 0a 69 6e 73 74 otstrapping.inst
2740: 72 75 63 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 ructions in the
2750: 70 72 65 76 69 6f 75 73 20 73 65 63 74 69 6f 6e previous section
2760: 2e 0a 0a 5b 63 79 67 33 32 5d 3a 20 68 74 74 70 ...[cyg32]: http
2770: 3a 2f 2f 63 79 67 77 69 6e 2e 63 6f 6d 2f 73 65 ://cygwin.com/se
2780: 74 75 70 2d 78 38 36 2e 65 78 65 0a 5b 63 79 67 tup-x86.exe.[cyg
2790: 36 34 5d 3a 20 68 74 74 70 3a 2f 2f 63 79 67 77 64]: http://cygw
27a0: 69 6e 2e 63 6f 6d 2f 73 65 74 75 70 2d 78 38 36 in.com/setup-x86
27b0: 5f 36 34 2e 65 78 65 0a 0a 0a 23 23 23 20 4f 70 _64.exe...### Op
27c0: 74 69 6f 6e 20 33 3a 20 5b 22 48 65 72 65 27 73 tion 3: ["Here's
27d0: 20 61 20 6e 69 63 6b 65 6c 2c 20 6b 69 64 2c 20 a nickel, kid,
27e0: 67 65 74 20 79 6f 75 72 73 65 6c 66 20 61 20 62 get yourself a b
27f0: 65 74 74 65 72 20 63 6f 6d 70 75 74 65 72 2e 22 etter computer."
2800: 5d 5b 64 63 5d 0a 0a 46 69 6e 61 6c 6c 79 2c 20 ][dc]..Finally,
2810: 79 6f 75 20 6d 69 67 68 74 20 68 61 76 65 20 61 you might have a
2820: 63 63 65 73 73 20 74 6f 20 61 20 55 6e 69 78 79 ccess to a Unixy
2830: 20 73 79 73 74 65 6d 2c 20 6f 72 20 74 68 65 20 system, or the
2840: 61 62 69 6c 69 74 79 20 74 6f 20 73 65 74 0a 6f ability to set.o
2850: 6e 65 20 75 70 2e 20 59 6f 75 20 64 6f 6e 27 74 ne up. You don't
2860: 20 65 76 65 6e 20 6e 65 65 64 20 61 20 73 65 70 even need a sep
2870: 61 72 61 74 65 20 70 68 79 73 69 63 61 6c 20 63 arate physical c
2880: 6f 6d 70 75 74 65 72 2c 20 6e 6f 77 20 74 68 61 omputer, now tha
2890: 74 0a 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e t.virtual machin
28a0: 65 20 74 65 63 68 6f 6c 6f 67 79 20 69 73 20 66 e techology is f
28b0: 72 65 65 2e 0a 0a 47 69 76 65 6e 20 73 75 63 68 ree...Given such
28c0: 20 61 20 6d 61 63 68 69 6e 65 2c 20 79 6f 75 27 a machine, you'
28d0: 64 20 64 6f 20 74 68 65 20 46 6f 73 73 69 6c 20 d do the Fossil
28e0: 63 68 65 63 6b 6f 75 74 20 6f 66 20 4d 79 53 51 checkout of MySQ
28f0: 4c 2b 2b 20 6f 6e 20 74 68 61 74 0a 6d 61 63 68 L++ on that.mach
2900: 69 6e 65 2c 20 74 68 65 6e 20 62 6f 6f 74 73 74 ine, then bootst
2910: 72 61 70 20 69 74 20 74 68 65 72 65 20 75 73 69 rap it there usi
2920: 6e 67 20 74 68 65 20 69 6e 73 74 72 75 63 74 69 ng the instructi
2930: 6f 6e 73 20 69 6e 20 74 68 65 20 70 72 65 76 69 ons in the previ
2940: 6f 75 73 0a 73 65 63 74 69 6f 6e 2c 20 61 6e 64 ous.section, and
2950: 20 63 6f 70 79 20 74 68 65 20 67 65 6e 65 72 61 copy the genera
2960: 74 65 64 20 66 69 6c 65 73 20 62 61 63 6b 20 74 ted files back t
2970: 6f 20 74 68 65 20 57 69 6e 64 6f 77 73 20 62 6f o the Windows bo
2980: 78 2e 0a 0a 5b 64 63 5d 3a 20 68 74 74 70 3a 2f x...[dc]: http:/
2990: 2f 74 6f 6d 61 79 6b 6f 2e 63 6f 6d 2f 77 72 69 /tomayko.com/wri
29a0: 74 69 6e 67 73 2f 74 68 61 74 2d 64 69 6c 62 65 tings/that-dilbe
29b0: 72 74 2d 63 61 72 74 6f 6f 6e 0a 0a 0a 23 23 20 rt-cartoon...##
29c0: 4f 6e 20 4d 61 6e 69 70 75 6c 61 74 69 6e 67 20 On Manipulating
29d0: 74 68 65 20 42 75 69 6c 64 20 53 79 73 74 65 6d the Build System
29e0: 20 53 6f 75 72 63 65 20 46 69 6c 65 73 0a 0a 4f Source Files..O
29f0: 6e 65 20 6f 66 20 74 68 65 20 74 68 69 6e 67 73 ne of the things
2a00: 20 74 68 65 20 62 6f 6f 74 73 74 72 61 70 70 69 the bootstrappi
2a10: 6e 67 20 73 79 73 74 65 6d 20 64 65 73 63 72 69 ng system descri
2a20: 62 65 64 20 61 62 6f 76 65 0a 64 6f 65 73 20 69 bed above.does i
2a30: 73 20 70 72 6f 64 75 63 65 73 20 76 61 72 69 6f s produces vario
2a40: 75 73 20 74 79 70 65 73 20 6f 66 20 70 72 6f 6a us types of proj
2a50: 65 63 74 20 61 6e 64 20 6d 61 6b 65 20 66 69 6c ect and make fil
2a60: 65 73 20 66 72 6f 6d 20 61 0a 73 6d 61 6c 6c 20 es from a.small
2a70: 6e 75 6d 62 65 72 20 6f 66 20 73 6f 75 72 63 65 number of source
2a80: 20 66 69 6c 65 73 2e 20 54 68 69 73 20 73 79 73 files. This sys
2a90: 74 65 6d 20 6c 65 74 73 20 75 73 20 73 75 70 70 tem lets us supp
2aa0: 6f 72 74 20 6d 61 6e 79 0a 70 6c 61 74 66 6f 72 ort many.platfor
2ab0: 6d 73 20 77 69 74 68 6f 75 74 20 68 61 76 69 6e ms without havin
2ac0: 67 20 74 6f 20 6d 61 69 6e 74 61 69 6e 20 73 65 g to maintain se
2ad0: 70 61 72 61 74 65 20 62 75 69 6c 64 20 73 79 73 parate build sys
2ae0: 74 65 6d 20 66 69 6c 65 73 0a 66 6f 72 20 65 61 tem files.for ea
2af0: 63 68 20 70 6c 61 74 66 6f 72 6d 2e 0a 0a 5b 42 ch platform...[B
2b00: 61 6b 65 66 69 6c 65 5d 28 68 74 74 70 3a 2f 2f akefile](http://
2b10: 62 61 6b 65 66 69 6c 65 2e 6f 72 67 2f 29 20 70 bakefile.org/) p
2b20: 72 6f 64 75 63 65 73 20 6d 6f 73 74 20 6f 66 20 roduces most of
2b30: 74 68 65 73 65 20 70 72 6f 6a 65 63 74 20 61 6e these project an
2b40: 64 20 6d 61 6b 65 0a 66 69 6c 65 73 20 66 72 6f d make.files fro
2b50: 6d 20 61 20 73 69 6e 67 6c 65 20 73 6f 75 72 63 m a single sourc
2b60: 65 20 66 69 6c 65 20 63 61 6c 6c 65 64 20 5b 60 e file called [`
2b70: 6d 79 73 71 6c 2b 2b 2e 62 6b 6c 60 5d 5b 62 6b mysql++.bkl`][bk
2b80: 6c 5d 2e 0a 0a 45 78 63 65 70 74 20 66 6f 72 20 l]...Except for
2b90: 73 6d 61 6c 6c 20 6c 6f 63 61 6c 20 63 68 61 6e small local chan
2ba0: 67 65 73 2c 20 69 74 27 73 20 62 65 73 74 20 74 ges, it's best t
2bb0: 6f 20 63 68 61 6e 67 65 20 60 6d 79 73 71 6c 2b o change `mysql+
2bc0: 2b 2e 62 6b 6c 60 20 61 6e 64 0a 22 72 65 2d 62 +.bkl` and."re-b
2bd0: 61 6b 65 22 20 74 68 65 20 70 72 6f 6a 65 63 74 ake" the project
2be0: 20 61 6e 64 20 6d 61 6b 65 20 66 69 6c 65 73 20 and make files
2bf0: 72 61 74 68 65 72 20 74 68 61 6e 20 63 68 61 6e rather than chan
2c00: 67 65 20 74 68 6f 73 65 20 66 69 6c 65 73 0a 64 ge those files.d
2c10: 69 72 65 63 74 6c 79 2e 20 59 6f 75 20 63 61 6e irectly. You can
2c20: 20 64 6f 20 74 68 69 73 20 77 69 74 68 20 74 68 do this with th
2c30: 65 20 62 6f 6f 74 73 74 72 61 70 20 73 63 72 69 e bootstrap scri
2c40: 70 74 73 20 63 6f 76 65 72 65 64 20 61 62 6f 76 pts covered abov
2c50: 65 2e 20 4f 6e 0a 57 69 6e 64 6f 77 73 2c 20 69 e. On.Windows, i
2c60: 66 20 61 6c 6c 20 79 6f 75 27 76 65 20 63 68 61 f all you've cha
2c70: 6e 67 65 64 20 69 73 20 60 6d 79 73 71 6c 2b 2b nged is `mysql++
2c80: 2e 62 6b 6c 60 2c 20 79 6f 75 20 63 61 6e 20 75 .bkl`, you can u
2c90: 73 65 0a 60 72 65 62 61 6b 65 2e 62 61 74 60 20 se.`rebake.bat`
2ca0: 69 6e 73 74 65 61 64 2c 20 77 68 69 63 68 20 64 instead, which d
2cb0: 6f 65 73 6e 27 74 20 74 72 79 20 74 6f 20 64 6f oesn't try to do
2cc0: 20 61 73 20 6d 75 63 68 20 61 73 0a 60 62 6f 6f as much as.`boo
2cd0: 74 73 74 72 61 70 2e 62 61 74 60 2e 0a 0a 42 61 tstrap.bat`...Ba
2ce0: 6b 65 66 69 6c 65 20 70 72 6f 64 75 63 65 73 20 kefile produces
2cf0: 66 69 6e 69 73 68 65 64 20 70 72 6f 6a 65 63 74 finished project
2d00: 20 66 69 6c 65 73 20 66 6f 72 20 56 69 73 75 61 files for Visua
2d10: 6c 20 43 2b 2b 20 61 6e 64 20 58 63 6f 64 65 20 l C++ and Xcode
2d20: 61 6e 64 0a 66 69 6e 69 73 68 65 64 20 60 4d 61 and.finished `Ma
2d30: 6b 65 66 69 6c 65 73 60 20 66 6f 72 20 4d 69 6e kefiles` for Min
2d40: 47 57 2e 20 49 74 20 61 6c 73 6f 20 70 72 6f 64 GW. It also prod
2d50: 75 63 65 73 20 60 4d 61 6b 65 66 69 6c 65 2e 69 uces `Makefile.i
2d60: 6e 60 2c 20 77 68 69 63 68 20 69 73 0a 69 6e 70 n`, which is.inp
2d70: 75 74 20 74 6f 20 47 4e 55 20 41 75 74 6f 63 6f ut to GNU Autoco
2d80: 6e 66 20 61 6c 6f 6e 67 20 77 69 74 68 20 63 6f nf along with co
2d90: 6e 66 69 67 75 72 65 2e 61 63 20 61 6e 64 20 60 nfigure.ac and `
2da0: 63 6f 6e 66 69 67 2f 2a 60 2e 20 59 6f 75 20 6d config/*`. You m
2db0: 61 79 0a 6e 65 65 64 20 74 6f 20 63 68 61 6e 67 ay.need to chang
2dc0: 65 20 74 68 65 73 65 20 6c 61 74 74 65 72 20 66 e these latter f
2dd0: 69 6c 65 73 20 69 6e 20 61 64 64 69 74 69 6f 6e iles in addition
2de0: 20 74 6f 20 6f 72 20 69 6e 73 74 65 61 64 20 6f to or instead o
2df0: 66 0a 60 6d 79 73 71 6c 2b 2b 2e 62 6b 6c 60 20 f.`mysql++.bkl`
2e00: 74 6f 20 67 65 74 20 74 68 65 20 65 66 66 65 63 to get the effec
2e10: 74 20 79 6f 75 20 77 61 6e 74 2e 20 20 52 75 6e t you want. Run
2e20: 6e 69 6e 67 20 62 6f 6f 74 73 74 72 61 70 0a 69 ning bootstrap.i
2e30: 6e 63 6f 72 70 6f 72 61 74 65 73 20 63 68 61 6e ncorporates chan
2e40: 67 65 73 20 74 6f 20 61 6c 6c 20 6f 66 20 74 68 ges to all of th
2e50: 65 73 65 20 66 69 6c 65 73 20 69 6e 20 74 68 65 ese files in the
2e60: 20 47 4e 55 20 41 75 74 6f 63 6f 6e 66 20 6f 75 GNU Autoconf ou
2e70: 74 70 75 74 2e 0a 0a 57 68 69 6c 65 20 42 61 6b tput...While Bak
2e80: 65 66 69 6c 65 27 73 20 64 6f 63 75 6d 65 6e 74 efile's document
2e90: 61 74 69 6f 6e 20 69 73 6e 27 74 20 61 73 20 63 ation isn't as c
2ea0: 6f 6d 70 72 65 68 65 6e 73 69 76 65 20 61 73 20 omprehensive as
2eb0: 69 74 0a 6f 75 67 68 74 20 74 6f 20 62 65 2c 20 it.ought to be,
2ec0: 79 6f 75 20 63 61 6e 20 61 74 20 6c 65 61 73 74 you can at least
2ed0: 20 63 6f 75 6e 74 20 6f 6e 20 69 74 20 74 6f 20 count on it to
2ee0: 6c 69 73 74 20 61 6c 6c 20 6f 66 20 74 68 65 0a list all of the.
2ef0: 61 76 61 69 6c 61 62 6c 65 20 66 65 61 74 75 72 available featur
2f00: 65 73 2e 20 53 6f 2c 20 69 66 20 79 6f 75 20 63 es. So, if you c
2f10: 61 6e 27 74 20 73 65 65 20 61 20 77 61 79 20 74 an't see a way t
2f20: 6f 20 6d 61 6b 65 20 42 61 6b 65 66 69 6c 65 0a o make Bakefile.
2f30: 64 6f 20 73 6f 6d 65 74 68 69 6e 67 2c 20 69 74 do something, it
2f40: 27 73 20 6c 69 6b 65 6c 79 20 69 74 20 6a 75 73 's likely it jus
2f50: 74 20 63 61 6e 27 74 20 64 6f 20 69 74 2e 20 42 t can't do it. B
2f60: 61 6b 65 66 69 6c 65 20 69 73 20 61 0a 68 69 67 akefile is a.hig
2f70: 68 2d 6c 65 76 65 6c 20 61 62 73 74 72 61 63 74 h-level abstract
2f80: 69 6f 6e 20 6f 66 20 62 75 69 6c 64 20 73 79 73 ion of build sys
2f90: 74 65 6d 73 20 69 6e 20 67 65 6e 65 72 61 6c 2c tems in general,
2fa0: 20 73 6f 20 69 74 27 6c 6c 20 6e 65 76 65 72 0a so it'll never.
2fb0: 73 75 70 70 6f 72 74 20 61 6c 6c 20 74 68 65 20 support all the
2fc0: 70 61 72 74 69 63 75 6c 61 72 73 20 6f 66 20 65 particulars of e
2fd0: 76 65 72 79 20 6f 64 64 20 62 75 69 6c 64 20 73 very odd build s
2fe0: 79 73 74 65 6d 20 6f 75 74 20 74 68 65 72 65 2e ystem out there.
2ff0: 0a 0a 5b 62 6b 6c 5d 3a 20 68 74 74 70 73 3a 2f ..[bkl]: https:/
3000: 2f 74 61 6e 67 65 6e 74 73 6f 66 74 2e 63 6f 6d /tangentsoft.com
3010: 2f 6d 79 73 71 6c 70 70 2f 66 69 6c 65 2f 6d 79 /mysqlpp/file/my
3020: 73 71 6c 25 32 42 25 32 42 2e 62 6b 6c 0a 0a 0a sql%2B%2B.bkl...
3030: 23 23 20 53 75 62 6d 69 74 74 69 6e 67 20 50 61 ## Submitting Pa
3040: 74 63 68 65 73 0a 0a 49 66 20 79 6f 75 20 77 69 tches..If you wi
3050: 73 68 20 74 6f 20 73 75 62 6d 69 74 20 61 20 70 sh to submit a p
3060: 61 74 63 68 20 74 6f 20 74 68 65 20 6c 69 62 72 atch to the libr
3070: 61 72 79 2c 20 70 6c 65 61 73 65 20 73 65 6e 64 ary, please send
3080: 20 69 74 20 74 6f 20 74 68 65 0a 5b 4d 79 53 51 it to the.[MySQ
3090: 4c 2b 2b 20 6d 61 69 6c 69 6e 67 20 6c 69 73 74 L++ mailing list
30a0: 5d 5b 6d 6c 5d 2e 20 20 57 65 20 77 61 6e 74 20 ][ml]. We want
30b0: 70 61 74 63 68 65 73 20 69 6e 20 75 6e 69 66 69 patches in unifi
30c0: 65 64 20 64 69 66 66 20 66 6f 72 6d 61 74 2e 0a ed diff format..
30d0: 0a 57 65 20 77 69 6c 6c 20 61 6c 73 6f 20 61 63 .We will also ac
30e0: 63 65 70 74 20 74 72 69 76 69 61 6c 20 70 61 74 cept trivial pat
30f0: 63 68 65 73 20 6e 6f 74 20 6e 65 65 64 69 6e 67 ches not needing
3100: 20 64 69 73 63 75 73 73 69 6f 6e 20 61 73 20 74 discussion as t
3110: 65 78 74 0a 69 6e 20 61 20 46 6f 73 73 69 6c 20 ext.in a Fossil
3120: 74 69 63 6b 65 74 2e 0a 0a 54 68 65 20 65 61 73 ticket...The eas
3130: 69 65 73 74 20 77 61 79 20 74 6f 20 67 65 74 20 iest way to get
3140: 61 20 75 6e 69 66 69 65 64 20 64 69 66 66 20 69 a unified diff i
3150: 73 20 74 6f 20 63 68 65 63 6b 20 6f 75 74 20 61 s to check out a
3160: 20 63 6f 70 79 20 6f 66 20 74 68 65 0a 63 75 72 copy of the.cur
3170: 72 65 6e 74 20 4d 79 53 51 4c 2b 2b 20 74 72 65 rent MySQL++ tre
3180: 65 20 61 73 20 64 65 73 63 72 69 62 65 64 20 61 e as described a
3190: 62 6f 76 65 2e 20 54 68 65 6e 20 6d 61 6b 65 20 bove. Then make
31a0: 79 6f 75 72 20 63 68 61 6e 67 65 2c 20 60 63 64 your change, `cd
31b0: 60 0a 74 6f 20 74 68 65 20 4d 79 53 51 4c 2b 2b `.to the MySQL++
31c0: 20 72 6f 6f 74 20 64 69 72 65 63 74 6f 72 79 2c root directory,
31d0: 20 61 6e 64 20 61 73 6b 20 46 6f 73 73 69 6c 20 and ask Fossil
31e0: 74 6f 20 67 65 6e 65 72 61 74 65 20 74 68 65 20 to generate the
31f0: 70 61 74 63 68 0a 66 6f 72 20 79 6f 75 3a 0a 0a patch.for you:..
3200: 20 20 20 20 24 20 66 6f 73 73 69 6c 20 64 69 66 $ fossil dif
3210: 66 20 3e 20 6d 79 63 68 61 6e 67 65 2e 70 61 74 f > mychange.pat
3220: 63 68 0a 0a 49 66 20 79 6f 75 72 20 70 61 74 63 ch..If your patc
3230: 68 20 61 64 64 73 20 6e 65 77 20 66 69 6c 65 73 h adds new files
3240: 2c 20 6d 6f 76 65 73 20 66 69 6c 65 73 2c 20 6f , moves files, o
3250: 72 20 6e 65 65 64 73 20 74 6f 20 62 65 20 75 6e r needs to be un
3260: 64 65 72 73 74 6f 6f 64 20 69 6e 0a 74 65 72 6d derstood in.term
3270: 73 20 6f 66 20 6d 75 6c 74 69 70 6c 65 20 63 68 s of multiple ch
3280: 65 63 6b 69 6e 73 2c 20 69 74 27 73 20 62 65 73 eckins, it's bes
3290: 74 20 74 6f 20 64 6f 20 74 68 61 74 20 77 6f 72 t to do that wor
32a0: 6b 20 6f 6e 20 61 20 5b 70 72 69 76 61 74 65 0a k on a [private.
32b0: 6c 6f 63 61 6c 20 62 72 61 6e 63 68 5d 5b 70 62 local branch][pb
32c0: 72 5d 2c 20 74 68 65 6e 20 73 65 6e 64 20 61 20 r], then send a
32d0: 5b 62 75 6e 64 6c 65 5d 5b 66 62 5d 20 69 6e 73 [bundle][fb] ins
32e0: 74 65 61 64 20 6f 66 20 61 20 70 61 74 63 68 2e tead of a patch.
32f0: 0a 0a 49 66 20 79 6f 75 27 76 65 20 73 65 6e 74 ..If you've sent
3300: 20 70 61 74 63 68 65 73 20 74 6f 20 4d 79 53 51 patches to MySQ
3310: 4c 2b 2b 20 62 65 66 6f 72 65 20 61 6e 64 20 64 L++ before and d
3320: 6f 6e 27 74 20 68 61 76 65 20 61 20 46 6f 73 73 on't have a Foss
3330: 69 6c 0a 64 65 76 65 6c 6f 70 65 72 20 6c 6f 67 il.developer log
3340: 69 6e 2c 20 61 6e 6f 74 68 65 72 20 61 6c 74 65 in, another alte
3350: 72 6e 61 74 69 76 65 20 69 73 20 74 6f 20 61 73 rnative is to as
3360: 6b 20 66 6f 72 20 61 20 6c 6f 67 69 6e 20 62 65 k for a login be
3370: 66 6f 72 65 20 79 6f 75 0a 62 65 67 69 6e 20 77 fore you.begin w
3380: 6f 72 6b 20 73 6f 20 74 68 61 74 20 79 6f 75 72 ork so that your
3390: 20 63 68 61 6e 67 65 73 20 61 72 65 20 61 75 74 changes are aut
33a0: 6f 6d 61 74 69 63 61 6c 6c 79 20 73 79 6e 63 27 omatically sync'
33b0: 64 20 74 6f 20 74 68 65 20 6d 61 69 6e 0a 46 6f d to the main.Fo
33c0: 73 73 69 6c 20 72 65 70 6f 73 69 74 6f 72 79 20 ssil repository
33d0: 61 73 20 79 6f 75 20 77 6f 72 6b 2c 20 73 6f 20 as you work, so
33e0: 79 6f 75 20 64 6f 6e 27 74 20 68 61 76 65 20 74 you don't have t
33f0: 6f 20 73 65 6e 64 20 62 75 6e 64 6c 65 73 20 6f o send bundles o
3400: 72 0a 70 61 74 63 68 20 66 69 6c 65 73 2e 20 57 r.patch files. W
3410: 65 20 67 65 6e 65 72 61 6c 6c 79 20 64 6f 6e 27 e generally don'
3420: 74 20 72 65 66 75 73 65 20 73 75 63 68 20 72 65 t refuse such re
3430: 71 75 65 73 74 73 20 69 66 20 79 6f 75 27 76 65 quests if you've
3440: 20 61 6c 72 65 61 64 79 0a 70 72 6f 76 65 6e 20 already.proven
3450: 79 6f 75 72 20 61 62 69 6c 69 74 79 20 74 6f 20 your ability to
3460: 77 6f 72 6b 20 77 65 6c 6c 20 77 69 74 68 20 74 work well with t
3470: 68 65 20 4d 79 53 51 4c 2b 2b 20 70 72 6f 6a 65 he MySQL++ proje
3480: 63 74 2e 0a 0a 49 66 20 79 6f 75 27 72 65 20 6d ct...If you're m
3490: 61 6b 69 6e 67 20 61 20 70 61 74 63 68 20 61 67 aking a patch ag
34a0: 61 69 6e 73 74 20 61 20 4d 79 53 51 4c 2b 2b 20 ainst a MySQL++
34b0: 64 69 73 74 72 69 62 75 74 69 6f 6e 20 74 61 72 distribution tar
34c0: 62 61 6c 6c 2c 20 74 68 65 6e 0a 79 6f 75 20 63 ball, then.you c
34d0: 61 6e 20 67 65 6e 65 72 61 74 65 20 61 20 70 61 an generate a pa
34e0: 74 63 68 20 74 68 69 73 20 77 61 79 3a 0a 0a 20 tch this way:..
34f0: 20 20 20 24 20 64 69 66 66 20 2d 72 75 4e 20 6d $ diff -ruN m
3500: 79 73 71 6c 2b 2b 2d 6f 6c 64 64 69 72 20 6d 79 ysql++-olddir my
3510: 73 71 6c 2b 2b 2d 6e 65 77 64 69 72 20 3e 20 6d sql++-newdir > m
3520: 79 63 68 61 6e 67 65 2e 70 61 74 63 68 0a 0a 54 ychange.patch..T
3530: 68 65 20 60 64 69 66 66 60 20 63 6f 6d 6d 61 6e he `diff` comman
3540: 64 20 69 73 20 70 61 72 74 20 6f 66 20 65 76 65 d is part of eve
3550: 72 79 20 55 6e 69 78 20 61 6e 64 20 4c 69 6e 75 ry Unix and Linu
3560: 78 20 73 79 73 74 65 6d 2c 20 61 6e 64 20 73 68 x system, and sh
3570: 6f 75 6c 64 20 62 65 0a 69 6e 73 74 61 6c 6c 65 ould be.installe
3580: 64 20 62 79 20 64 65 66 61 75 6c 74 2e 20 49 66 d by default. If
3590: 20 79 6f 75 27 72 65 20 6f 6e 20 61 20 57 69 6e you're on a Win
35a0: 64 6f 77 73 20 6d 61 63 68 69 6e 65 2c 20 47 4e dows machine, GN
35b0: 55 20 64 69 66 66 20 69 73 20 70 61 72 74 0a 6f U diff is part.o
35c0: 66 20 5b 43 79 67 77 69 6e 5d 28 68 74 74 70 3a f [Cygwin](http:
35d0: 2f 2f 63 79 67 77 69 6e 2e 63 6f 6d 2f 29 2e 20 //cygwin.com/).
35e0: 46 6f 73 73 69 6c 20 69 73 20 61 6c 73 6f 20 61 Fossil is also a
35f0: 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 61 6c 6c vailable for all
3600: 20 6f 66 0a 74 68 65 73 65 20 73 79 73 74 65 6d of.these system
3610: 73 2e 20 54 68 65 72 65 20 61 72 65 20 6e 6f 20 s. There are no
3620: 65 78 63 75 73 65 73 20 66 6f 72 20 6e 6f 74 20 excuses for not
3630: 62 65 69 6e 67 20 61 62 6c 65 20 74 6f 20 6d 61 being able to ma
3640: 6b 65 20 75 6e 69 66 69 65 64 0a 64 69 66 66 73 ke unified.diffs
3650: 2e 20 3a 29 0a 0a 5b 66 62 5d 3a 20 20 68 74 74 . :)..[fb]: htt
3660: 70 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e 6f p://fossil-scm.o
3670: 72 67 2f 69 6e 64 65 78 2e 68 74 6d 6c 2f 68 65 rg/index.html/he
3680: 6c 70 3f 63 6d 64 3d 62 75 6e 64 6c 65 0a 5b 70 lp?cmd=bundle.[p
3690: 62 72 5d 3a 20 68 74 74 70 73 3a 2f 2f 74 61 6e br]: https://tan
36a0: 67 65 6e 74 73 6f 66 74 2e 63 6f 6d 2f 6d 79 73 gentsoft.com/mys
36b0: 71 6c 70 70 2f 66 69 6c 65 2f 48 41 43 4b 45 52 qlpp/file/HACKER
36c0: 53 2e 6d 64 23 70 72 69 76 61 74 65 0a 0a 0a 23 S.md#private...#
36d0: 23 20 54 68 65 20 4d 79 53 51 4c 2b 2b 20 43 6f # The MySQL++ Co
36e0: 64 65 20 53 74 79 6c 65 0a 0a 45 76 65 72 79 20 de Style..Every
36f0: 63 6f 64 65 20 62 61 73 65 20 73 68 6f 75 6c 64 code base should
3700: 20 68 61 76 65 20 61 20 63 6f 6d 6d 6f 6e 20 63 have a common c
3710: 6f 64 65 20 73 74 79 6c 65 2e 20 4c 6f 76 65 20 ode style. Love
3720: 69 74 20 6f 72 0a 68 61 74 65 20 69 74 2c 20 68 it or.hate it, h
3730: 65 72 65 20 61 72 65 20 4d 79 53 51 4c 2b 2b 27 ere are MySQL++'
3740: 73 20 63 75 72 72 65 6e 74 20 63 6f 64 65 20 73 s current code s
3750: 74 79 6c 65 20 72 75 6c 65 73 3a 0a 0a 0a 23 23 tyle rules:...##
3760: 23 20 53 6f 75 72 63 65 20 43 6f 64 65 0a 0a 46 # Source Code..F
3770: 69 6c 65 20 74 79 70 65 73 3a 20 60 61 63 60 2c ile types: `ac`,
3780: 20 60 63 70 70 60 2c 20 60 68 60 2c 20 60 69 6e `cpp`, `h`, `in
3790: 60 2c 20 60 6d 34 60 2c 20 60 70 6c 60 0a 0a 2d `, `m4`, `pl`..-
37a0: 20 20 20 54 61 62 73 20 66 6f 72 20 69 6e 64 65 Tabs for inde
37b0: 6e 74 73 2c 20 73 69 7a 65 20 34 0a 0a 2d 20 20 nts, size 4..-
37c0: 20 55 6e 69 78 20 6c 69 6e 65 20 65 6e 64 69 6e Unix line endin
37d0: 67 73 2e 20 41 6e 79 20 64 65 63 65 6e 74 20 70 gs. Any decent p
37e0: 72 6f 67 72 61 6d 6d 65 72 27 73 20 65 64 69 74 rogrammer's edit
37f0: 6f 72 20 63 61 6e 20 63 6f 70 65 20 77 69 74 68 or can cope with
3800: 0a 20 20 20 20 74 68 69 73 2c 20 65 76 65 6e 20 . this, even
3810: 6f 6e 20 57 69 6e 64 6f 77 73 2e 0a 0a 2d 20 20 on Windows...-
3820: 20 43 2f 43 2b 2b 20 72 75 6c 65 73 3a 0a 0a 20 C/C++ rules:..
3830: 20 20 20 2d 20 20 20 42 61 73 65 20 77 68 69 74 - Base whit
3840: 65 73 70 61 63 65 20 73 74 79 6c 65 20 69 73 20 espace style is
3850: 41 54 26 54 69 73 68 3a 20 4b 26 52 2f 53 74 72 AT&Tish: K&R/Str
3860: 6f 75 73 74 72 75 70 2c 20 70 6c 75 73 20 61 20 oustrup, plus a
3870: 6c 69 74 74 6c 65 0a 20 20 20 20 20 20 20 20 6c little. l
3880: 6f 63 61 6c 20 73 70 69 63 65 2e 20 49 66 20 79 ocal spice. If y
3890: 6f 75 20 68 61 76 65 20 74 68 65 20 69 6e 64 65 ou have the inde
38a0: 6e 74 28 31 29 20 70 72 6f 67 72 61 6d 2c 20 74 nt(1) program, t
38b0: 68 65 20 63 6f 6d 6d 61 6e 64 20 69 73 3a 0a 0a he command is:..
38c0: 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 64 65 inde
38d0: 6e 74 20 2d 6b 72 20 2d 6e 63 65 20 2d 63 6c 69 nt -kr -nce -cli
38e0: 34 20 2d 73 73 20 2d 64 69 31 20 2d 70 73 6c 20 4 -ss -di1 -psl
38f0: 2d 74 73 34 20 46 49 4c 45 53 2e 2e 2e 0a 0a 20 -ts4 FILES.....
3900: 20 20 20 20 20 20 20 54 68 61 74 20 69 73 2c 20 That is,
3910: 64 6f 6e 27 74 20 63 75 64 64 6c 65 20 65 6c 73 don't cuddle els
3920: 65 2c 20 69 6e 64 65 6e 74 20 63 61 73 65 20 73 e, indent case s
3930: 74 61 74 65 6d 65 6e 74 20 6c 61 62 65 6c 73 2c tatement labels,
3940: 20 73 70 61 63 65 0a 20 20 20 20 20 20 20 20 62 space. b
3950: 65 66 6f 72 65 20 73 65 6d 69 63 6f 6c 6f 6e 20 efore semicolon
3960: 77 69 74 68 20 65 6d 70 74 79 20 6c 6f 6f 70 20 with empty loop
3970: 62 6f 64 79 2c 20 6e 6f 20 65 78 74 72 61 20 73 body, no extra s
3980: 70 61 63 65 20 62 65 74 77 65 65 6e 20 61 0a 20 pace between a.
3990: 20 20 20 20 20 20 20 76 61 72 69 61 62 6c 65 20 variable
39a0: 74 79 70 65 20 61 6e 64 20 6e 61 6d 65 2c 20 72 type and name, r
39b0: 65 74 75 72 6e 20 76 61 6c 75 65 20 6f 66 20 66 eturn value of f
39c0: 75 6e 63 74 69 6f 6e 20 6f 6e 20 73 65 70 61 72 unction on separ
39d0: 61 74 65 0a 20 20 20 20 20 20 20 20 6c 69 6e 65 ate. line
39e0: 20 66 72 6f 6d 20 72 65 73 74 20 6f 66 20 64 65 from rest of de
39f0: 66 69 6e 69 74 69 6f 6e 2e 0a 0a 20 20 20 20 2d finition... -
3a00: 20 20 20 43 6c 61 73 73 20 6e 61 6d 65 73 20 61 Class names a
3a10: 72 65 20 69 6e 20 60 43 61 6d 65 6c 43 61 73 65 re in `CamelCase
3a20: 60 2c 20 75 70 70 65 72 63 61 73 65 64 20 66 69 `, uppercased fi
3a30: 72 73 74 20 6c 65 74 74 65 72 0a 0a 20 20 20 20 rst letter..
3a40: 2d 20 20 20 4d 65 74 68 6f 64 20 6e 61 6d 65 73 - Method names
3a50: 20 61 72 65 20 69 6e 20 60 61 6c 6c 5f 6c 6f 77 are in `all_low
3a60: 65 72 5f 63 61 73 65 5f 77 69 74 68 5f 75 6e 64 er_case_with_und
3a70: 65 72 73 63 6f 72 65 73 28 29 60 3b 0a 20 20 20 erscores()`;.
3a80: 20 20 20 20 20 64 69 74 74 6f 20 6d 6f 73 74 20 ditto most
3a90: 6f 74 68 65 72 20 67 6c 6f 62 61 6c 20 73 79 6d other global sym
3aa0: 62 6f 6c 73 2e 0a 0a 20 20 20 20 2d 20 20 20 4d bols... - M
3ab0: 61 63 72 6f 20 6e 61 6d 65 73 20 61 72 65 20 69 acro names are i
3ac0: 6e 20 60 41 4c 4c 5f 55 50 50 45 52 43 41 53 45 n `ALL_UPPERCASE
3ad0: 5f 57 49 54 48 5f 55 4e 44 45 52 53 43 4f 52 45 _WITH_UNDERSCORE
3ae0: 53 60 0a 0a 20 20 20 20 2d 20 20 20 44 6f 78 79 S`.. - Doxy
3af0: 67 65 6e 20 63 6f 6d 6d 65 6e 74 20 66 6f 72 20 gen comment for
3b00: 61 6c 6c 20 70 75 62 6c 69 63 20 64 65 63 6c 61 all public decla
3b10: 72 61 74 69 6f 6e 73 2c 20 75 6e 6c 65 73 73 20 rations, unless
3b20: 74 68 65 72 65 20 69 73 20 61 0a 20 20 20 20 20 there is a.
3b30: 20 20 20 76 65 72 79 20 67 6f 6f 64 20 72 65 61 very good rea
3b40: 73 6f 6e 20 74 6f 20 6b 65 65 70 20 74 68 65 20 son to keep the
3b50: 74 68 69 6e 67 20 75 6e 64 6f 63 75 6d 65 6e 74 thing undocument
3b60: 65 64 2e 0a 0a 2d 20 20 20 50 65 72 6c 20 61 6e ed...- Perl an
3b70: 64 20 73 68 65 6c 6c 20 73 63 72 69 70 74 20 72 d shell script r
3b80: 75 6c 65 73 20 61 72 65 20 6d 6f 72 65 20 6f 72 ules are more or
3b90: 20 6c 65 73 73 20 74 68 65 20 73 61 6d 65 20 61 less the same a
3ba0: 73 20 66 6f 72 20 43 2f 43 2b 2b 2c 0a 20 20 20 s for C/C++,.
3bb0: 20 74 6f 20 74 68 65 20 65 78 74 65 6e 74 20 74 to the extent t
3bc0: 68 69 73 20 6d 61 6b 65 73 20 73 65 6e 73 65 2e his makes sense.
3bd0: 0a 0a 0a 23 23 23 20 58 4d 4c 2f 48 54 4d 4c 20 ...### XML/HTML
3be0: 44 69 61 6c 65 63 74 73 0a 0a 46 69 6c 65 20 74 Dialects..File t
3bf0: 79 70 65 73 3a 20 60 62 6b 6c 60 2c 20 60 64 62 ypes: `bkl`, `db
3c00: 78 60 2c 20 60 68 74 61 60 0a 0a 2d 20 20 20 53 x`, `hta`..- S
3c10: 70 61 63 65 73 20 66 6f 72 20 69 6e 64 65 6e 74 paces for indent
3c20: 73 2c 20 73 69 7a 65 20 32 2e 20 53 68 61 6c 6c s, size 2. Shall
3c30: 6f 77 20 69 6e 64 65 6e 74 73 20 64 75 65 20 74 ow indents due t
3c40: 6f 20 74 68 65 20 68 69 67 68 20 6c 65 76 65 6c o the high level
3c50: 20 6f 66 0a 20 20 20 20 6e 65 73 74 69 6e 67 20 of. nesting
3c60: 6f 63 63 75 72 72 69 6e 67 20 69 6e 20 73 75 63 occurring in suc
3c70: 68 20 66 69 6c 65 73 2c 20 61 6e 64 20 73 70 61 h files, and spa
3c80: 63 65 73 20 62 65 63 61 75 73 65 20 74 68 65 79 ces because they
3c90: 27 72 65 20 6e 6f 74 20 61 73 0a 20 20 20 20 61 're not as. a
3ca0: 6e 6e 6f 79 69 6e 67 20 61 74 20 73 68 61 6c 6c nnoying at shall
3cb0: 6f 77 20 69 6e 64 65 6e 74 20 6c 65 76 65 6c 73 ow indent levels
3cc0: 20 69 6e 20 65 64 69 74 6f 72 73 20 74 68 61 74 in editors that
3cd0: 20 64 6f 6e 27 74 20 74 72 65 61 74 20 73 70 61 don't treat spa
3ce0: 63 65 0a 20 20 20 20 69 6e 64 65 6e 74 73 20 6c ce. indents l
3cf0: 69 6b 65 20 74 61 62 73 2e 0a 0a 2d 20 20 20 55 ike tabs...- U
3d00: 6e 69 78 20 6c 69 6e 65 20 65 6e 64 69 6e 67 73 nix line endings
3d10: 2e 20 41 67 61 69 6e 2c 20 74 68 65 73 65 20 61 . Again, these a
3d20: 72 65 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 62 re intended to b
3d30: 65 20 76 69 65 77 65 64 20 69 6e 20 61 0a 20 20 e viewed in a.
3d40: 20 20 70 72 6f 67 72 61 6d 6d 65 72 27 73 20 74 programmer's t
3d50: 65 78 74 20 65 64 69 74 6f 72 2c 20 77 68 69 63 ext editor, whic
3d60: 68 20 73 68 6f 75 6c 64 20 77 6f 72 6b 20 77 69 h should work wi
3d70: 74 68 20 55 6e 69 78 20 6c 69 6e 65 20 65 6e 64 th Unix line end
3d80: 69 6e 67 73 0a 20 20 20 20 6e 6f 20 6d 61 74 74 ings. no matt
3d90: 65 72 20 74 68 65 20 70 6c 61 74 66 6f 72 6d 2e er the platform.
3da0: 0a 0a 0a 23 23 23 20 50 6c 61 69 6e 20 54 65 78 ...### Plain Tex
3db0: 74 20 46 69 6c 65 73 0a 0a 46 69 6c 65 20 74 79 t Files..File ty
3dc0: 70 65 73 3a 20 60 74 78 74 60 0a 0a 2d 20 20 20 pes: `txt`..-
3dd0: 53 70 61 63 65 73 20 66 6f 72 20 69 6e 64 65 6e Spaces for inden
3de0: 74 73 2c 20 73 69 7a 65 20 34 2e 20 53 70 61 63 ts, size 4. Spac
3df0: 65 73 20 62 65 63 61 75 73 65 20 73 75 63 68 20 es because such
3e00: 66 69 6c 65 73 20 61 72 65 20 6f 66 74 65 6e 0a files are often.
3e10: 20 20 20 20 76 69 65 77 65 64 20 69 6e 20 4e 6f viewed in No
3e20: 74 65 70 61 64 20 61 6e 64 20 73 69 6d 69 6c 61 tepad and simila
3e30: 72 6c 79 20 63 72 69 70 70 6c 65 64 20 74 65 78 rly crippled tex
3e40: 74 20 65 64 69 74 6f 72 73 20 77 68 69 63 68 20 t editors which
3e50: 75 73 65 20 61 0a 20 20 20 20 64 65 66 61 75 6c use a. defaul
3e60: 74 20 69 6e 64 65 6e 74 20 6c 65 76 65 6c 20 6f t indent level o
3e70: 66 20 38 2e 0a 0a 2d 20 20 20 44 4f 53 20 6c 69 f 8...- DOS li
3e80: 6e 65 20 65 6e 64 69 6e 67 73 2c 20 61 67 61 69 ne endings, agai
3e90: 6e 20 66 6f 72 20 74 68 65 20 4e 6f 74 65 70 61 n for the Notepa
3ea0: 64 20 72 65 61 73 6f 6e 2e 20 41 6e 64 20 6f 6e d reason. And on
3eb0: 20 6d 6f 64 65 72 6e 20 55 6e 69 78 79 0a 20 20 modern Unixy.
3ec0: 20 20 70 6c 61 74 66 6f 72 6d 73 2c 20 74 68 65 platforms, the
3ed0: 20 74 6f 6f 6c 73 20 63 6f 70 65 20 77 69 74 68 tools cope with
3ee0: 20 44 4f 53 20 6c 69 6e 65 20 65 6e 64 69 6e 67 DOS line ending
3ef0: 73 20 72 65 61 73 6f 6e 61 62 6c 79 20 77 65 6c s reasonably wel
3f00: 6c 2e 0a 20 20 20 20 42 65 74 74 65 72 20 74 68 l.. Better th
3f10: 61 6e 20 74 68 65 20 63 6f 6e 76 65 72 73 65 2c an the converse,
3f20: 20 61 6e 79 77 61 79 2e 0a 0a 0a 57 68 65 6e 20 anyway....When
3f30: 69 6e 20 64 6f 75 62 74 2c 20 6d 69 6d 69 63 20 in doubt, mimic
3f40: 77 68 61 74 20 79 6f 75 20 73 65 65 20 69 6e 20 what you see in
3f50: 74 68 65 20 63 75 72 72 65 6e 74 20 63 6f 64 65 the current code
3f60: 2e 20 57 68 65 6e 20 73 74 69 6c 6c 20 69 6e 0a . When still in.
3f70: 64 6f 75 62 74 2c 20 61 73 6b 20 6f 6e 20 74 68 doubt, ask on th
3f80: 65 20 5b 6d 61 69 6c 69 6e 67 20 6c 69 73 74 5d e [mailing list]
3f90: 5b 6d 6c 5d 2e 0a 0a 0a 23 23 20 54 65 73 74 69 [ml]....## Testi
3fa0: 6e 67 20 59 6f 75 72 20 50 72 6f 70 6f 73 65 64 ng Your Proposed
3fb0: 20 43 68 61 6e 67 65 0a 0a 4d 79 53 51 4c 2b 2b Change..MySQL++
3fc0: 20 69 6e 63 6c 75 64 65 73 20 61 20 73 65 6c 66 includes a self
3fd0: 2d 74 65 73 74 20 6d 65 63 68 61 6e 69 73 6d 20 -test mechanism
3fe0: 63 61 6c 6c 65 64 20 60 64 74 65 73 74 60 2e 20 called `dtest`.
3ff0: 49 74 27 73 20 61 20 42 6f 75 72 6e 65 0a 73 68 It's a Bourne.sh
4000: 65 6c 6c 20 73 63 72 69 70 74 2c 20 72 75 6e 20 ell script, run
4010: 6d 75 63 68 20 6c 69 6b 65 20 60 65 78 72 75 6e much like `exrun
4020: 60 3a 0a 0a 20 20 20 20 24 20 2e 2f 64 74 65 73 `:.. $ ./dtes
4030: 74 20 5b 2d 73 20 73 65 72 76 65 72 5f 61 64 64 t [-s server_add
4040: 72 5d 20 5b 2d 75 20 75 73 65 72 5d 20 5b 2d 70 r] [-u user] [-p
4050: 20 70 61 73 73 77 6f 72 64 5d 0a 0a 54 68 69 73 password]..This
4060: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 automatically r
4070: 75 6e 73 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 uns most of the
4080: 65 78 61 6d 70 6c 65 73 2c 20 63 61 70 74 75 72 examples, captur
4090: 65 73 20 74 68 65 20 6f 75 74 70 75 74 73 20 74 es the outputs t
40a0: 6f 20 61 0a 66 69 6c 65 2c 20 61 6e 64 20 74 68 o a.file, and th
40b0: 65 6e 20 63 6f 6d 70 61 72 65 73 20 74 68 61 74 en compares that
40c0: 20 74 6f 20 61 20 6b 6e 6f 77 6e 2d 67 6f 6f 64 to a known-good
40d0: 20 72 75 6e 27 73 20 6f 75 74 70 75 74 73 2c 20 run's outputs,
40e0: 73 74 6f 72 65 64 20 69 6e 0a 60 62 6d 61 72 6b stored in.`bmark
40f0: 2e 74 78 74 60 2e 20 53 6f 2c 20 62 65 66 6f 72 .txt`. So, befor
4100: 65 20 79 6f 75 20 73 75 62 6d 69 74 20 61 20 70 e you submit a p
4110: 61 74 63 68 2c 20 72 75 6e 20 60 64 74 65 73 74 atch, run `dtest
4120: 60 20 74 6f 20 73 65 65 20 69 66 0a 61 6e 79 74 ` to see if.anyt
4130: 68 69 6e 67 20 68 61 73 20 63 68 61 6e 67 65 64 hing has changed
4140: 2e 20 49 66 20 73 6f 6d 65 74 68 69 6e 67 20 68 . If something h
4150: 61 73 20 61 6e 64 20 79 6f 75 20 63 61 6e 27 74 as and you can't
4160: 20 61 63 63 6f 75 6e 74 20 66 6f 72 20 69 74 2c account for it,
4170: 20 69 74 0a 72 65 70 72 65 73 65 6e 74 73 20 61 it.represents a
4180: 20 70 72 6f 62 6c 65 6d 20 74 68 61 74 20 79 6f problem that yo
4190: 75 27 6c 6c 20 68 61 76 65 20 74 6f 20 66 69 78 u'll have to fix
41a0: 20 62 65 66 6f 72 65 20 73 75 62 6d 69 74 74 69 before submitti
41b0: 6e 67 20 74 68 65 0a 70 61 74 63 68 2e 20 49 66 ng the.patch. If
41c0: 20 69 74 20 67 69 76 65 73 20 61 6e 20 65 78 70 it gives an exp
41d0: 65 63 74 65 64 20 63 68 61 6e 67 65 2c 20 72 65 ected change, re
41e0: 6d 6f 76 65 20 60 62 6d 61 72 6b 2e 74 78 74 60 move `bmark.txt`
41f0: 2c 20 72 65 2d 72 75 6e 0a 60 64 74 65 73 74 60 , re-run.`dtest`
4200: 2c 20 61 6e 64 20 69 6e 63 6c 75 64 65 20 74 68 , and include th
4210: 65 20 60 62 6d 61 72 6b 2e 74 78 74 60 20 64 69 e `bmark.txt` di
4220: 66 66 73 20 69 6e 20 79 6f 75 72 20 70 61 74 63 ffs in your patc
4230: 68 2e 20 54 68 69 73 0a 63 6f 6d 6d 75 6e 69 63 h. This.communic
4240: 61 74 65 73 20 74 6f 20 75 73 20 74 68 65 20 66 ates to us the f
4250: 61 63 74 20 74 68 61 74 20 79 6f 75 20 6b 6e 6f act that you kno
4260: 77 20 74 68 65 72 65 20 61 72 65 20 64 69 66 66 w there are diff
4270: 65 72 65 6e 63 65 73 20 61 6e 64 20 77 61 6e 74 erences and want
4280: 0a 74 68 65 20 70 61 74 63 68 20 65 76 61 6c 75 .the patch evalu
4290: 61 74 65 64 20 61 6e 79 77 61 79 2e 20 4f 74 68 ated anyway. Oth
42a0: 65 72 77 69 73 65 2c 20 77 65 20 61 72 65 20 6c erwise, we are l
42b0: 69 6b 65 6c 79 20 74 6f 20 76 69 65 77 20 74 68 ikely to view th
42c0: 65 20 63 68 61 6e 67 65 0a 61 73 20 61 20 62 75 e change.as a bu
42d0: 67 2e 0a 0a 60 64 74 65 73 74 60 20 61 6c 73 6f g...`dtest` also
42e0: 20 72 75 6e 73 20 61 6c 6c 20 6f 66 20 74 68 65 runs all of the
42f0: 20 75 6e 69 74 20 74 65 73 74 73 20 69 6e 20 60 unit tests in `
4300: 74 65 73 74 2f 2a 60 2e 20 54 68 65 20 70 75 72 test/*`. The pur
4310: 70 6f 73 65 20 6f 66 0a 60 74 65 73 74 2f 2a 60 pose of.`test/*`
4320: 20 69 73 20 64 69 66 66 65 72 65 6e 74 20 66 72 is different fr
4330: 6f 6d 20 74 68 61 74 20 6f 66 20 60 65 78 61 6d om that of `exam
4340: 70 6c 65 73 2f 2a 60 3a 0a 0a 2d 20 20 20 60 74 ples/*`:..- `t
4350: 65 73 74 2f 2a 60 20 61 72 65 20 75 6e 69 74 20 est/*` are unit
4360: 74 65 73 74 73 3a 20 65 61 63 68 20 74 65 73 74 tests: each test
4370: 73 20 6f 6e 6c 79 20 6f 6e 65 20 4d 79 53 51 4c s only one MySQL
4380: 2b 2b 20 63 6c 61 73 73 2c 0a 20 20 20 20 69 6e ++ class,. in
4390: 64 65 70 65 6e 64 65 6e 74 20 6f 66 20 65 76 65 dependent of eve
43a0: 72 79 74 68 69 6e 67 20 65 6c 73 65 2e 20 42 65 rything else. Be
43b0: 63 61 75 73 65 20 44 42 20 61 63 63 65 73 73 20 cause DB access
43c0: 72 65 71 75 69 72 65 73 20 73 65 76 65 72 61 6c requires several
43d0: 0a 20 20 20 20 4d 79 53 51 4c 2b 2b 20 63 6c 61 . MySQL++ cla
43e0: 73 73 65 73 20 74 6f 20 63 6f 6f 70 65 72 61 74 sses to cooperat
43f0: 65 2c 20 61 20 75 6e 69 74 20 74 65 73 74 20 6e e, a unit test n
4400: 65 76 65 72 20 61 63 63 65 73 73 65 73 20 61 20 ever accesses a
4410: 64 61 74 61 62 61 73 65 3b 0a 20 20 20 20 68 65 database;. he
4420: 6e 63 65 2c 20 6e 6f 20 75 6e 69 74 20 74 65 73 nce, no unit tes
4430: 74 20 6e 65 65 64 73 20 44 42 20 63 6f 6e 6e 65 t needs DB conne
4440: 63 74 69 6f 6e 20 70 61 72 61 6d 65 74 65 72 73 ction parameters
4450: 2e 20 20 57 65 20 77 69 6c 6c 20 6e 65 76 65 72 . We will never
4460: 0a 20 20 20 20 67 65 74 20 31 30 30 25 20 63 6f . get 100% co
4470: 64 65 20 63 6f 76 65 72 61 67 65 20 66 72 6f 6d de coverage from
4480: 20 60 74 65 73 74 2f 2a 60 20 61 6c 6f 6e 65 2e `test/*` alone.
4490: 0a 0a 2d 20 20 20 60 65 78 61 6d 70 6c 65 73 2f ..- `examples/
44a0: 2a 60 20 63 61 6e 20 62 65 20 74 68 6f 75 67 68 *` can be though
44b0: 74 20 6f 66 20 61 73 20 69 6e 74 65 67 72 61 74 t of as integrat
44c0: 69 6f 6e 20 74 65 73 74 73 3a 20 74 68 65 79 20 ion tests: they
44d0: 74 65 73 74 20 6d 61 6e 79 0a 20 20 20 20 70 69 test many. pi
44e0: 65 63 65 73 20 6f 66 20 4d 79 53 51 4c 2b 2b 20 eces of MySQL++
44f0: 77 6f 72 6b 69 6e 67 20 74 6f 67 65 74 68 65 72 working together
4500: 2c 20 61 63 63 65 73 73 69 6e 67 20 61 20 72 65 , accessing a re
4510: 61 6c 20 64 61 74 61 62 61 73 65 0a 20 20 20 20 al database.
4520: 73 65 72 76 65 72 2e 20 49 6e 20 61 64 64 69 74 server. In addit
4530: 69 6f 6e 20 74 6f 20 65 6e 73 75 72 69 6e 67 20 ion to ensuring
4540: 74 68 61 74 20 61 6c 6c 20 74 68 65 20 70 69 65 that all the pie
4550: 63 65 73 20 77 6f 72 6b 20 74 6f 67 65 74 68 65 ces work togethe
4560: 72 0a 20 20 20 20 61 6e 64 20 67 69 76 65 20 63 r. and give c
4570: 6f 6e 73 69 73 74 65 6e 74 20 72 65 73 75 6c 74 onsistent result
4580: 73 20 66 72 6f 6d 20 70 6c 61 74 66 6f 72 6d 20 s from platform
4590: 74 6f 20 70 6c 61 74 66 6f 72 6d 20 61 6e 64 20 to platform and
45a0: 72 75 6e 20 74 6f 0a 20 20 20 20 72 75 6e 2c 20 run to. run,
45b0: 69 74 20 61 6c 73 6f 20 66 69 6c 6c 73 20 69 6e it also fills in
45c0: 20 67 61 70 73 20 69 6e 20 74 68 65 20 63 6f 64 gaps in the cod
45d0: 65 20 63 6f 76 65 72 61 67 65 20 77 68 65 72 65 e coverage where
45e0: 20 6e 6f 20 73 75 69 74 61 62 6c 65 0a 20 20 20 no suitable.
45f0: 20 60 74 65 73 74 2f 2a 60 20 6d 6f 64 75 6c 65 `test/*` module
4600: 20 63 6f 75 6c 64 20 62 65 20 63 72 65 61 74 65 could be create
4610: 64 2e 0a 0a 2d 20 20 20 60 74 65 73 74 2f 2a 60 d...- `test/*`
4620: 20 70 72 6f 67 72 61 6d 73 20 61 6c 77 61 79 73 programs always
4630: 20 72 75 6e 20 73 69 6c 65 6e 74 6c 79 20 6f 6e run silently on
4640: 20 73 75 63 63 65 73 73 2c 20 77 72 69 74 69 6e success, writin
4650: 67 20 6f 75 74 70 75 74 0a 20 20 20 20 6f 6e 6c g output. onl
4660: 79 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 65 y to indicate te
4670: 73 74 20 66 61 69 6c 75 72 65 73 2e 20 54 68 69 st failures. Thi
4680: 73 20 69 73 20 62 65 63 61 75 73 65 20 74 68 65 s is because the
4690: 79 27 72 65 20 75 73 75 61 6c 6c 79 20 6f 6e 6c y're usually onl
46a0: 79 0a 20 20 20 20 72 75 6e 20 76 69 61 20 60 64 y. run via `d
46b0: 74 65 73 74 60 2e 0a 0a 2d 20 20 20 60 65 78 61 test`...- `exa
46c0: 6d 70 6c 65 73 2f 2a 60 20 61 72 65 20 61 6c 77 mples/*` are alw
46d0: 61 79 73 20 22 6e 6f 69 73 79 2c 22 20 72 65 67 ays "noisy," reg
46e0: 61 72 64 6c 65 73 73 20 6f 66 20 77 68 65 74 68 ardless of wheth
46f0: 65 72 20 74 68 65 79 20 73 75 63 63 65 65 64 0a er they succeed.
4700: 20 20 20 20 6f 72 20 66 61 69 6c 2c 20 62 65 63 or fail, bec
4710: 61 75 73 65 20 74 68 65 79 27 72 65 20 61 6c 73 ause they're als
4720: 6f 20 72 75 6e 20 69 6e 74 65 72 61 63 74 69 76 o run interactiv
4730: 65 6c 79 20 62 79 20 70 65 6f 70 6c 65 20 6c 65 ely by people le
4740: 61 72 6e 69 6e 67 0a 20 20 20 20 74 6f 20 75 73 arning. to us
4750: 65 20 4d 79 53 51 4c 2b 2b 2e 0a 0a 50 61 74 63 e MySQL++...Patc
4760: 68 65 73 20 73 68 6f 75 6c 64 20 69 6e 63 6c 75 hes should inclu
4770: 64 65 20 74 65 73 74 73 20 69 66 20 74 68 65 79 de tests if they
4780: 20 69 6e 74 72 6f 64 75 63 65 20 6e 65 77 20 66 introduce new f
4790: 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 6f 72 20 unctionality or
47a0: 66 69 78 0a 61 20 62 75 67 20 74 68 61 74 20 74 fix.a bug that t
47b0: 68 65 20 65 78 69 73 74 69 6e 67 20 74 65 73 74 he existing test
47c0: 20 63 6f 76 65 72 61 67 65 20 66 61 69 6c 65 64 coverage failed
47d0: 20 74 6f 20 63 61 74 63 68 2e 20 20 49 66 20 74 to catch. If t
47e0: 68 65 20 74 65 73 74 20 69 73 0a 6e 6f 69 73 79 he test is.noisy
47f0: 2c 20 6e 65 65 64 73 20 44 42 20 61 63 63 65 73 , needs DB acces
4800: 73 2c 20 6f 72 20 74 65 73 74 73 20 6d 75 6c 74 s, or tests mult
4810: 69 70 6c 65 20 70 61 72 74 73 20 6f 66 20 74 68 iple parts of th
4820: 65 20 6c 69 62 72 61 72 79 20 61 74 20 6f 6e 63 e library at onc
4830: 65 2c 0a 69 74 20 67 6f 65 73 20 69 6e 20 60 65 e,.it goes in `e
4840: 78 61 6d 70 6c 65 73 2f 2a 60 2e 20 49 66 20 79 xamples/*`. If y
4850: 6f 75 72 20 63 68 61 6e 67 65 20 61 66 66 65 63 our change affec
4860: 74 73 20 6f 6e 6c 79 20 6f 6e 65 20 63 6c 61 73 ts only one clas
4870: 73 20 69 6e 0a 4d 79 53 51 4c 2b 2b 20 61 6e 64 s in.MySQL++ and
4880: 20 74 65 73 74 69 6e 67 20 69 74 20 63 61 6e 20 testing it can
4890: 62 65 20 64 6f 6e 65 20 77 69 74 68 6f 75 74 20 be done without
48a0: 69 6e 73 74 61 6e 74 69 61 74 69 6e 67 20 6f 74 instantiating ot
48b0: 68 65 72 20 4d 79 53 51 4c 2b 2b 0a 63 6c 61 73 her MySQL++.clas
48c0: 73 65 73 20 e2 80 94 20 6f 74 68 65 72 20 74 68 ses — other th
48d0: 61 6e 20 62 79 20 63 6f 6d 70 6f 73 69 74 69 6f an by compositio
48e0: 6e 2c 20 6f 66 20 63 6f 75 72 73 65 20 e2 80 94 n, of course —
48f0: 20 69 74 20 73 68 6f 75 6c 64 20 67 6f 20 69 6e it should go in
4900: 0a 60 74 65 73 74 2f 2a 60 2e 0a 0a 49 6e 20 67 .`test/*`...In g
4910: 65 6e 65 72 61 6c 2c 20 70 72 65 66 65 72 20 6d eneral, prefer m
4920: 6f 64 69 66 79 69 6e 67 20 61 6e 20 65 78 69 73 odifying an exis
4930: 74 69 6e 67 20 60 65 78 61 6d 70 6c 65 73 2f 2a ting `examples/*
4940: 60 20 6f 72 20 60 74 65 73 74 2f 2a 60 0a 70 72 ` or `test/*`.pr
4950: 6f 67 72 61 6d 2e 20 20 41 64 64 20 61 20 6e 65 ogram. Add a ne
4960: 77 20 6f 6e 65 20 6f 6e 6c 79 20 69 66 20 79 6f w one only if yo
4970: 75 27 72 65 20 69 6e 74 72 6f 64 75 63 69 6e 67 u're introducing
4980: 20 62 72 61 6e 64 20 6e 65 77 0a 66 75 6e 63 74 brand new.funct
4990: 69 6f 6e 61 6c 69 74 79 20 6f 72 20 77 68 65 6e ionality or when
49a0: 20 61 20 67 69 76 65 6e 20 66 65 61 74 75 72 65 a given feature
49b0: 20 63 75 72 72 65 6e 74 6c 79 20 68 61 73 20 6e currently has n
49c0: 6f 20 74 65 73 74 20 61 74 20 61 6c 6c 2e 0a 0a o test at all...
49d0: 42 65 77 61 72 65 20 74 68 61 74 20 74 68 65 20 Beware that the
49e0: 70 72 69 6d 61 72 79 20 72 6f 6c 65 20 74 68 65 primary role the
49f0: 20 65 78 61 6d 70 6c 65 73 20 69 73 20 74 6f 20 examples is to
4a00: 69 6c 6c 75 73 74 72 61 74 65 20 70 6f 69 6e 74 illustrate point
4a10: 73 20 69 6e 20 74 68 65 0a 75 73 65 72 20 6d 61 s in the.user ma
4a20: 6e 75 61 6c 2e 20 49 66 20 61 6e 20 65 78 69 73 nual. If an exis
4a30: 74 69 6e 67 20 65 78 61 6d 70 6c 65 20 64 6f 65 ting example doe
4a40: 73 20 73 6f 6d 65 74 68 69 6e 67 20 73 69 6d 69 s something simi
4a50: 6c 61 72 20 74 6f 20 77 68 61 74 20 61 0a 70 72 lar to what a.pr
4a60: 6f 70 65 72 20 74 65 73 74 20 77 6f 75 6c 64 20 oper test would
4a70: 6e 65 65 64 20 74 6f 20 64 6f 20 61 6e 64 20 74 need to do and t
4a80: 68 65 20 74 65 73 74 20 64 6f 65 73 6e 27 74 20 he test doesn't
4a90: 63 68 61 6e 67 65 20 74 68 65 20 6e 61 74 75 72 change the natur
4aa0: 65 20 6f 66 0a 74 68 65 20 65 78 61 6d 70 6c 65 e of.the example
4ab0: 2c 20 64 6f 6e 27 74 20 77 6f 72 72 79 20 61 62 , don't worry ab
4ac0: 6f 75 74 20 63 68 61 6e 67 69 6e 67 20 74 68 65 out changing the
4ad0: 20 65 78 61 6d 70 6c 65 20 63 6f 64 65 2e 20 49 example code. I
4ae0: 66 20 79 6f 75 72 20 74 65 73 74 0a 77 6f 75 6c f your test.woul
4af0: 64 20 63 68 61 6e 67 65 20 74 68 65 20 6e 61 74 d change the nat
4b00: 75 72 65 20 6f 66 20 74 68 65 20 65 78 61 6d 70 ure of the examp
4b10: 6c 65 2c 20 79 6f 75 20 65 69 74 68 65 72 20 6e le, you either n
4b20: 65 65 64 20 74 6f 20 64 6f 20 74 68 65 20 74 65 eed to do the te
4b30: 73 74 0a 61 6e 6f 74 68 65 72 20 77 61 79 2c 20 st.another way,
4b40: 6f 72 20 61 6c 73 6f 20 73 75 62 6d 69 74 20 61 or also submit a
4b50: 20 63 68 61 6e 67 65 20 74 6f 20 60 64 6f 63 2f change to `doc/
4b60: 75 73 65 72 6d 61 6e 2f 2a 2e 64 62 78 60 20 74 userman/*.dbx` t
4b70: 68 61 74 0a 69 6e 63 6f 72 70 6f 72 61 74 65 73 hat.incorporates
4b80: 20 74 68 65 20 64 69 66 66 65 72 65 6e 63 65 2e the difference.
4b90: 0a 0a 0a 23 23 20 41 64 64 69 6e 67 20 53 75 70 ...## Adding Sup
4ba0: 70 6f 72 74 20 66 6f 72 20 61 20 44 69 66 66 65 port for a Diffe
4bb0: 72 65 6e 74 20 43 6f 6d 70 69 6c 65 72 0a 0a 41 rent Compiler..A
4bc0: 73 20 64 65 73 63 72 69 62 65 64 20 61 62 6f 76 s described abov
4bd0: 65 2c 20 4d 79 53 51 4c 2b 2b 20 75 73 65 73 20 e, MySQL++ uses
4be0: 74 68 65 20 42 61 6b 65 66 69 6c 65 20 73 79 73 the Bakefile sys
4bf0: 74 65 6d 20 66 6f 72 20 63 72 65 61 74 69 6e 67 tem for creating
4c00: 0a 70 72 6f 6a 65 63 74 20 66 69 6c 65 73 20 61 .project files a
4c10: 6e 64 20 6d 61 6b 65 66 69 6c 65 73 2e 20 54 68 nd makefiles. Th
4c20: 69 73 20 61 6c 6c 6f 77 73 20 75 73 20 74 6f 20 is allows us to
4c30: 6d 61 6b 65 20 63 68 61 6e 67 65 73 20 74 6f 20 make changes to
4c40: 61 20 73 69 6e 67 6c 65 0a 73 65 74 20 6f 66 20 a single.set of
4c50: 66 69 6c 65 73 2c 20 61 6e 64 20 68 61 76 65 20 files, and have
4c60: 74 68 65 20 70 72 6f 70 65 72 20 63 68 61 6e 67 the proper chang
4c70: 65 73 20 62 65 20 6d 61 64 65 20 74 6f 20 61 6c es be made to al
4c80: 6c 20 67 65 6e 65 72 61 74 65 64 0a 70 72 6f 6a l generated.proj
4c90: 65 63 74 20 66 69 6c 65 73 20 61 6e 64 20 6d 61 ect files and ma
4ca0: 6b 65 66 69 6c 65 73 2e 20 49 6e 20 74 68 65 20 kefiles. In the
4cb0: 70 61 73 74 2c 20 77 65 20 75 73 65 64 20 6d 6f past, we used mo
4cc0: 72 65 20 61 64 2d 68 6f 63 20 73 79 73 74 65 6d re ad-hoc system
4cd0: 73 2c 0a 61 6e 64 20 77 65 27 64 20 66 72 65 71 s,.and we'd freq
4ce0: 75 65 6e 74 6c 79 20 66 6f 72 67 65 74 20 74 6f uently forget to
4cf0: 20 75 70 64 61 74 65 20 69 6e 64 69 76 69 64 75 update individu
4d00: 61 6c 20 70 72 6f 6a 65 63 74 20 66 69 6c 65 73 al project files
4d10: 20 61 6e 64 0a 6d 61 6b 65 66 69 6c 65 73 2c 20 and.makefiles,
4d20: 73 6f 20 61 74 20 61 6e 79 20 67 69 76 65 6e 20 so at any given
4d30: 74 69 6d 65 2c 20 61 74 20 6c 65 61 73 74 20 6f time, at least o
4d40: 6e 65 20 74 61 72 67 65 74 20 77 61 73 20 6c 69 ne target was li
4d50: 6b 65 6c 79 20 74 6f 20 62 65 0a 62 72 6f 6b 65 kely to be.broke
4d60: 6e 2e 0a 0a 49 66 20 4d 79 53 51 4c 2b 2b 20 64 n...If MySQL++ d
4d70: 6f 65 73 6e 27 74 20 63 75 72 72 65 6e 74 6c 79 oesn't currently
4d80: 20 73 68 69 70 20 77 69 74 68 20 70 72 6f 6a 65 ship with proje
4d90: 63 74 20 66 69 6c 65 73 20 6f 72 20 6d 61 6b 65 ct files or make
4da0: 66 69 6c 65 73 20 74 75 6e 65 64 0a 66 6f 72 20 files tuned.for
4db0: 79 6f 75 72 20 63 6f 6d 70 69 6c 65 72 20 6f 66 your compiler of
4dc0: 20 63 68 6f 69 63 65 2c 20 79 6f 75 20 6e 65 65 choice, you nee
4dd0: 64 20 74 6f 20 77 6f 72 6b 20 74 68 72 6f 75 67 d to work throug
4de0: 68 20 74 68 65 20 42 61 6b 65 66 69 6c 65 0a 6d h the Bakefile.m
4df0: 65 63 68 61 6e 69 73 6d 20 74 6f 20 61 64 64 20 echanism to add
4e00: 73 75 70 70 6f 72 74 2e 20 57 65 27 72 65 20 6e support. We're n
4e10: 6f 74 20 77 69 6c 6c 69 6e 67 20 74 6f 20 64 6f ot willing to do
4e20: 20 61 64 2d 68 6f 63 20 70 6c 61 74 66 6f 72 6d ad-hoc platform
4e30: 0a 73 75 70 70 6f 72 74 20 61 6e 79 20 6d 6f 72 .support any mor
4e40: 65 2c 20 73 6f 20 70 6c 65 61 73 65 20 64 6f 6e e, so please don
4e50: 27 74 20 61 73 6b 20 69 66 20 79 6f 75 20 63 61 't ask if you ca
4e60: 6e 20 73 65 6e 64 20 75 73 20 70 72 6f 6a 65 63 n send us projec
4e70: 74 20 66 69 6c 65 73 0a 69 6e 73 74 65 61 64 3b t files.instead;
4e80: 20 77 65 20 64 6f 6e 27 74 20 77 61 6e 74 20 74 we don't want t
4e90: 68 65 6d 2e 0a 0a 49 66 20 79 6f 75 20 77 61 6e hem...If you wan
4ea0: 74 20 74 6f 20 70 6f 72 74 20 4d 79 53 51 4c 2b t to port MySQL+
4eb0: 2b 20 74 6f 20 61 6e 6f 74 68 65 72 20 70 6c 61 + to another pla
4ec0: 74 66 6f 72 6d 2c 20 77 65 20 6e 65 65 64 20 74 tform, we need t
4ed0: 6f 20 62 65 20 63 6f 6e 66 69 64 65 6e 74 0a 74 o be confident.t
4ee0: 68 61 74 20 74 68 65 20 65 6e 74 69 72 65 20 6c hat the entire l
4ef0: 69 62 72 61 72 79 20 77 6f 72 6b 73 20 6f 6e 20 ibrary works on
4f00: 79 6f 75 72 20 70 6c 61 74 66 6f 72 6d 20 62 65 your platform be
4f10: 66 6f 72 65 20 77 65 27 6c 6c 20 61 63 63 65 70 fore we'll accep
4f20: 74 0a 70 61 74 63 68 65 73 2e 20 49 6e 20 74 68 t.patches. In th
4f30: 65 20 70 61 73 74 2c 20 77 65 27 76 65 20 68 61 e past, we've ha
4f40: 64 20 62 72 6f 6b 65 6e 20 70 6f 72 74 73 20 74 d broken ports t
4f50: 68 61 74 20 77 65 72 65 20 6d 69 73 73 69 6e 67 hat were missing
4f60: 20 69 6d 70 6f 72 74 61 6e 74 0a 6c 69 62 72 61 important.libra
4f70: 72 79 20 66 65 61 74 75 72 65 73 2c 20 6f 72 20 ry features, or
4f80: 74 68 61 74 20 63 72 61 73 68 65 64 20 77 68 65 that crashed whe
4f90: 6e 20 62 75 69 6c 74 20 69 6e 20 63 65 72 74 61 n built in certa
4fa0: 69 6e 20 77 61 79 73 2e 20 46 65 77 20 70 65 6f in ways. Few peo
4fb0: 70 6c 65 0a 77 69 6c 6c 20 6b 6e 6f 77 69 6e 67 ple.will knowing
4fc0: 6c 79 20 75 73 65 20 61 20 63 72 69 70 70 6c 65 ly use a cripple
4fd0: 64 20 76 65 72 73 69 6f 6e 20 6f 66 20 4d 79 53 d version of MyS
4fe0: 51 4c 2b 2b 2c 20 73 69 6e 63 65 20 74 68 65 72 QL++, since ther
4ff0: 65 20 61 72 65 0a 75 73 75 61 6c 6c 79 20 61 63 e are.usually ac
5000: 63 65 70 74 61 62 6c 65 20 61 6c 74 65 72 6e 61 ceptable alterna
5010: 74 69 76 65 73 2e 20 20 54 68 65 72 65 66 6f 72 tives. Therefor
5020: 65 2c 20 73 75 63 68 20 70 6f 72 74 73 20 62 65 e, such ports be
5030: 63 6f 6d 65 0a 6d 61 69 6e 74 65 6e 61 6e 63 65 come.maintenance
5040: 20 62 61 67 67 61 67 65 20 77 69 74 68 20 6c 69 baggage with li
5050: 74 74 6c 65 20 63 6f 6d 70 65 6e 73 61 74 69 6e ttle compensatin
5060: 67 20 76 61 6c 75 65 2e 0a 0a 0a 23 23 20 3c 61 g value....## <a
5070: 20 6e 61 6d 65 3d 22 70 72 69 76 61 74 65 22 3e name="private">
5080: 3c 2f 61 3e 4d 61 69 6e 74 61 69 6e 69 6e 67 20 </a>Maintaining
5090: 61 20 50 72 69 76 61 74 65 20 52 65 70 6f 73 69 a Private Reposi
50a0: 74 6f 72 79 0a 0a 41 6c 74 68 6f 75 67 68 20 46 tory..Although F
50b0: 6f 73 73 69 6c 20 73 79 6e 63 73 20 63 68 61 6e ossil syncs chan
50c0: 67 65 73 20 62 61 63 6b 20 74 6f 20 74 68 65 20 ges back to the
50d0: 60 74 61 6e 67 65 6e 74 73 6f 66 74 2e 63 6f 6d `tangentsoft.com
50e0: 2f 6d 79 73 71 6c 70 70 60 0a 46 6f 73 73 69 6c /mysqlpp`.Fossil
50f0: 20 72 65 70 6f 73 69 74 6f 72 79 20 62 79 20 64 repository by d
5100: 65 66 61 75 6c 74 2c 20 69 74 20 69 73 20 70 6f efault, it is po
5110: 73 73 69 62 6c 65 20 74 6f 20 6d 61 69 6e 74 61 ssible to mainta
5120: 69 6e 20 61 20 70 72 69 76 61 74 65 20 63 6f 70 in a private cop
5130: 79 0a 74 68 61 74 20 73 69 6d 70 6c 79 20 70 75 y.that simply pu
5140: 6c 6c 73 20 63 68 61 6e 67 65 73 20 69 6e 20 6f lls changes in o
5150: 63 63 61 73 69 6f 6e 61 6c 6c 79 2e 0a 0a 54 68 ccasionally...Th
5160: 65 20 66 69 72 73 74 20 73 74 65 70 20 69 73 20 e first step is
5170: 74 6f 20 74 75 72 6e 20 6f 66 66 20 74 68 65 20 to turn off the
5180: 61 75 74 6f 2d 73 79 6e 63 20 66 65 61 74 75 72 auto-sync featur
5190: 65 3a 0a 0a 20 20 20 20 20 24 20 66 6f 73 73 69 e:.. $ fossi
51a0: 6c 20 73 65 74 20 61 75 74 6f 73 79 6e 63 20 30 l set autosync 0
51b0: 0a 0a 54 68 65 6e 2c 20 49 20 72 65 63 6f 6d 6d ..Then, I recomm
51c0: 65 6e 64 20 74 68 61 74 20 79 6f 75 20 6d 61 6b end that you mak
51d0: 65 20 61 6e 79 20 6c 6f 63 61 6c 20 63 68 61 6e e any local chan
51e0: 67 65 73 20 6f 6e 20 61 20 62 72 61 6e 63 68 3a ges on a branch:
51f0: 0a 0a 20 20 20 20 2e 2e 2e 68 61 63 6b 2c 20 68 .. ...hack, h
5200: 61 63 6b 2c 20 68 61 63 6b 2e 2e 2e 0a 20 20 20 ack, hack....
5210: 20 24 20 66 6f 73 73 69 6c 20 63 69 20 2d 2d 62 $ fossil ci --b
5220: 72 61 6e 63 68 20 6d 79 2d 6c 6f 63 61 6c 2d 62 ranch my-local-b
5230: 72 61 6e 63 68 0a 0a 41 66 74 65 72 20 79 6f 75 ranch..After you
5240: 20 67 69 76 65 20 74 68 65 20 60 2d 2d 62 72 61 give the `--bra
5250: 6e 63 68 60 20 6f 70 74 69 6f 6e 20 6f 6e 20 61 nch` option on a
5260: 20 63 68 65 63 6b 69 6e 2c 20 46 6f 73 73 69 6c checkin, Fossil
5270: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 73 automatically.s
5280: 77 69 74 63 68 65 73 20 79 6f 75 72 20 6c 6f 63 witches your loc
5290: 61 6c 20 63 68 65 63 6b 6f 75 74 20 74 6f 20 74 al checkout to t
52a0: 68 61 74 20 62 72 61 6e 63 68 2c 20 73 6f 20 74 hat branch, so t
52b0: 68 61 74 20 61 6c 6c 20 66 75 72 74 68 65 72 0a hat all further.
52c0: 63 68 65 63 6b 69 6e 73 20 63 61 6e 20 62 65 20 checkins can be
52d0: 6d 61 64 65 20 77 69 74 68 6f 75 74 20 74 68 65 made without the
52e0: 20 60 2d 2d 62 72 61 6e 63 68 60 20 6f 70 74 69 `--branch` opti
52f0: 6f 6e 2e 20 20 54 6f 20 67 65 74 20 62 61 63 6b on. To get back
5300: 20 74 6f 20 74 68 65 0a 74 72 75 6e 6b 2c 20 79 to the.trunk, y
5310: 6f 75 27 64 20 73 61 79 20 60 66 6f 73 73 69 6c ou'd say `fossil
5320: 20 75 70 20 74 72 75 6e 6b 60 2c 20 62 75 74 20 up trunk`, but
5330: 75 6e 64 65 72 20 74 68 69 73 20 77 6f 72 6b 66 under this workf
5340: 6c 6f 77 2c 20 74 68 65 20 6e 65 65 64 0a 66 6f low, the need.fo
5350: 72 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 72 r that will be r
5360: 61 72 65 2e 0a 0a 57 68 65 6e 20 73 6f 6d 65 74 are...When somet
5370: 68 69 6e 67 20 68 61 70 70 65 6e 73 20 6f 6e 20 hing happens on
5380: 74 68 65 20 6f 66 66 69 63 69 61 6c 20 74 72 75 the official tru
5390: 6e 6b 20 6f 6e 20 60 74 61 6e 67 65 6e 74 73 6f nk on `tangentso
53a0: 66 74 2e 63 6f 6d 60 20 74 68 61 74 0a 79 6f 75 ft.com` that.you
53b0: 20 77 61 6e 74 20 70 75 6c 6c 65 64 20 69 6e 74 want pulled int
53c0: 6f 20 79 6f 75 72 20 70 72 69 76 61 74 65 20 72 o your private r
53d0: 65 70 6f 73 69 74 6f 72 79 2c 20 73 61 79 3a 0a epository, say:.
53e0: 0a 20 20 20 20 24 20 66 6f 73 73 69 6c 20 73 79 . $ fossil sy
53f0: 6e 63 0a 20 20 20 20 24 20 66 6f 73 73 69 6c 20 nc. $ fossil
5400: 6d 65 72 67 65 20 74 72 75 6e 6b 0a 0a 54 68 65 merge trunk..The
5410: 20 66 69 72 73 74 20 63 6f 6d 6d 61 6e 64 20 70 first command p
5420: 75 6c 6c 73 20 61 6c 6c 20 72 65 6d 6f 74 65 20 ulls all remote
5430: 63 68 61 6e 67 65 73 20 69 6e 74 6f 20 79 6f 75 changes into you
5440: 72 20 6c 6f 63 61 6c 20 63 6c 6f 6e 65 2c 20 62 r local clone, b
5450: 75 74 0a 73 69 6e 63 65 20 74 68 6f 73 65 20 63 ut.since those c
5460: 68 61 6e 67 65 73 20 64 6f 6e 27 74 20 61 66 66 hanges don't aff
5470: 65 63 74 20 79 6f 75 72 20 70 72 69 76 61 74 65 ect your private
5480: 20 62 72 61 6e 63 68 2c 20 79 6f 75 20 77 6f 6e branch, you won
5490: 27 74 20 73 65 65 20 61 6e 79 0a 69 6d 6d 65 64 't see any.immed
54a0: 69 61 74 65 20 63 68 61 6e 67 65 2e 20 54 68 65 iate change. The
54b0: 20 73 65 63 6f 6e 64 20 61 74 74 65 6d 70 74 73 second attempts
54c0: 20 74 6f 20 6d 65 72 67 65 20 74 68 65 20 74 72 to merge the tr
54d0: 75 6e 6b 20 62 72 61 6e 63 68 27 73 0a 63 68 61 unk branch's.cha
54e0: 6e 67 65 73 20 73 69 6e 63 65 20 74 68 65 20 6c nges since the l
54f0: 61 73 74 20 62 72 61 6e 63 68 20 6f 72 20 6d 65 ast branch or me
5500: 72 67 65 20 70 6f 69 6e 74 20 69 6e 74 6f 20 79 rge point into y
5510: 6f 75 72 20 70 72 69 76 61 74 65 20 62 72 61 6e our private bran
5520: 63 68 2e 0a 0a 57 68 65 74 68 65 72 20 74 68 65 ch...Whether the
5530: 20 6d 65 72 67 65 20 69 73 20 73 75 63 63 65 73 merge is succes
5540: 73 66 75 6c 20 6f 72 20 6e 6f 74 2c 20 46 6f 73 sful or not, Fos
5550: 73 69 6c 20 64 6f 65 73 20 6e 6f 74 20 69 6d 6d sil does not imm
5560: 65 64 69 61 74 65 6c 79 0a 6d 6f 64 69 66 79 20 ediately.modify
5570: 79 6f 75 72 20 63 6c 6f 6e 65 2c 20 6f 6e 6c 79 your clone, only
5580: 20 74 68 65 20 77 6f 72 6b 69 6e 67 20 63 68 65 the working che
5590: 63 6b 6f 75 74 20 64 69 72 65 63 74 6f 72 79 2e ckout directory.
55a0: 20 59 6f 75 20 6d 75 73 74 20 74 68 65 6e 0a 73 You must then.s
55b0: 61 79 20 60 66 6f 73 73 69 6c 20 63 69 60 20 6f ay `fossil ci` o
55c0: 6e 63 65 20 79 6f 75 27 72 65 20 68 61 70 70 79 nce you're happy
55d0: 20 77 69 74 68 20 74 68 65 20 6d 65 72 67 65 2e with the merge.
55e0: 20 55 6e 74 69 6c 20 74 68 65 6e 2c 20 61 6c 6c Until then, all
55f0: 20 74 68 65 0a 75 73 75 61 6c 20 46 6f 73 73 69 the.usual Fossi
5600: 6c 20 63 6f 6d 6d 61 6e 64 73 20 6c 69 6b 65 20 l commands like
5610: 60 66 6f 73 73 69 6c 20 64 69 66 66 60 20 61 6e `fossil diff` an
5620: 64 20 60 66 6f 73 73 69 6c 20 73 74 61 74 75 73 d `fossil status
5630: 60 20 77 69 6c 6c 20 68 65 6c 70 0a 79 6f 75 20 ` will help.you
5640: 63 6f 6d 65 20 74 6f 20 74 68 61 74 20 64 65 63 come to that dec
5650: 69 73 69 6f 6e 2e 0a 0a 49 66 20 79 6f 75 20 65 ision...If you e
5660: 76 65 72 20 64 65 63 69 64 65 20 74 6f 20 63 6f ver decide to co
5670: 6e 74 72 69 62 75 74 65 20 79 6f 75 72 20 70 72 ntribute your pr
5680: 69 76 61 74 65 20 62 72 61 6e 63 68 20 74 6f 20 ivate branch to
5690: 74 68 65 20 4d 79 53 51 4c 2b 2b 0a 70 72 6f 6a the MySQL++.proj
56a0: 65 63 74 2c 20 74 68 65 72 65 20 61 72 65 20 61 ect, there are a
56b0: 20 63 6f 75 70 6c 65 20 6f 66 20 65 61 73 79 20 couple of easy
56c0: 77 61 79 73 20 74 6f 20 61 63 68 69 65 76 65 20 ways to achieve
56d0: 74 68 61 74 2e 20 41 73 6b 20 61 62 6f 75 74 20 that. Ask about
56e0: 69 74 0a 6f 6e 20 74 68 65 20 5b 6d 61 69 6c 69 it.on the [maili
56f0: 6e 67 20 6c 69 73 74 5d 5b 6d 6c 5d 20 69 66 20 ng list][ml] if
5700: 79 6f 75 20 66 69 6e 64 20 79 6f 75 72 73 65 6c you find yoursel
5710: 66 20 69 6e 20 74 68 69 73 20 73 69 74 75 61 74 f in this situat
5720: 69 6f 6e 2e 0a ion..