Not logged in

Artifact b4fe03c2dd86a524f5b77e302212a81224fa09e1:


0000: 23 20 2d 2a 2d 20 6f 72 67 20 2d 2a 2d 0a 0a 2a  # -*- org -*-..*
0010: 20 7a 65 70 74 6f 64 62 20 6e 65 77 73 0a 2a 2a   zeptodb news.**
0020: 20 76 33 2e 30 20 28 31 32 20 4a 75 6e 65 20 32   v3.0 (12 June 2
0030: 30 31 36 29 0a 54 68 69 73 20 69 73 20 61 20 6d  016).This is a m
0040: 61 6a 6f 72 20 75 70 64 61 74 65 2e 20 20 50 6c  ajor update.  Pl
0050: 65 61 73 65 20 6e 6f 74 65 20 74 68 61 74 20 74  ease note that t
0060: 68 65 72 65 20 68 61 76 65 20 62 65 65 6e 20 73  here have been s
0070: 69 67 6e 69 66 69 63 61 6e 74 0a 63 68 61 6e 67  ignificant.chang
0080: 65 73 20 74 6f 20 74 68 65 20 69 6e 74 65 72 66  es to the interf
0090: 61 63 65 20 76 69 61 20 73 65 76 65 72 61 6c 20  ace via several 
00a0: 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20 6f  changes to the o
00b0: 70 74 69 6f 6e 73 2e 0a 2a 2a 2a 20 52 65 6d 6f  ptions..*** Remo
00c0: 76 65 64 20 73 75 70 70 6f 72 74 20 66 6f 72 20  ved support for 
00d0: 4b 79 6f 74 6f 20 43 61 62 69 6e 65 74 0a 49 6e  Kyoto Cabinet.In
00e0: 20 6f 72 64 65 72 20 74 6f 20 62 65 20 61 62 6c   order to be abl
00f0: 65 20 74 6f 20 62 65 74 74 65 72 20 6c 6f 6e 67  e to better long
0100: 2d 74 65 72 6d 20 73 75 70 70 6f 72 74 20 74 68  -term support th
0110: 65 20 70 72 6f 67 72 61 6d 2c 20 74 68 65 0a 64  e program, the.d
0120: 65 63 69 73 69 6f 6e 20 77 61 73 20 6d 61 64 65  ecision was made
0130: 20 74 6f 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74   to only support
0140: 20 6f 6e 65 20 44 42 4d 20 6c 69 62 72 61 72 79   one DBM library
0150: 2e 0a 2a 2a 2a 20 4f 76 65 72 68 61 75 6c 20 6f  ..*** Overhaul o
0160: 66 20 6f 70 74 69 6f 6e 73 0a 41 6c 6c 20 7a 65  f options.All ze
0170: 70 74 6f 64 62 20 70 72 6f 67 72 61 6d 73 20 6e  ptodb programs n
0180: 6f 77 20 73 75 70 70 6f 72 74 20 61 20 73 65 74  ow support a set
0190: 20 6f 66 20 63 6f 6d 6d 6f 6e 20 6f 70 74 69 6f   of common optio
01a0: 6e 73 3a 20 2d 2d 6d 6d 61 70 2d 73 69 7a 65 2c  ns: --mmap-size,
01b0: 0a 2d 2d 63 61 63 68 65 2d 73 69 7a 65 2c 20 2d  .--cache-size, -
01c0: 2d 62 6c 6f 63 6b 2d 73 69 7a 65 2c 20 2d 2d 6e  -block-size, --n
01d0: 6f 2d 6d 6d 61 70 2c 20 61 6e 64 20 2d 2d 6e 6f  o-mmap, and --no
01e0: 2d 6c 6f 63 6b 20 28 69 6e 20 61 64 64 69 74 69  -lock (in additi
01f0: 6f 6e 20 74 6f 0a 74 68 65 20 75 73 75 61 6c 20  on to.the usual 
0200: 68 65 6c 70 2c 20 75 73 61 67 65 2c 20 76 65 72  help, usage, ver
0210: 73 69 6f 6e 20 61 6e 64 20 76 65 72 62 6f 73 65  sion and verbose
0220: 20 6f 70 74 69 6f 6e 73 29 2e 20 20 54 68 65 73   options).  Thes
0230: 65 20 6f 70 74 69 6f 6e 73 0a 63 6f 6e 74 72 6f  e options.contro
0240: 6c 20 68 6f 77 20 74 68 65 20 64 61 74 61 62 61  l how the databa
0250: 73 65 20 69 73 20 6f 70 65 6e 65 64 2e 20 20 50  se is opened.  P
0260: 6c 65 61 73 65 20 6e 6f 74 65 20 74 68 61 74 20  lease note that 
0270: 74 68 65 0a 22 2d 2d 6e 75 6d 2d 62 75 63 6b 65  the."--num-bucke
0280: 74 73 22 20 6f 70 74 69 6f 6e 20 66 6f 72 20 7a  ts" option for z
0290: 64 62 63 20 68 61 73 20 62 65 65 6e 20 72 65 6d  dbc has been rem
02a0: 6f 76 65 64 20 73 69 6e 63 65 20 69 74 20 77 61  oved since it wa
02b0: 73 20 6f 6e 6c 79 0a 61 70 70 72 6f 70 72 69 61  s only.appropria
02c0: 74 65 20 66 6f 72 20 4b 79 6f 74 6f 20 43 61 62  te for Kyoto Cab
02d0: 69 6e 65 74 20 61 6e 64 20 77 61 73 20 61 20 6d  inet and was a m
02e0: 69 73 6e 6f 6d 65 72 20 66 6f 72 20 47 44 42 4d  isnomer for GDBM
02f0: 20 28 69 74 27 73 0a 65 66 66 65 63 74 69 76 65   (it's.effective
0300: 6c 79 20 62 65 65 6e 20 72 65 70 6c 61 63 65 64  ly been replaced
0310: 20 62 79 20 2d 2d 63 61 63 68 65 2d 73 69 7a 65   by --cache-size
0320: 29 2e 20 20 54 68 65 20 2d 2d 73 79 6e 63 20 6f  ).  The --sync o
0330: 70 74 69 6f 6e 20 68 61 73 0a 61 6c 73 6f 20 62  ption has.also b
0340: 65 65 6e 20 61 64 64 65 64 20 66 6f 72 20 63 6f  een added for co
0350: 6d 6d 61 6e 64 73 20 74 68 61 74 20 77 72 69 74  mmands that writ
0360: 65 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65  e changes to the
0370: 20 64 61 74 61 62 61 73 65 2e 0a 50 6c 65 61 73   database..Pleas
0380: 65 20 73 65 65 20 74 68 65 20 64 6f 63 75 6d 65  e see the docume
0390: 6e 74 61 74 69 6f 6e 20 66 6f 72 20 61 20 66 75  ntation for a fu
03a0: 6c 6c 20 65 78 70 6c 61 6e 61 74 69 6f 6e 20 6f  ll explanation o
03b0: 66 20 74 68 65 73 65 20 6f 70 74 69 6f 6e 73 2e  f these options.
03c0: 0a 2a 2a 2a 20 7a 64 62 63 20 61 6c 77 61 79 73  .*** zdbc always
03d0: 20 63 72 65 61 74 65 73 20 61 20 6e 65 77 20 64   creates a new d
03e0: 61 74 61 62 61 73 65 0a 7a 64 62 63 20 6e 6f 77  atabase.zdbc now
03f0: 20 6f 76 65 72 77 72 69 74 65 73 20 61 20 64 61   overwrites a da
0400: 74 61 62 61 73 65 20 69 66 20 69 74 27 73 20 63  tabase if it's c
0410: 61 6c 6c 65 64 20 6f 6e 20 61 6e 20 65 78 69 73  alled on an exis
0420: 74 69 6e 67 20 66 69 6c 65 2e 0a 2a 2a 20 76 32  ting file..** v2
0430: 2e 30 2e 32 62 20 28 31 37 20 4e 6f 76 65 6d 62  .0.2b (17 Novemb
0440: 65 72 20 32 30 31 33 29 0a 54 68 69 73 20 72 65  er 2013).This re
0450: 6c 65 61 73 65 20 73 69 6d 70 6c 79 20 66 69 78  lease simply fix
0460: 65 73 20 73 6f 6d 65 20 70 72 6f 62 6c 65 6d 73  es some problems
0470: 20 69 6e 20 74 68 65 20 64 6f 63 75 6d 65 6e 74   in the document
0480: 61 74 69 6f 6e 20 6f 66 0a 76 65 72 73 69 6f 6e  ation of.version
0490: 20 32 2e 30 2e 32 2e 0a 2a 2a 20 76 32 2e 30 2e   2.0.2..** v2.0.
04a0: 32 20 28 31 37 20 4e 6f 76 65 6d 62 65 72 20 32  2 (17 November 2
04b0: 30 31 33 29 0a 54 68 69 73 20 69 73 20 61 6e 6f  013).This is ano
04c0: 74 68 65 72 20 62 75 67 2d 66 69 78 20 72 65 6c  ther bug-fix rel
04d0: 65 61 73 65 2e 0a 2a 2a 2a 20 53 65 76 65 72 61  ease..*** Severa
04e0: 6c 20 6d 65 6d 6f 72 79 20 62 75 67 73 20 66 69  l memory bugs fi
04f0: 78 65 64 0a 54 68 65 72 65 20 77 65 72 65 20 73  xed.There were s
0500: 6f 6d 65 20 6d 65 6d 6f 72 79 20 62 75 67 73 20  ome memory bugs 
0510: 69 6e 20 74 68 65 20 70 72 65 76 69 6f 75 73 20  in the previous 
0520: 76 65 72 73 69 6f 6e 2e 20 20 45 76 65 72 79 74  version.  Everyt
0530: 68 69 6e 67 0a 73 68 6f 75 6c 64 20 62 65 20 66  hing.should be f
0540: 69 78 65 64 20 6e 6f 77 2c 20 61 63 63 6f 72 64  ixed now, accord
0550: 69 6e 67 20 74 6f 20 76 61 6c 67 72 69 6e 64 20  ing to valgrind 
0560: 6f 75 74 70 75 74 20 61 6e 64 20 73 75 63 68 2e  output and such.
0570: 0a 2a 2a 2a 20 4d 6f 72 65 20 67 6e 75 6c 69 62  .*** More gnulib
0580: 20 6d 6f 64 75 6c 65 73 20 61 64 64 65 64 0a 4d   modules added.M
0590: 6f 72 65 20 67 6e 75 6c 69 62 20 6d 6f 64 75 6c  ore gnulib modul
05a0: 65 73 20 68 61 76 65 20 62 65 65 6e 20 61 64 64  es have been add
05b0: 65 64 20 61 6e 64 20 73 6f 6d 65 20 65 78 74 72  ed and some extr
05c0: 61 20 70 72 65 63 61 75 74 69 6f 6e 20 77 61 73  a precaution was
05d0: 0a 74 61 6b 65 6e 20 74 6f 20 65 6e 73 75 72 65  .taken to ensure
05e0: 20 74 68 61 74 20 7a 65 70 74 6f 64 62 20 62 75   that zeptodb bu
05f0: 69 6c 64 73 20 70 72 6f 70 65 72 6c 79 20 6f 6e  ilds properly on
0600: 20 61 73 20 6d 61 6e 79 20 50 4f 53 49 58 2d 6c   as many POSIX-l
0610: 69 6b 65 0a 73 79 73 74 65 6d 73 20 61 73 20 70  ike.systems as p
0620: 6f 73 73 69 62 6c 65 2e 0a 2a 2a 2a 20 53 79 73  ossible..*** Sys
0630: 74 65 6d 20 74 65 73 74 73 20 61 72 65 20 70 72  tem tests are pr
0640: 6f 76 69 64 65 64 0a 54 68 65 20 64 69 73 74 72  ovided.The distr
0650: 69 62 75 74 69 6f 6e 20 6e 6f 77 20 69 6e 63 6c  ibution now incl
0660: 75 64 65 73 20 73 6f 6d 65 20 73 79 73 74 65 6d  udes some system
0670: 20 74 65 73 74 73 20 74 6f 20 76 65 72 69 66 79   tests to verify
0680: 20 74 68 61 74 20 74 68 65 0a 7a 65 70 74 6f 64   that the.zeptod
0690: 62 20 62 69 6e 61 72 69 65 73 20 61 72 65 20 77  b binaries are w
06a0: 6f 72 6b 69 6e 67 20 70 72 6f 70 65 72 6c 79 2e  orking properly.
06b0: 20 20 59 6f 75 20 63 61 6e 20 72 75 6e 20 74 68    You can run th
06c0: 65 6d 20 76 69 61 20 74 68 65 0a 22 63 68 65 63  em via the."chec
06d0: 6b 22 20 6d 61 6b 65 20 74 61 72 67 65 74 3a 0a  k" make target:.
06e0: 0a 20 20 20 20 24 20 2e 2f 63 6f 6e 66 69 67 75  .    $ ./configu
06f0: 72 65 0a 20 20 20 20 24 20 6d 61 6b 65 20 61 6c  re.    $ make al
0700: 6c 0a 20 20 20 20 24 20 6d 61 6b 65 20 63 68 65  l.    $ make che
0710: 63 6b 0a 0a 2a 2a 2a 20 50 61 63 6b 61 67 69 6e  ck..*** Packagin
0720: 67 20 69 73 20 6e 6f 77 20 64 6f 6e 65 20 76 69  g is now done vi
0730: 61 20 73 77 62 69 73 0a 46 72 6f 6d 20 6e 6f 77  a swbis.From now
0740: 20 6f 6e 2c 20 7a 65 70 74 6f 64 62 20 77 69 6c   on, zeptodb wil
0750: 6c 20 62 65 20 70 61 63 6b 61 67 65 64 20 75 73  l be packaged us
0760: 69 6e 67 20 73 77 62 69 73 0a 28 68 74 74 70 3a  ing swbis.(http:
0770: 2f 2f 77 77 77 2e 67 6e 75 2e 6f 72 67 2f 73 6f  //www.gnu.org/so
0780: 66 74 77 61 72 65 2f 73 77 62 69 73 29 2e 20 20  ftware/swbis).  
0790: 54 68 65 20 75 73 75 61 6c 20 73 6f 75 72 63 65  The usual source
07a0: 20 64 69 73 74 72 69 62 75 74 69 6f 6e 2c 0a 7a   distribution,.z
07b0: 65 70 74 6f 64 62 2d 32 2e 30 2e 32 2e 74 61 72  eptodb-2.0.2.tar
07c0: 2e 67 7a 2c 20 6e 6f 77 20 61 6c 73 6f 20 63 6f  .gz, now also co
07d0: 6e 74 61 69 6e 73 20 63 68 65 63 6b 73 75 6d 73  ntains checksums
07e0: 20 28 6d 64 35 2c 20 73 68 61 31 20 61 6e 64 0a   (md5, sha1 and.
07f0: 73 68 61 35 31 32 29 20 61 73 20 77 65 6c 6c 20  sha512) as well 
0800: 61 73 20 61 20 47 50 47 20 73 69 67 6e 61 74 75  as a GPG signatu
0810: 72 65 2e 20 20 59 6f 75 20 63 61 6e 20 76 65 72  re.  You can ver
0820: 69 66 79 20 74 68 65 20 70 61 63 6b 61 67 65 20  ify the package 
0830: 75 73 69 6e 67 0a 73 77 76 65 72 69 66 79 20 66  using.swverify f
0840: 72 6f 6d 20 74 68 65 20 73 77 62 69 73 20 70 61  rom the swbis pa
0850: 63 6b 61 67 65 3a 0a 0a 20 20 20 20 24 20 73 77  ckage:..    $ sw
0860: 76 65 72 69 66 79 20 2d 64 20 40 2d 20 3c 7a 65  verify -d @- <ze
0870: 70 74 6f 64 62 2d 32 2e 30 2e 32 2e 74 61 72 2e  ptodb-2.0.2.tar.
0880: 67 7a 0a 20 20 20 20 73 77 76 65 72 69 66 79 3a  gz.    swverify:
0890: 20 41 72 63 68 69 76 65 20 64 69 67 65 73 74 3a   Archive digest:
08a0: 20 6d 64 35 20 4f 4b 20 28 47 6f 6f 64 29 0a 20   md5 OK (Good). 
08b0: 20 20 20 73 77 76 65 72 69 66 79 3a 20 41 72 63     swverify: Arc
08c0: 68 69 76 65 20 64 69 67 65 73 74 3a 20 73 68 61  hive digest: sha
08d0: 31 20 4f 4b 20 28 47 6f 6f 64 29 0a 20 20 20 20  1 OK (Good).    
08e0: 73 77 76 65 72 69 66 79 3a 20 41 72 63 68 69 76  swverify: Archiv
08f0: 65 20 73 69 7a 65 3a 20 4f 4b 20 28 47 6f 6f 64  e size: OK (Good
0900: 29 0a 20 20 20 20 73 77 76 65 72 69 66 79 3a 20  ).    swverify: 
0910: 41 72 63 68 69 76 65 20 64 69 67 65 73 74 3a 20  Archive digest: 
0920: 73 68 61 35 31 32 20 4f 4b 20 28 47 6f 6f 64 29  sha512 OK (Good)
0930: 0a 20 20 20 20 67 70 67 3a 20 53 69 67 6e 61 74  .    gpg: Signat
0940: 75 72 65 20 6d 61 64 65 20 53 75 6e 20 31 37 20  ure made Sun 17 
0950: 4e 6f 76 20 32 30 31 33 20 30 33 3a 31 36 3a 35  Nov 2013 03:16:5
0960: 37 20 50 4d 20 43 45 54 20 75 73 69 6e 67 20 52  7 PM CET using R
0970: 53 41 20 6b 65 79 20 49 44 20 45 42 37 41 42 37  SA key ID EB7AB7
0980: 34 44 0a 20 20 20 20 67 70 67 3a 20 47 6f 6f 64  4D.    gpg: Good
0990: 20 73 69 67 6e 61 74 75 72 65 20 66 72 6f 6d 20   signature from 
09a0: 22 42 72 61 6e 64 6f 6e 20 49 6e 76 65 72 67 6f  "Brandon Invergo
09b0: 20 28 47 4e 55 29 20 3c 62 72 61 6e 64 6f 6e 40   (GNU) <brandon@
09c0: 67 6e 75 2e 6f 72 67 3e 22 0a 20 20 20 20 67 70  gnu.org>".    gp
09d0: 67 3a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  g:              
09e0: 20 20 20 61 6b 61 20 22 42 72 61 6e 64 6f 6e 20     aka "Brandon 
09f0: 49 6e 76 65 72 67 6f 20 3c 62 72 61 6e 64 6f 6e  Invergo <brandon
0a00: 40 69 6e 76 65 72 67 6f 2e 6e 65 74 3e 22 0a 20  @invergo.net>". 
0a10: 20 20 20 67 70 67 3a 20 57 41 52 4e 49 4e 47 3a     gpg: WARNING:
0a20: 20 54 68 69 73 20 6b 65 79 20 69 73 20 6e 6f 74   This key is not
0a30: 20 63 65 72 74 69 66 69 65 64 20 77 69 74 68 20   certified with 
0a40: 61 20 74 72 75 73 74 65 64 20 73 69 67 6e 61 74  a trusted signat
0a50: 75 72 65 21 0a 20 20 20 20 67 70 67 3a 20 20 20  ure!.    gpg:   
0a60: 20 20 20 20 20 20 20 54 68 65 72 65 20 69 73 20         There is 
0a70: 6e 6f 20 69 6e 64 69 63 61 74 69 6f 6e 20 74 68  no indication th
0a80: 61 74 20 74 68 65 20 73 69 67 6e 61 74 75 72 65  at the signature
0a90: 20 62 65 6c 6f 6e 67 73 20 74 6f 20 74 68 65 20   belongs to the 
0aa0: 6f 77 6e 65 72 2e 0a 20 20 20 20 50 72 69 6d 61  owner..    Prima
0ab0: 72 79 20 6b 65 79 20 66 69 6e 67 65 72 70 72 69  ry key fingerpri
0ac0: 6e 74 3a 20 45 36 37 35 20 31 39 44 42 20 31 45  nt: E675 19DB 1E
0ad0: 33 30 20 36 46 41 38 20 32 36 36 44 20 20 30 38  30 6FA8 266D  08
0ae0: 42 41 20 30 34 36 45 20 44 45 45 36 20 45 42 37  BA 046E DEE6 EB7
0af0: 41 20 42 37 34 44 0a 0a 49 20 61 6c 73 6f 20 70  A B74D..I also p
0b00: 72 6f 76 69 64 65 20 74 77 6f 20 70 61 63 6b 61  rovide two packa
0b10: 67 65 73 20 74 68 61 74 20 61 72 65 20 63 6f 6d  ges that are com
0b20: 70 6c 69 61 6e 74 20 77 69 74 68 20 74 68 65 20  pliant with the 
0b30: 50 4f 53 49 58 0a 70 61 63 6b 61 67 69 6e 67 20  POSIX.packaging 
0b40: 73 74 61 6e 64 61 72 64 20 74 68 61 74 20 73 77  standard that sw
0b50: 62 69 73 20 69 6d 70 6c 65 6d 65 6e 74 73 2c 20  bis implements, 
0b60: 6f 6e 65 20 69 73 20 61 20 73 6f 75 72 63 65 20  one is a source 
0b70: 64 69 73 74 72 69 62 75 74 69 6f 6e 0a 28 7a 65  distribution.(ze
0b80: 70 74 6f 64 62 2d 32 2e 30 2e 32 2d 73 72 63 2e  ptodb-2.0.2-src.
0b90: 73 77 2e 74 61 72 2e 67 7a 29 20 61 6e 64 20 74  sw.tar.gz) and t
0ba0: 68 65 20 6f 74 68 65 72 20 69 73 20 61 20 62 69  he other is a bi
0bb0: 6e 61 72 79 20 28 78 38 36 5f 36 34 0a 47 4e 55  nary (x86_64.GNU
0bc0: 2f 4c 69 6e 75 78 29 20 64 69 73 74 72 69 62 75  /Linux) distribu
0bd0: 74 69 6f 6e 20 28 7a 65 70 74 6f 64 62 2d 32 2e  tion (zeptodb-2.
0be0: 30 2e 32 2d 78 38 36 5f 36 34 2e 73 77 2e 74 61  0.2-x86_64.sw.ta
0bf0: 72 2e 67 7a 29 2e 20 20 42 6f 74 68 20 63 61 6e  r.gz).  Both can
0c00: 20 62 65 0a 69 6e 73 74 61 6c 6c 65 64 20 76 69   be.installed vi
0c10: 61 20 74 68 65 20 73 77 62 69 73 20 74 6f 6f 6c  a the swbis tool
0c20: 20 73 77 69 6e 73 74 61 6c 6c 2e 20 20 54 68 65   swinstall.  The
0c30: 20 73 6f 75 72 63 65 20 64 69 73 74 72 69 62 75   source distribu
0c40: 74 69 6f 6e 20 69 73 0a 61 75 74 6f 6d 61 74 69  tion is.automati
0c50: 63 61 6c 6c 79 20 63 6f 6e 66 69 67 75 72 65 64  cally configured
0c60: 20 61 6e 64 20 62 75 69 6c 74 20 61 66 74 65 72   and built after
0c70: 20 69 74 20 69 73 20 69 6e 73 74 61 6c 6c 65 64   it is installed
0c80: 20 77 69 74 68 0a 73 77 69 6e 73 74 61 6c 6c 2e   with.swinstall.
0c90: 20 54 68 65 20 62 75 69 6c 74 20 62 69 6e 61 72   The built binar
0ca0: 69 65 73 20 63 61 6e 20 74 68 65 6e 20 62 65 20  ies can then be 
0cb0: 69 6e 73 74 61 6c 6c 65 64 20 76 69 61 20 74 68  installed via th
0cc0: 65 20 73 77 63 6f 6e 66 69 67 0a 74 6f 6f 6c 3a  e swconfig.tool:
0cd0: 0a 0a 20 20 20 20 24 20 73 77 69 6e 73 74 61 6c  ..    $ swinstal
0ce0: 6c 20 2d 73 20 3a 7a 65 70 74 6f 64 62 2d 32 2e  l -s :zeptodb-2.
0cf0: 30 2e 32 2d 73 72 63 2e 73 77 2e 74 61 72 2e 67  0.2-src.sw.tar.g
0d00: 7a 20 40 2f 75 73 72 2f 6c 6f 63 61 6c 0a 20 20  z @/usr/local.  
0d10: 20 20 5b 63 6f 6e 66 69 67 75 72 65 20 61 6e 64    [configure and
0d20: 20 6d 61 6b 65 20 62 75 69 6c 64 20 6f 75 74 70   make build outp
0d30: 75 74 5d 0a 20 20 20 20 24 20 73 77 63 6f 6e 66  ut].    $ swconf
0d40: 69 67 20 7a 65 70 74 6f 64 62 20 40 2f 75 73 72  ig zeptodb @/usr
0d50: 2f 6c 6f 63 61 6c 0a 20 20 20 20 5b 6d 61 6b 65  /local.    [make
0d60: 20 69 6e 73 74 61 6c 6c 20 6f 75 74 70 75 74 5d   install output]
0d70: 0a 0a 54 68 65 20 78 38 36 5f 36 34 20 62 69 6e  ..The x86_64 bin
0d80: 61 72 79 20 64 69 73 74 72 69 62 75 74 69 6f 6e  ary distribution
0d90: 20 77 69 6c 6c 20 72 65 71 75 69 72 65 20 75 70   will require up
0da0: 2d 74 6f 2d 64 61 74 65 20 47 4e 55 20 6c 69 62  -to-date GNU lib
0db0: 63 20 28 32 2e 31 38 29 0a 61 6e 64 20 47 44 42  c (2.18).and GDB
0dc0: 4d 20 28 31 2e 31 30 29 20 6c 69 62 72 61 72 69  M (1.10) librari
0dd0: 65 73 2e 20 20 54 68 65 20 62 69 6e 61 72 69 65  es.  The binarie
0de0: 73 20 77 69 6c 6c 20 62 65 20 69 6e 73 74 61 6c  s will be instal
0df0: 6c 65 64 20 69 6e 20 74 68 65 0a 70 72 6f 70 65  led in the.prope
0e00: 72 20 70 6c 61 63 65 73 20 61 74 20 74 68 65 20  r places at the 
0e10: 70 72 65 66 69 78 20 6f 66 20 79 6f 75 72 20 63  prefix of your c
0e20: 68 6f 69 63 65 20 77 68 65 6e 20 79 6f 75 20 72  hoice when you r
0e30: 75 6e 20 73 77 69 6e 73 74 61 6c 6c 2e 0a 46 6f  un swinstall..Fo
0e40: 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 69 6e  r example, to in
0e50: 73 74 61 6c 6c 20 74 6f 20 2f 75 73 72 2f 6c 6f  stall to /usr/lo
0e60: 63 61 6c 3a 0a 0a 20 20 20 20 24 20 73 77 69 6e  cal:..    $ swin
0e70: 73 74 61 6c 6c 20 2d 73 20 3a 7a 65 70 74 6f 64  stall -s :zeptod
0e80: 62 2d 32 2e 30 2e 32 2d 78 38 36 5f 36 34 2e 73  b-2.0.2-x86_64.s
0e90: 77 2e 74 61 72 2e 67 7a 20 40 2f 75 73 72 2f 6c  w.tar.gz @/usr/l
0ea0: 6f 63 61 6c 0a 0a 57 68 79 20 64 6f 20 74 68 69  ocal..Why do thi
0eb0: 73 3f 20 20 49 74 27 73 20 75 6e 66 65 61 73 69  s?  It's unfeasi
0ec0: 62 6c 65 20 66 6f 72 20 6d 65 20 74 6f 20 70 72  ble for me to pr
0ed0: 6f 76 69 64 65 20 70 61 63 6b 61 67 65 73 20 66  ovide packages f
0ee0: 6f 72 20 61 6c 6c 20 74 68 65 0a 64 69 66 66 65  or all the.diffe
0ef0: 72 65 6e 74 20 70 61 63 6b 61 67 69 6e 67 20 73  rent packaging s
0f00: 79 73 74 65 6d 73 20 6f 75 74 20 74 68 65 72 65  ystems out there
0f10: 2e 20 20 49 66 20 49 27 6d 20 6f 6e 6c 79 20 67  .  If I'm only g
0f20: 6f 69 6e 67 20 74 6f 20 70 72 6f 76 69 64 65 0a  oing to provide.
0f30: 6f 6e 65 2c 20 69 74 20 68 61 64 20 62 65 74 74  one, it had bett
0f40: 65 72 20 62 65 20 73 74 61 6e 64 61 72 64 73 2d  er be standards-
0f50: 63 6f 6d 70 6c 69 61 6e 74 2e 20 20 49 74 20 73  compliant.  It s
0f60: 68 6f 75 6c 64 20 62 65 20 72 65 6c 61 74 69 76  hould be relativ
0f70: 65 6c 79 0a 73 69 6d 70 6c 65 20 74 6f 20 63 6f  ely.simple to co
0f80: 6e 76 65 72 74 20 74 68 65 20 73 77 62 69 73 20  nvert the swbis 
0f90: 70 61 63 6b 61 67 65 73 20 74 6f 20 73 6f 6d 65  packages to some
0fa0: 20 6f 74 68 65 72 20 66 6f 72 6d 61 74 2e 20 20   other format.  
0fb0: 4f 4b 2c 20 73 6f 20 49 0a 6d 61 79 20 62 65 20  OK, so I.may be 
0fc0: 74 68 65 20 6f 6e 6c 79 20 70 65 72 73 6f 6e 20  the only person 
0fd0: 69 6e 20 74 68 65 20 77 6f 72 6c 64 20 6f 74 68  in the world oth
0fe0: 65 72 20 74 68 61 6e 20 74 68 65 20 73 77 62 69  er than the swbi
0ff0: 73 20 64 65 76 65 6c 6f 70 65 72 20 77 68 6f 0a  s developer who.
1000: 69 73 20 75 73 69 6e 67 20 74 68 69 73 20 73 79  is using this sy
1010: 73 74 65 6d 2c 20 62 75 74 20 69 74 27 73 20 74  stem, but it's t
1020: 6f 20 62 65 20 68 6f 70 65 64 20 74 68 61 74 20  o be hoped that 
1030: 6f 74 68 65 72 73 20 77 69 6c 6c 20 6a 6f 69 6e  others will join
1040: 20 69 6e 2e 0a 41 74 20 74 68 65 20 76 65 72 79   in..At the very
1050: 20 6c 65 61 73 74 2c 20 62 75 69 6c 64 69 6e 67   least, building
1060: 20 73 74 61 6e 64 61 72 64 20 73 6f 75 72 63 65   standard source
1070: 20 64 69 73 74 72 69 62 75 74 69 6f 6e 73 20 77   distributions w
1080: 69 74 68 20 73 77 62 69 73 0a 69 73 20 68 61 6e  ith swbis.is han
1090: 64 79 20 66 6f 72 20 69 6e 63 6c 75 64 69 6e 67  dy for including
10a0: 20 69 6e 2d 6c 69 6e 65 20 61 6c 6c 20 74 68 65   in-line all the
10b0: 20 63 68 65 63 6b 73 75 6d 73 20 61 6e 64 20 73   checksums and s
10c0: 69 67 6e 61 74 75 72 65 73 20 72 69 67 68 74 0a  ignatures right.
10d0: 69 6e 74 6f 20 74 68 65 20 70 61 63 6b 61 67 65  into the package
10e0: 2e 0a 2a 2a 20 76 32 2e 30 2e 31 20 28 30 34 20  ..** v2.0.1 (04 
10f0: 4a 75 6c 79 20 32 30 31 33 29 0a 2a 2a 2a 20 42  July 2013).*** B
1100: 75 67 66 69 78 20 72 65 6c 65 61 73 65 0a 54 68  ugfix release.Th
1110: 69 73 20 72 65 6c 65 61 73 65 20 6a 75 73 74 20  is release just 
1120: 66 69 78 65 73 20 61 20 63 6f 75 70 6c 65 20 62  fixes a couple b
1130: 75 67 73 20 74 68 61 74 20 70 6f 70 70 65 64 20  ugs that popped 
1140: 75 70 20 77 68 65 6e 20 72 75 6e 6e 69 6e 67 0a  up when running.
1150: 7a 65 70 74 6f 64 62 20 6f 6e 20 61 6e 20 61 6e  zeptodb on an an
1160: 63 69 65 6e 74 20 73 79 73 74 65 6d 2e 0a 2a 2a  cient system..**
1170: 20 76 32 2e 30 20 28 30 33 20 4a 75 6c 79 20 32   v2.0 (03 July 2
1180: 30 31 33 0a 2a 2a 2a 20 4b 79 6f 74 6f 20 43 61  013.*** Kyoto Ca
1190: 62 69 6e 65 74 20 62 61 63 6b 2d 65 6e 64 20 69  binet back-end i
11a0: 73 20 6e 6f 77 20 61 76 61 69 6c 61 62 6c 65 0a  s now available.
11b0: 41 74 20 63 6f 6d 70 69 6c 65 20 74 69 6d 65 2c  At compile time,
11c0: 20 79 6f 75 20 63 61 6e 20 6e 6f 77 20 6f 70 74   you can now opt
11d0: 20 74 6f 20 75 73 65 20 74 68 65 20 4b 79 6f 74   to use the Kyot
11e0: 6f 20 43 61 62 69 6e 65 74 20 44 42 4d 20 6c 69  o Cabinet DBM li
11f0: 62 72 61 72 79 0a 69 6e 73 74 65 61 64 20 6f 66  brary.instead of
1200: 20 74 68 65 20 47 44 42 4d 20 6c 69 62 72 61 72   the GDBM librar
1210: 79 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 61 6e  y.  Note that an
1220: 79 20 64 61 74 61 62 61 73 65 73 20 63 72 65 61  y databases crea
1230: 74 65 64 20 77 69 74 68 0a 74 68 65 20 47 44 42  ted with.the GDB
1240: 4d 20 6c 69 62 72 61 72 79 20 77 69 6c 6c 20 2a  M library will *
1250: 6e 6f 74 2a 20 62 65 20 61 63 63 65 73 73 69 62  not* be accessib
1260: 6c 65 20 77 69 74 68 20 74 68 65 20 4b 79 6f 74  le with the Kyot
1270: 6f 20 43 61 62 69 6e 65 74 0a 6c 69 62 72 61 72  o Cabinet.librar
1280: 79 2e 0a 2a 2a 2a 20 44 61 74 61 62 61 73 65 20  y..*** Database 
1290: 63 72 65 61 74 69 6f 6e 20 6e 6f 77 20 68 61 73  creation now has
12a0: 20 61 20 64 65 64 69 63 61 74 65 64 20 70 72 6f   a dedicated pro
12b0: 67 72 61 6d 0a 50 72 65 76 69 6f 75 73 6c 79 2c  gram.Previously,
12c0: 20 7a 65 70 74 6f 64 62 20 64 61 74 61 62 61 73   zeptodb databas
12d0: 65 73 20 77 65 72 65 20 63 72 65 61 74 65 64 20  es were created 
12e0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 75 70  automatically up
12f0: 6f 6e 20 73 74 6f 72 69 6e 67 0a 74 68 65 20 66  on storing.the f
1300: 69 72 73 74 20 76 61 6c 75 65 20 69 6e 20 74 68  irst value in th
1310: 65 6d 2e 20 20 4e 6f 77 2c 20 74 68 65 72 65 20  em.  Now, there 
1320: 69 73 20 74 68 65 20 7a 64 62 63 20 74 6f 6f 6c  is the zdbc tool
1330: 20 64 65 64 69 63 61 74 65 64 20 74 6f 0a 63 72   dedicated to.cr
1340: 65 61 74 69 6e 67 20 6e 65 77 20 64 61 74 61 62  eating new datab
1350: 61 73 65 73 2e 20 20 54 68 69 73 20 74 6f 6f 6c  ases.  This tool
1360: 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 63   allows you to c
1370: 6f 6e 74 72 6f 6c 20 73 6f 6d 65 0a 70 61 72 61  ontrol some.para
1380: 6d 65 74 65 72 73 20 6f 66 20 74 68 65 20 64 61  meters of the da
1390: 74 61 62 61 73 65 2c 20 6e 61 6d 65 6c 79 20 74  tabase, namely t
13a0: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 68 61 73  he number of has
13b0: 68 20 62 75 63 6b 65 74 73 20 61 6e 64 20 74 68  h buckets and th
13c0: 65 0a 73 69 7a 65 20 6f 66 20 74 68 65 20 6d 65  e.size of the me
13d0: 6d 6f 72 79 2d 6d 61 70 70 65 64 20 72 65 67 69  mory-mapped regi
13e0: 6f 6e 20 74 68 61 74 20 69 74 20 75 73 65 73 2e  on that it uses.
13f0: 20 20 41 73 20 61 20 72 65 73 75 6c 74 2c 20 7a    As a result, z
1400: 64 62 73 20 77 69 6c 6c 0a 6e 6f 20 6c 6f 6e 67  dbs will.no long
1410: 65 72 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  er automatically
1420: 20 63 72 65 61 74 65 20 6e 65 77 20 64 61 74 61   create new data
1430: 62 61 73 65 73 2e 0a 2a 2a 2a 20 4e 65 77 20 2d  bases..*** New -
1440: 2d 76 65 72 62 6f 73 65 20 6d 6f 64 65 0a 41 6c  -verbose mode.Al
1450: 6c 20 74 6f 6f 6c 73 20 6e 6f 77 20 68 61 76 65  l tools now have
1460: 20 61 20 2d 2d 76 65 72 62 6f 73 65 20 6f 70 74   a --verbose opt
1470: 69 6f 6e 2c 20 77 68 69 63 68 20 63 61 75 73 65  ion, which cause
1480: 73 20 74 68 65 6d 20 74 6f 20 64 69 73 70 6c 61  s them to displa
1490: 79 0a 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69  y.more informati
14a0: 6f 6e 20 77 68 69 6c 65 20 74 68 65 79 20 77 6f  on while they wo
14b0: 72 6b 2e 20 20 54 68 69 73 20 69 73 20 70 61 72  rk.  This is par
14c0: 74 69 63 75 6c 61 72 6c 79 20 68 61 6e 64 79 20  ticularly handy 
14d0: 77 68 65 6e 0a 79 6f 75 20 61 72 65 20 77 6f 72  when.you are wor
14e0: 6b 69 6e 67 20 77 69 74 68 20 74 68 6f 75 73 61  king with thousa
14f0: 6e 64 73 20 6f 66 20 65 6e 74 72 69 65 73 2e 0a  nds of entries..
1500: 2a 2a 2a 20 47 65 6e 65 72 61 6c 20 63 6f 64 65  *** General code
1510: 20 72 65 66 61 63 74 6f 72 69 6e 67 0a 54 6f 20   refactoring.To 
1520: 63 6c 65 61 6e 6c 79 20 68 61 6e 64 6c 65 20 74  cleanly handle t
1530: 68 65 20 74 77 6f 20 44 42 4d 20 62 61 63 6b 2d  he two DBM back-
1540: 65 6e 64 73 2c 20 74 68 65 20 63 6f 64 65 20 77  ends, the code w
1550: 61 73 20 73 69 67 6e 69 66 69 63 61 6e 74 6c 79  as significantly
1560: 0a 72 65 66 61 63 74 6f 72 65 64 2c 20 6d 61 6b  .refactored, mak
1570: 69 6e 67 20 69 74 20 65 61 73 69 65 72 20 74 6f  ing it easier to
1580: 20 72 65 61 64 20 61 6e 64 20 65 64 69 74 2e 0a   read and edit..
1590: 2a 2a 20 76 31 2e 31 20 28 31 30 20 4a 75 6e 65  ** v1.1 (10 June
15a0: 20 32 30 31 33 29 0a 2a 2a 2a 20 7a 65 70 74 6f   2013).*** zepto
15b0: 64 62 20 6e 6f 77 20 75 73 65 73 20 67 6e 75 6c  db now uses gnul
15c0: 69 62 20 66 6f 72 20 70 6f 72 74 61 62 69 6c 69  ib for portabili
15d0: 74 79 0a 7a 65 70 74 6f 64 62 20 6d 61 6b 65 73  ty.zeptodb makes
15e0: 20 75 73 65 20 6f 66 20 73 6f 6d 65 20 68 61 6e   use of some han
15f0: 64 79 20 66 75 6e 63 74 69 6f 6e 73 20 66 72 6f  dy functions fro
1600: 6d 20 74 68 65 20 47 4e 55 20 43 20 4c 69 62 72  m the GNU C Libr
1610: 61 72 79 0a 77 68 69 63 68 20 6d 61 79 20 6e 6f  ary.which may no
1620: 74 20 62 65 20 70 72 65 73 65 6e 74 20 6f 6e 20  t be present on 
1630: 61 6c 6c 20 73 79 73 74 65 6d 73 2e 20 20 54 6f  all systems.  To
1640: 20 6d 61 6b 65 20 75 70 20 66 6f 72 20 74 68 61   make up for tha
1650: 74 2c 20 69 74 20 6e 6f 77 0a 70 72 6f 76 69 64  t, it now.provid
1660: 65 73 20 73 6f 6d 65 20 67 6e 75 6c 69 62 20 6d  es some gnulib m
1670: 6f 64 75 6c 65 73 20 77 68 69 63 68 20 70 72 6f  odules which pro
1680: 76 69 64 65 20 74 68 65 20 6d 69 73 73 69 6e 67  vide the missing
1690: 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 0a 6f   functionality.o
16a0: 6e 20 73 75 63 68 20 73 79 73 74 65 6d 73 2e 0a  n such systems..
16b0: 0a 2a 2a 20 76 31 2e 30 20 28 30 37 20 4a 75 6e  .** v1.0 (07 Jun
16c0: 65 20 32 30 31 33 29 0a 2a 2a 2a 20 46 69 72 73  e 2013).*** Firs
16d0: 74 20 72 65 6c 65 61 73 65 21 0a                 t release!.