Not logged in

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:update documentation
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1:b29d6ef0cc9f6a8be964959241df608e2b818f95
User & Date: brandon 2013-11-17 14:58:46
Context
2013-11-17
14:59
update docs check-in: 239d096001 user: brandon tags: trunk
14:58
update documentation check-in: b29d6ef0cc user: brandon tags: trunk
14:44
fix the NEWS a bit check-in: 15951d48c4 user: brandon tags: trunk
Changes

Changes to NEWS.

    44     44   GNU/Linux) distribution (zeptodb-2.0.2-x86_64.sw.tar.gz).  Both can be
    45     45   installed via the swbis tool swinstall.  The source distribution is
    46     46   automatically configured and built after it is installed with
    47     47   swinstall. The built binaries can then be installed via the swconfig
    48     48   tool:
    49     49   
    50     50       $ swinstall -s :zeptodb-2.0.2-src.sw.tar.gz @/usr/local
    51         -    [configure output]
           51  +    [configure and make build output]
    52     52       $ swconfig zeptodb @/usr/local
    53         -    [make
           53  +    [make install output]
    54     54   
    55     55   The x86_64 binary distribution will require up-to-date GNU libc (2.18)
    56     56   and GDBM (1.10) libraries.  The binaries will be installed in the
    57     57   proper places at the prefix of your choice when you run swinstall.
    58     58   For example, to install to /usr/local:
    59     59   
    60     60       $ swinstall -s :zeptodb-2.0.2-x86_64.sw.tar.gz @/usr/local

Changes to www/html_node/Commands.html.

     1      1   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2      2   <html>
     3         -<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
            3  +<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
     4      4   
     5      5   Copyright (C) 2013  Brandon Invergo
     6      6   
     7      7   Permission is granted to copy, distribute and/or modify this document
     8      8   under the terms of the GNU Free Documentation License, Version 1.3
     9      9   or any later version published by the Free Software Foundation;
    10     10   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
    14     14   A copy of the license is also available from the Free Software
    15     15   Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16     16   
    17     17   
    18     18   The document was typeset with
    19     19   http://www.texinfo.org/ (GNU Texinfo).
    20     20    -->
    21         -<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: Commands</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: Commands">
    26     26   <meta name="keywords" content="zeptodb: Commands">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
................................................................................
    29     29   <meta name="Generator" content="makeinfo">
    30     30   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31     31   <link href="index.html#Top" rel="start" title="Top">
    32     32   <link href="Index.html#Index" rel="index" title="Index">
    33     33   <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    34     34   <link href="index.html#Top" rel="up" title="Top">
    35     35   <link href="zdbc.html#zdbc" rel="next" title="zdbc">
    36         -<link href="Back_002dends.html#Back_002dends" rel="previous" title="Back-ends">
           36  +<link href="Back_002dends.html#Back_002dends" rel="prev" title="Back-ends">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
    40     40   blockquote.smallquotation {font-size: smaller}
    41     41   div.display {margin-left: 3.2em}
    42     42   div.example {margin-left: 3.2em}
    43     43   div.indentedblock {margin-left: 3.2em}
................................................................................
    66     66   
    67     67   </head>
    68     68   
    69     69   <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    70     70   <a name="Commands"></a>
    71     71   <div class="header">
    72     72   <p>
    73         -Next: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="n" rel="next">Copying This Manual</a>, Previous: <a href="Introduction.html#Introduction" accesskey="p" rel="previous">Introduction</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
           73  +Next: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="n" rel="next">Copying This Manual</a>, Previous: <a href="Introduction.html#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
    74     74   </div>
    75     75   <hr>
    76     76   <a name="Commands-1"></a>
    77     77   <h2 class="chapter">2 Commands</h2>
    78     78   
    79     79   <p>Three commands are provided with zeptodb: <code>zdbs</code>, for creating
    80     80   databases and storing records in them; <code>zdbf</code>, for fetching
    81     81   records from databases; and <code>zdbr</code>, for removing records from
    82         -databases. 
           82  +databases.
    83     83   </p>
    84     84   <table class="menu" border="0" cellspacing="0">
    85     85   <tr><td align="left" valign="top">&bull; <a href="zdbc.html#zdbc" accesskey="1">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
    86     86   </td></tr>
    87     87   <tr><td align="left" valign="top">&bull; <a href="zdbs.html#zdbs" accesskey="2">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
    88     88   </td></tr>
    89     89   <tr><td align="left" valign="top">&bull; <a href="zdbf.html#zdbf" accesskey="3">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">

Changes to www/html_node/Copying-This-Manual.html.

     1      1   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2      2   <html>
     3         -<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
            3  +<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
     4      4   
     5      5   Copyright (C) 2013  Brandon Invergo
     6      6   
     7      7   Permission is granted to copy, distribute and/or modify this document
     8      8   under the terms of the GNU Free Documentation License, Version 1.3
     9      9   or any later version published by the Free Software Foundation;
    10     10   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
    14     14   A copy of the license is also available from the Free Software
    15     15   Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16     16   
    17     17   
    18     18   The document was typeset with
    19     19   http://www.texinfo.org/ (GNU Texinfo).
    20     20    -->
    21         -<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: Copying This Manual</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: Copying This Manual">
    26     26   <meta name="keywords" content="zeptodb: Copying This Manual">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
................................................................................
    29     29   <meta name="Generator" content="makeinfo">
    30     30   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31     31   <link href="index.html#Top" rel="start" title="Top">
    32     32   <link href="Index.html#Index" rel="index" title="Index">
    33     33   <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    34     34   <link href="index.html#Top" rel="up" title="Top">
    35     35   <link href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License" rel="next" title="GNU Free Documentation License">
    36         -<link href="zdbr.html#zdbr" rel="previous" title="zdbr">
           36  +<link href="zdbr.html#zdbr" rel="prev" title="zdbr">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
    40     40   blockquote.smallquotation {font-size: smaller}
    41     41   div.display {margin-left: 3.2em}
    42     42   div.example {margin-left: 3.2em}
    43     43   div.indentedblock {margin-left: 3.2em}
................................................................................
    66     66   
    67     67   </head>
    68     68   
    69     69   <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    70     70   <a name="Copying-This-Manual"></a>
    71     71   <div class="header">
    72     72   <p>
    73         -Next: <a href="Index.html#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="Commands.html#Commands" accesskey="p" rel="previous">Commands</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
           73  +Next: <a href="Index.html#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="Commands.html#Commands" accesskey="p" rel="prev">Commands</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
    74     74   </div>
    75     75   <hr>
    76     76   <a name="Copying-This-Manual-1"></a>
    77     77   <h2 class="appendix">Appendix A Copying This Manual</h2>
    78     78   
    79     79   <table class="menu" border="0" cellspacing="0">
    80     80   <tr><td align="left" valign="top">&bull; <a href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License" accesskey="1">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.

Changes to www/html_node/GNU-Free-Documentation-License.html.

     1      1   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2      2   <html>
     3         -<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
            3  +<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
     4      4   
     5      5   Copyright (C) 2013  Brandon Invergo
     6      6   
     7      7   Permission is granted to copy, distribute and/or modify this document
     8      8   under the terms of the GNU Free Documentation License, Version 1.3
     9      9   or any later version published by the Free Software Foundation;
    10     10   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
    14     14   A copy of the license is also available from the Free Software
    15     15   Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16     16   
    17     17   
    18     18   The document was typeset with
    19     19   http://www.texinfo.org/ (GNU Texinfo).
    20     20    -->
    21         -<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: GNU Free Documentation License</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: GNU Free Documentation License">
    26     26   <meta name="keywords" content="zeptodb: GNU Free Documentation License">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
................................................................................
    29     29   <meta name="Generator" content="makeinfo">
    30     30   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31     31   <link href="index.html#Top" rel="start" title="Top">
    32     32   <link href="Index.html#Index" rel="index" title="Index">
    33     33   <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    34     34   <link href="Copying-This-Manual.html#Copying-This-Manual" rel="up" title="Copying This Manual">
    35     35   <link href="Index.html#Index" rel="next" title="Index">
    36         -<link href="Copying-This-Manual.html#Copying-This-Manual" rel="previous" title="Copying This Manual">
           36  +<link href="Copying-This-Manual.html#Copying-This-Manual" rel="prev" title="Copying This Manual">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
    40     40   blockquote.smallquotation {font-size: smaller}
    41     41   div.display {margin-left: 3.2em}
    42     42   div.example {margin-left: 3.2em}
    43     43   div.indentedblock {margin-left: 3.2em}
................................................................................
    66     66   
    67     67   </head>
    68     68   
    69     69   <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    70     70   <a name="GNU-Free-Documentation-License"></a>
    71     71   <div class="header">
    72     72   <p>
    73         -Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="previous">Copying This Manual</a>, Up: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
           73  +Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
    74     74   </div>
    75     75   <hr>
    76     76   <a name="GNU-Free-Documentation-License-1"></a>
    77     77   <h3 class="section">A.1 GNU Free Documentation License</h3>
    78     78   <div align="center">Version 1.3, 3 November 2008
    79     79   </div>
    80     80   
................................................................................
   544    544   to permit their use in free software.
   545    545   </p>
   546    546   
   547    547   
   548    548   <hr>
   549    549   <div class="header">
   550    550   <p>
   551         -Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="previous">Copying This Manual</a>, Up: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
          551  +Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
   552    552   </div>
   553    553   
   554    554   
   555    555   
   556    556   </body>
   557    557   </html>

Changes to www/html_node/Index.html.

     1      1   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2      2   <html>
     3         -<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
            3  +<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
     4      4   
     5      5   Copyright (C) 2013  Brandon Invergo
     6      6   
     7      7   Permission is granted to copy, distribute and/or modify this document
     8      8   under the terms of the GNU Free Documentation License, Version 1.3
     9      9   or any later version published by the Free Software Foundation;
    10     10   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
    14     14   A copy of the license is also available from the Free Software
    15     15   Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16     16   
    17     17   
    18     18   The document was typeset with
    19     19   http://www.texinfo.org/ (GNU Texinfo).
    20     20    -->
    21         -<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: Index</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: Index">
    26     26   <meta name="keywords" content="zeptodb: Index">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
    29     29   <meta name="Generator" content="makeinfo">
    30     30   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31     31   <link href="index.html#Top" rel="start" title="Top">
    32     32   <link href="#Index" rel="index" title="Index">
    33     33   <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    34     34   <link href="index.html#Top" rel="up" title="Top">
    35         -<link href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License" rel="previous" title="GNU Free Documentation License">
           35  +<link href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License" rel="prev" title="GNU Free Documentation License">
    36     36   <style type="text/css">
    37     37   <!--
    38     38   a.summary-letter {text-decoration: none}
    39     39   blockquote.smallquotation {font-size: smaller}
    40     40   div.display {margin-left: 3.2em}
    41     41   div.example {margin-left: 3.2em}
    42     42   div.indentedblock {margin-left: 3.2em}
................................................................................
    65     65   
    66     66   </head>
    67     67   
    68     68   <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    69     69   <a name="Index"></a>
    70     70   <div class="header">
    71     71   <p>
    72         -Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="previous">Copying This Manual</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
           72  +Previous: <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
    73     73   </div>
    74     74   <hr>
    75     75   <a name="Index-1"></a>
    76     76   <h2 class="unnumbered">Index</h2>
    77     77   
    78     78   
    79     79   
    80     80   
    81     81   
    82     82   </body>
    83     83   </html>

Changes to www/html_node/Introduction.html.

     1      1   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2      2   <html>
     3         -<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
            3  +<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
     4      4   
     5      5   Copyright (C) 2013  Brandon Invergo
     6      6   
     7      7   Permission is granted to copy, distribute and/or modify this document
     8      8   under the terms of the GNU Free Documentation License, Version 1.3
     9      9   or any later version published by the Free Software Foundation;
    10     10   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
    14     14   A copy of the license is also available from the Free Software
    15     15   Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16     16   
    17     17   
    18     18   The document was typeset with
    19     19   http://www.texinfo.org/ (GNU Texinfo).
    20     20    -->
    21         -<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: Introduction</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: Introduction">
    26     26   <meta name="keywords" content="zeptodb: Introduction">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
    29     29   <meta name="Generator" content="makeinfo">
    30     30   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31     31   <link href="index.html#Top" rel="start" title="Top">
    32     32   <link href="Index.html#Index" rel="index" title="Index">
    33     33   <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    34     34   <link href="index.html#Top" rel="up" title="Top">
    35         -<link href="Back_002dends.html#Back_002dends" rel="next" title="Back-ends">
    36         -<link href="index.html#Top" rel="previous" title="Top">
           35  +<link href="Tutorial.html#Tutorial" rel="next" title="Tutorial">
           36  +<link href="index.html#Top" rel="prev" title="Top">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
    40     40   blockquote.smallquotation {font-size: smaller}
    41     41   div.display {margin-left: 3.2em}
    42     42   div.example {margin-left: 3.2em}
    43     43   div.indentedblock {margin-left: 3.2em}
................................................................................
    66     66   
    67     67   </head>
    68     68   
    69     69   <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    70     70   <a name="Introduction"></a>
    71     71   <div class="header">
    72     72   <p>
    73         -Next: <a href="Commands.html#Commands" accesskey="n" rel="next">Commands</a>, Previous: <a href="index.html#Top" accesskey="p" rel="previous">Top</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
           73  +Next: <a href="Commands.html#Commands" accesskey="n" rel="next">Commands</a>, Previous: <a href="index.html#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
    74     74   </div>
    75     75   <hr>
    76     76   <a name="Introduction-1"></a>
    77     77   <h2 class="chapter">1 Introduction</h2>
    78     78   
    79         -<p>zeptodb is a small collection of relatively tiny tools for interacting
    80         -with flat (non-relational) databases.  In fact, they are merely
    81         -minimal command-line tools implementing the functionality of a DBM
    82         -library.  Thus, the databases they manipulate are simple, key-value
    83         -hash tables.
           79  +<p>zeptodb is a small collection of relatively tiny command-line tools for
           80  +interacting with DBM databases.  For the uninitiated, DBM databases are
           81  +flat (non-relational) a databases; in other words, they are persistent
           82  +key-value hash tables. Typically they are created via a library for C,
           83  +Python, Perl, etc. These tools fill in a gap by providing useful
           84  +command-line tools. Some DBM libraries come with really basic binaries
           85  +for manipulating the databases, but they are not designed to be very
           86  +flexible or useful in the real world.
    84     87   </p>
    85     88   <p>These tools may be helpful in scripts, for example, when persistant
    86     89   data storage is needed but when a full database would be overkill.
    87     90   They may also be useful if, for whatever reason, one would like to
    88     91   manipulate, via the command-line or scripts, DBM databases created by
    89     92   other programs.
    90     93   </p>
    91     94   <table class="menu" border="0" cellspacing="0">
    92         -<tr><td align="left" valign="top">&bull; <a href="Back_002dends.html#Back_002dends" accesskey="1">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
           95  +<tr><td align="left" valign="top">&bull; <a href="Tutorial.html#Tutorial" accesskey="1">Tutorial</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
           96  +</td></tr>
           97  +<tr><td align="left" valign="top">&bull; <a href="Back_002dends.html#Back_002dends" accesskey="2">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
    93     98   </td></tr>
    94     99   </table>
    95    100   
    96    101   
    97    102   
    98    103   
    99    104   </body>
   100    105   </html>

Changes to www/html_node/index.html.

     1      1   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2      2   <html>
     3         -<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
            3  +<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
     4      4   
     5      5   Copyright (C) 2013  Brandon Invergo
     6      6   
     7      7   Permission is granted to copy, distribute and/or modify this document
     8      8   under the terms of the GNU Free Documentation License, Version 1.3
     9      9   or any later version published by the Free Software Foundation;
    10     10   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
    14     14   A copy of the license is also available from the Free Software
    15     15   Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16     16   
    17     17   
    18     18   The document was typeset with
    19     19   http://www.texinfo.org/ (GNU Texinfo).
    20     20    -->
    21         -<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: Top</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: Top">
    26     26   <meta name="keywords" content="zeptodb: Top">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
................................................................................
    74     74   <h2 class="contents-heading">Table of Contents</h2>
    75     75   
    76     76   <div class="contents">
    77     77   
    78     78   <ul class="no-bullet">
    79     79     <li><a name="toc-Introduction-1" href="Introduction.html#Introduction">1 Introduction</a>
    80     80     <ul class="no-bullet">
    81         -    <li><a name="toc-Back_002dends-1" href="Back_002dends.html#Back_002dends">1.1 Back-ends</a></li>
           81  +    <li><a name="toc-Tutorial-1" href="Tutorial.html#Tutorial">1.1 Tutorial</a></li>
           82  +    <li><a name="toc-Back_002dends-1" href="Back_002dends.html#Back_002dends">1.2 Back-ends</a></li>
    82     83     </ul></li>
    83     84     <li><a name="toc-Commands-1" href="Commands.html#Commands">2 Commands</a>
    84     85     <ul class="no-bullet">
    85     86       <li><a name="toc-zdbc-1" href="zdbc.html#zdbc">2.1 zdbc</a></li>
    86     87       <li><a name="toc-zdbs-1" href="zdbs.html#zdbs">2.2 zdbs</a></li>
    87     88       <li><a name="toc-zdbf-1" href="zdbf.html#zdbf">2.3 zdbf</a></li>
    88     89       <li><a name="toc-zdbr-1" href="zdbr.html#zdbr">2.4 zdbr</a></li>
................................................................................
    95     96   </ul>
    96     97   </div>
    97     98   
    98     99   
    99    100   <a name="Top"></a>
   100    101   <div class="header">
   101    102   <p>
   102         -Next: <a href="Introduction.html#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="../dir/index.html" accesskey="p" rel="previous">(dir)</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
          103  +Next: <a href="Introduction.html#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="../dir/index.html" accesskey="p" rel="prev">(dir)</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
   103    104   </div>
   104    105   <hr>
   105    106   <a name="zeptodb"></a>
   106    107   <h1 class="top">zeptodb</h1>
   107    108   
   108         -<p>This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
          109  +<p>This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
   109    110   </p>
   110    111   <p>Copyright &copy; 2013  Brandon Invergo
   111    112   </p>
   112    113   <blockquote>
   113    114   <p>Permission is granted to copy, distribute and/or modify this document
   114    115   under the terms of the GNU Free Documentation License, Version 1.3
   115    116   or any later version published by the Free Software Foundation;
................................................................................
   137    138   <tr><td align="left" valign="top">&bull; <a href="Index.html#Index" accesskey="4">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   138    139   </td></tr>
   139    140   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
   140    141   </pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;
   141    142   
   142    143   Introduction
   143    144   
   144         -</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="Back_002dends.html#Back_002dends" accesskey="5">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          145  +</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="Tutorial.html#Tutorial" accesskey="5">Tutorial</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          146  +</td></tr>
          147  +<tr><td align="left" valign="top">&bull; <a href="Back_002dends.html#Back_002dends" accesskey="6">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   145    148   </td></tr>
   146    149   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
   147    150   Commands
   148    151   
   149         -</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="zdbc.html#zdbc" accesskey="6">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          152  +</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="zdbc.html#zdbc" accesskey="7">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          153  +</td></tr>
          154  +<tr><td align="left" valign="top">&bull; <a href="zdbs.html#zdbs" accesskey="8">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   150    155   </td></tr>
   151         -<tr><td align="left" valign="top">&bull; <a href="zdbs.html#zdbs" accesskey="7">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          156  +<tr><td align="left" valign="top">&bull; <a href="zdbf.html#zdbf" accesskey="9">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   152    157   </td></tr>
   153         -<tr><td align="left" valign="top">&bull; <a href="zdbf.html#zdbf" accesskey="8">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   154         -</td></tr>
   155         -<tr><td align="left" valign="top">&bull; <a href="zdbr.html#zdbr" accesskey="9">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          158  +<tr><td align="left" valign="top">&bull; <a href="zdbr.html#zdbr">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   156    159   </td></tr>
   157    160   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
   158    161   Copying This Manual
   159    162   
   160    163   </pre></th></tr><tr><td align="left" valign="top">&bull; <a href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.
   161    164   </td></tr>
   162    165   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
   163    166   </pre></th></tr></table>
   164    167   
   165    168   <hr>
   166    169   <div class="header">
   167    170   <p>
   168         -Next: <a href="Introduction.html#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="../dir/index.html" accesskey="p" rel="previous">(dir)</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
          171  +Next: <a href="Introduction.html#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="../dir/index.html" accesskey="p" rel="prev">(dir)</a>, Up: <a href="../dir/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
   169    172   </div>
   170    173   
   171    174   
   172    175   
   173    176   </body>
   174    177   </html>

Changes to www/html_node/zdbf.html.

     1      1   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2      2   <html>
     3         -<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
            3  +<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
     4      4   
     5      5   Copyright (C) 2013  Brandon Invergo
     6      6   
     7      7   Permission is granted to copy, distribute and/or modify this document
     8      8   under the terms of the GNU Free Documentation License, Version 1.3
     9      9   or any later version published by the Free Software Foundation;
    10     10   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
    14     14   A copy of the license is also available from the Free Software
    15     15   Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16     16   
    17     17   
    18     18   The document was typeset with
    19     19   http://www.texinfo.org/ (GNU Texinfo).
    20     20    -->
    21         -<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: zdbf</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: zdbf">
    26     26   <meta name="keywords" content="zeptodb: zdbf">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
................................................................................
    29     29   <meta name="Generator" content="makeinfo">
    30     30   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31     31   <link href="index.html#Top" rel="start" title="Top">
    32     32   <link href="Index.html#Index" rel="index" title="Index">
    33     33   <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    34     34   <link href="Commands.html#Commands" rel="up" title="Commands">
    35     35   <link href="zdbr.html#zdbr" rel="next" title="zdbr">
    36         -<link href="zdbs.html#zdbs" rel="previous" title="zdbs">
           36  +<link href="zdbs.html#zdbs" rel="prev" title="zdbs">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
    40     40   blockquote.smallquotation {font-size: smaller}
    41     41   div.display {margin-left: 3.2em}
    42     42   div.example {margin-left: 3.2em}
    43     43   div.indentedblock {margin-left: 3.2em}
................................................................................
    66     66   
    67     67   </head>
    68     68   
    69     69   <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    70     70   <a name="zdbf"></a>
    71     71   <div class="header">
    72     72   <p>
    73         -Next: <a href="zdbr.html#zdbr" accesskey="n" rel="next">zdbr</a>, Previous: <a href="zdbs.html#zdbs" accesskey="p" rel="previous">zdbs</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
           73  +Next: <a href="zdbr.html#zdbr" accesskey="n" rel="next">zdbr</a>, Previous: <a href="zdbs.html#zdbs" accesskey="p" rel="prev">zdbs</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
    74     74   </div>
    75     75   <hr>
    76     76   <a name="zdbf-1"></a>
    77     77   <h3 class="section">2.3 zdbf</h3>
    78     78   
    79     79   <p><code>zdbf</code> is used to fetch records from a database file.  Queries
    80     80   are read from <samp>stdin</samp> or, optionally, from a text file.  Records

Changes to www/html_node/zdbr.html.

     1      1   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2      2   <html>
     3         -<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
            3  +<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
     4      4   
     5      5   Copyright (C) 2013  Brandon Invergo
     6      6   
     7      7   Permission is granted to copy, distribute and/or modify this document
     8      8   under the terms of the GNU Free Documentation License, Version 1.3
     9      9   or any later version published by the Free Software Foundation;
    10     10   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
    14     14   A copy of the license is also available from the Free Software
    15     15   Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16     16   
    17     17   
    18     18   The document was typeset with
    19     19   http://www.texinfo.org/ (GNU Texinfo).
    20     20    -->
    21         -<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: zdbr</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: zdbr">
    26     26   <meta name="keywords" content="zeptodb: zdbr">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
................................................................................
    29     29   <meta name="Generator" content="makeinfo">
    30     30   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31     31   <link href="index.html#Top" rel="start" title="Top">
    32     32   <link href="Index.html#Index" rel="index" title="Index">
    33     33   <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    34     34   <link href="Commands.html#Commands" rel="up" title="Commands">
    35     35   <link href="Copying-This-Manual.html#Copying-This-Manual" rel="next" title="Copying This Manual">
    36         -<link href="zdbf.html#zdbf" rel="previous" title="zdbf">
           36  +<link href="zdbf.html#zdbf" rel="prev" title="zdbf">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
    40     40   blockquote.smallquotation {font-size: smaller}
    41     41   div.display {margin-left: 3.2em}
    42     42   div.example {margin-left: 3.2em}
    43     43   div.indentedblock {margin-left: 3.2em}
................................................................................
    66     66   
    67     67   </head>
    68     68   
    69     69   <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    70     70   <a name="zdbr"></a>
    71     71   <div class="header">
    72     72   <p>
    73         -Previous: <a href="zdbf.html#zdbf" accesskey="p" rel="previous">zdbf</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
           73  +Previous: <a href="zdbf.html#zdbf" accesskey="p" rel="prev">zdbf</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
    74     74   </div>
    75     75   <hr>
    76     76   <a name="zdbr-1"></a>
    77     77   <h3 class="section">2.4 zdbr</h3>
    78     78   
    79     79   <p><code>zdbr</code> is used to remove records from a database.  The records
    80     80   to be removed are specified by their keys and are entered via

Changes to www/html_node/zdbs.html.

     1      1   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2      2   <html>
     3         -<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
            3  +<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
     4      4   
     5      5   Copyright (C) 2013  Brandon Invergo
     6      6   
     7      7   Permission is granted to copy, distribute and/or modify this document
     8      8   under the terms of the GNU Free Documentation License, Version 1.3
     9      9   or any later version published by the Free Software Foundation;
    10     10   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
    14     14   A copy of the license is also available from the Free Software
    15     15   Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16     16   
    17     17   
    18     18   The document was typeset with
    19     19   http://www.texinfo.org/ (GNU Texinfo).
    20     20    -->
    21         -<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: zdbs</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: zdbs">
    26     26   <meta name="keywords" content="zeptodb: zdbs">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
................................................................................
    29     29   <meta name="Generator" content="makeinfo">
    30     30   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31     31   <link href="index.html#Top" rel="start" title="Top">
    32     32   <link href="Index.html#Index" rel="index" title="Index">
    33     33   <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    34     34   <link href="Commands.html#Commands" rel="up" title="Commands">
    35     35   <link href="zdbf.html#zdbf" rel="next" title="zdbf">
    36         -<link href="zdbc.html#zdbc" rel="previous" title="zdbc">
           36  +<link href="zdbc.html#zdbc" rel="prev" title="zdbc">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
    40     40   blockquote.smallquotation {font-size: smaller}
    41     41   div.display {margin-left: 3.2em}
    42     42   div.example {margin-left: 3.2em}
    43     43   div.indentedblock {margin-left: 3.2em}
................................................................................
    66     66   
    67     67   </head>
    68     68   
    69     69   <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    70     70   <a name="zdbs"></a>
    71     71   <div class="header">
    72     72   <p>
    73         -Next: <a href="zdbf.html#zdbf" accesskey="n" rel="next">zdbf</a>, Previous: <a href="zdbc.html#zdbc" accesskey="p" rel="previous">zdbc</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
           73  +Next: <a href="zdbf.html#zdbf" accesskey="n" rel="next">zdbf</a>, Previous: <a href="zdbc.html#zdbc" accesskey="p" rel="prev">zdbc</a>, Up: <a href="Commands.html#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
    74     74   </div>
    75     75   <hr>
    76     76   <a name="zdbs-1"></a>
    77     77   <h3 class="section">2.2 zdbs</h3>
    78     78   
    79     79   <p><code>zdbs</code> is used to store records in a database file.  Records
    80     80   are entered via <samp>stdin</samp> or, optionally, they are read from an

Changes to www/zeptodb.dvi.gz.

cannot compute difference between binary files

Changes to www/zeptodb.html.

     1      1   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2      2   <html>
     3         -<!-- This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
            3  +<!-- This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
     4      4   
     5      5   Copyright (C) 2013  Brandon Invergo
     6      6   
     7      7   Permission is granted to copy, distribute and/or modify this document
     8      8   under the terms of the GNU Free Documentation License, Version 1.3
     9      9   or any later version published by the Free Software Foundation;
    10     10   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
................................................................................
    14     14   A copy of the license is also available from the Free Software
    15     15   Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16     16   
    17     17   
    18     18   The document was typeset with
    19     19   http://www.texinfo.org/ (GNU Texinfo).
    20     20    -->
    21         -<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb</title>
    24     24   
    25     25   <meta name="description" content="zeptodb">
    26     26   <meta name="keywords" content="zeptodb">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
................................................................................
    73     73   <h2 class="contents-heading">Table of Contents</h2>
    74     74   
    75     75   <div class="contents">
    76     76   
    77     77   <ul class="no-bullet">
    78     78     <li><a name="toc-Introduction-1" href="#Introduction">1 Introduction</a>
    79     79     <ul class="no-bullet">
    80         -    <li><a name="toc-Back_002dends-1" href="#Back_002dends">1.1 Back-ends</a></li>
           80  +    <li><a name="toc-Tutorial-1" href="#Tutorial">1.1 Tutorial</a></li>
           81  +    <li><a name="toc-Back_002dends-1" href="#Back_002dends">1.2 Back-ends</a></li>
    81     82     </ul></li>
    82     83     <li><a name="toc-Commands-1" href="#Commands">2 Commands</a>
    83     84     <ul class="no-bullet">
    84     85       <li><a name="toc-zdbc-1" href="#zdbc">2.1 zdbc</a></li>
    85     86       <li><a name="toc-zdbs-1" href="#zdbs">2.2 zdbs</a></li>
    86     87       <li><a name="toc-zdbf-1" href="#zdbf">2.3 zdbf</a></li>
    87     88       <li><a name="toc-zdbr-1" href="#zdbr">2.4 zdbr</a></li>
................................................................................
    94     95   </ul>
    95     96   </div>
    96     97   
    97     98   
    98     99   <a name="Top"></a>
    99    100   <div class="header">
   100    101   <p>
   101         -Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="previous">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          102  +Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   102    103   </div>
   103    104   <a name="zeptodb"></a>
   104    105   <h1 class="top">zeptodb</h1>
   105    106   
   106         -<p>This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
          107  +<p>This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
   107    108   </p>
   108    109   <p>Copyright &copy; 2013  Brandon Invergo
   109    110   </p>
   110    111   <blockquote>
   111    112   <p>Permission is granted to copy, distribute and/or modify this document
   112    113   under the terms of the GNU Free Documentation License, Version 1.3
   113    114   or any later version published by the Free Software Foundation;
................................................................................
   135    136   <tr><td align="left" valign="top">&bull; <a href="#Index" accesskey="4">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   136    137   </td></tr>
   137    138   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
   138    139   </pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;
   139    140   
   140    141   Introduction
   141    142   
   142         -</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Back_002dends" accesskey="5">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          143  +</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Tutorial" accesskey="5">Tutorial</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          144  +</td></tr>
          145  +<tr><td align="left" valign="top">&bull; <a href="#Back_002dends" accesskey="6">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   143    146   </td></tr>
   144    147   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
   145    148   Commands
   146    149   
   147         -</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#zdbc" accesskey="6">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          150  +</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#zdbc" accesskey="7">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          151  +</td></tr>
          152  +<tr><td align="left" valign="top">&bull; <a href="#zdbs" accesskey="8">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   148    153   </td></tr>
   149         -<tr><td align="left" valign="top">&bull; <a href="#zdbs" accesskey="7">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          154  +<tr><td align="left" valign="top">&bull; <a href="#zdbf" accesskey="9">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   150    155   </td></tr>
   151         -<tr><td align="left" valign="top">&bull; <a href="#zdbf" accesskey="8">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   152         -</td></tr>
   153         -<tr><td align="left" valign="top">&bull; <a href="#zdbr" accesskey="9">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          156  +<tr><td align="left" valign="top">&bull; <a href="#zdbr">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   154    157   </td></tr>
   155    158   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
   156    159   Copying This Manual
   157    160   
   158    161   </pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#GNU-Free-Documentation-License">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.
   159    162   </td></tr>
   160    163   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
   161    164   </pre></th></tr></table>
   162    165   
   163    166   <hr>
   164    167   <a name="Introduction"></a>
   165    168   <div class="header">
   166    169   <p>
   167         -Next: <a href="#Commands" accesskey="n" rel="next">Commands</a>, Previous: <a href="#Top" accesskey="p" rel="previous">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          170  +Next: <a href="#Commands" accesskey="n" rel="next">Commands</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   168    171   </div>
   169    172   <a name="Introduction-1"></a>
   170    173   <h2 class="chapter">1 Introduction</h2>
   171    174   
   172         -<p>zeptodb is a small collection of relatively tiny tools for interacting
   173         -with flat (non-relational) databases.  In fact, they are merely
   174         -minimal command-line tools implementing the functionality of a DBM
   175         -library.  Thus, the databases they manipulate are simple, key-value
   176         -hash tables.
          175  +<p>zeptodb is a small collection of relatively tiny command-line tools for
          176  +interacting with DBM databases.  For the uninitiated, DBM databases are
          177  +flat (non-relational) a databases; in other words, they are persistent
          178  +key-value hash tables. Typically they are created via a library for C,
          179  +Python, Perl, etc. These tools fill in a gap by providing useful
          180  +command-line tools. Some DBM libraries come with really basic binaries
          181  +for manipulating the databases, but they are not designed to be very
          182  +flexible or useful in the real world.
   177    183   </p>
   178    184   <p>These tools may be helpful in scripts, for example, when persistant
   179    185   data storage is needed but when a full database would be overkill.
   180    186   They may also be useful if, for whatever reason, one would like to
   181    187   manipulate, via the command-line or scripts, DBM databases created by
   182    188   other programs.
   183    189   </p>
   184    190   <table class="menu" border="0" cellspacing="0">
   185         -<tr><td align="left" valign="top">&bull; <a href="#Back_002dends" accesskey="1">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          191  +<tr><td align="left" valign="top">&bull; <a href="#Tutorial" accesskey="1">Tutorial</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          192  +</td></tr>
          193  +<tr><td align="left" valign="top">&bull; <a href="#Back_002dends" accesskey="2">Back-ends</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   186    194   </td></tr>
   187    195   </table>
   188    196   
          197  +<hr>
          198  +<a name="Tutorial"></a>
          199  +<div class="header">
          200  +<p>
          201  +Next: <a href="#Back_002dends" accesskey="n" rel="next">Back-ends</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          202  +</div>
          203  +<a name="Tutorial-1"></a>
          204  +<h3 class="section">1.1 Tutorial</h3>
          205  +
          206  +<p>The zeptodb tools are used to create small databases that are stored to
          207  +disk and then to store, fetch and remove records from those databases.
          208  +Note that these databases are much simpler than, say, SQL databases.
          209  +The databases follow the DBM format as created by the GDBM library
          210  +see <a href="#Back_002dends">Back-ends</a>.  Each record in a DBM database consists of a key and
          211  +a value.  All keys and values are stored as plain text, regardless of
          212  +their formats.
          213  +</p>
          214  +<p>First, you create a new database with <code>zdbc</code>:
          215  +</p>
          216  +<div class="example">
          217  +<pre class="example">$ zdbc foo.db
          218  +</pre></div>
          219  +
          220  +<p>You can customize the creation of a database in two ways.  The first is
          221  +by specifying the number of &quot;buckets&quot; that comprise the database,
          222  +specified via the <samp>-b</samp>/<samp>--num-buckets</samp> option.  A DBM
          223  +database can be imagined as a series of buckets.  When a new item is
          224  +added, an algorithm determines which bucket it belongs in based on its
          225  +value.  Likewise, the same algorithm will be used in determining the
          226  +bucket from which to fetch an item.  If each bucket only contains a
          227  +maximum of one item, then you are guaranteed to be able to find any item
          228  +in the same amount of time as any other item.  On the other hand, if the
          229  +number of buckets is smaller than the number of items, then when you go
          230  +to fetch an item from a bucket, you might then have to search through
          231  +all the items in that bucket to find the one that you want.  This might
          232  +slow you down.  On the other hand, if the number of buckets is far
          233  +greater than the maximum number of items that will be added, the
          234  +algorithm will be wasteful.  Thus it&rsquo;s best to use a number of buckets
          235  +that will be slightly greater than the expected maximum number of items.
          236  +As a rule of them, use about four times more buckets.
          237  +</p>
          238  +<p>The second option is the size (in bytes) of the memory mapped region to
          239  +use, via the <samp>-m</samp>/<samp>--mmap-size</samp> option.  While the
          240  +database is stored on the disk as a file, when it is opened by zeptodb,
          241  +some or all of that file is mapped in a one-to-one manner with a region
          242  +of virtual memory.  Thus, when the program reads from some address in
          243  +that region of memory, it reads directly from the corresponding address
          244  +in the file.  This will generally speed up reading and writing compared
          245  +to traditional file access.  If the memory-mapped region is smaller than
          246  +the size of the database, only portions of the file can be mapped at a
          247  +time, thus slowing down performance.  Therefore, it is recommended to
          248  +use a sufficiently larger value than the size of the database (taking
          249  +into account the expected number of records and the size of the data
          250  +that is expected to fill the record values).
          251  +</p>
          252  +<p>Thus, for a big database, you might do:
          253  +</p>
          254  +<div class="example">
          255  +<pre class="example">$ zdbc --num-buckets=10000 --mmap-size=512000000 big.db
          256  +</pre></div>
          257  +
          258  +<p>With the database created, you may now store values to it using
          259  +<code>zdbs</code>.  <code>zdbs</code> normally takes its input from
          260  +<samp>stdin</samp>.  It expects one record per line and for each key/value
          261  +pair to be separated by a delimiter character (&rsquo;|&rsquo; by default).  Note
          262  +that records are unique: an attempt to store a record with a
          263  +pre-existing key will overwrite that record with a new value.
          264  +</p>
          265  +<p>For example, let&rsquo;s say that you have a text file <samp>emails.txt</samp>
          266  +containing the following records:
          267  +</p>
          268  +<div class="example">
          269  +<pre class="example">Brandon|foo@example.com
          270  +Joe|bar@example.com
          271  +Mary|baz@example.com
          272  +</pre></div>
          273  +
          274  +<p>You could store the records in <samp>foo.db</samp> like so:
          275  +</p>
          276  +<div class="example">
          277  +<pre class="example">$ zdbs foo.db &lt;emails.txt
          278  +</pre></div>
          279  +
          280  +<p>Note that if you simply don&rsquo;t like shell redirections like this, you can
          281  +also use the <samp>-i</samp> or <samp>--input</samp> option to specify the input
          282  +file:
          283  +</p>
          284  +<div class="example">
          285  +<pre class="example">$ zdbs -i emails.txt foo.db
          286  +</pre></div>
          287  +
          288  +<p>Of course, it&rsquo;s more likely that you&rsquo;ll want to pipe in records from
          289  +some other process:
          290  +</p>
          291  +<div class="example">
          292  +<pre class="example">$ fancy_pipeline.sh | zdbs foo.db
          293  +</pre></div>
          294  +
          295  +<p>If your records are formatted differently, using, say, &rsquo;-&rsquo; as the
          296  +delimiter (i.e &quot;key-value&quot;), you would specify it using the <samp>-d</samp>
          297  +or <samp>--delimiter</samp> option.
          298  +</p>
          299  +<p>Records can then be fetched from the database using <code>zdbf</code>.  In
          300  +this case, queries in the form of keys with one key per line are read
          301  +from <samp>stdin</samp>:
          302  +</p>
          303  +<div class="example">
          304  +<pre class="example">$ zdbf foo.db
          305  +Brandon
          306  +foo@example.com
          307  +Joe
          308  +bar@example.com
          309  +Jon
          310  +../trunk/src/zdbf: Key does not exist in the database: Jon: Invalid argument
          311  +</pre></div>
          312  +
          313  +<p>As with <code>zdbs</code>, you can also specify a file containing the
          314  +queries using the <samp>-i</samp> option or you can read them in through a
          315  +pipe.
          316  +</p>
          317  +<p>If you would prefer the output to include the key, you must specify your
          318  +desired delimiter using the <samp>-d</samp> option:
          319  +</p>
          320  +<div class="example">
          321  +<pre class="example">$ echo Brandon | zdbf -d':' foo.db
          322  +Brandon:foo@example.com
          323  +</pre></div>
          324  +
          325  +<p>Finally, you can dump out all of the contents of the database using the
          326  +<samp>-a</samp> option.  Note that the order of the records is in no way
          327  +guaranteed.
          328  +</p>
          329  +<div class="example">
          330  +<pre class="example">$ zdbf -d'|' -a foo.db
          331  +Joe|bar@example.com
          332  +Brandon|foo@example.com
          333  +Mary|baz@example.com
          334  +</pre></div>
          335  +
          336  +<p>Records may then be removed from the database using <code>zdbr</code>.
          337  +<code>zdbr</code> operates in a very similar way to <code>zdbf</code>:
          338  +</p>
          339  +<div class="example">
          340  +<pre class="example">$ zdbr foo.db &lt;&lt;EOF
          341  +&gt; Brandon
          342  +&gt; Joe
          343  +&gt; EOF
          344  +$ zdbf -a -d'|' foo.db
          345  +Mary|baz@example.com
          346  +</pre></div>
          347  +
   189    348   <hr>
   190    349   <a name="Back_002dends"></a>
   191    350   <div class="header">
   192    351   <p>
   193         -Previous: <a href="#Introduction" accesskey="p" rel="previous">Introduction</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          352  +Previous: <a href="#Tutorial" accesskey="p" rel="prev">Tutorial</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   194    353   </div>
   195    354   <a name="Back_002dends-1"></a>
   196         -<h3 class="section">1.1 Back-ends</h3>
          355  +<h3 class="section">1.2 Back-ends</h3>
   197    356   
   198    357   <p>By default, zeptodb uses the <a href="http://www.gnu.org/software/gdb">GNU dbm</a> (GDBM) library to create and manipulate the DBM databases.
   199    358   Alternatively, you may choose to use the
   200    359   <a href="http://fallabs.com/kyotocabinet/">Kyoto Cabinet</a> library
   201    360   instead.  This is specified by passing the
   202    361   <samp>--with-kyotocabinet</samp> option to the <samp>configure</samp> script
   203    362   before compiling zeptodb.
................................................................................
   218    377   not as widely available in GNU/Linux distributions as GDBM so it often
   219    378   must be installed manually.
   220    379   </p>
   221    380   <hr>
   222    381   <a name="Commands"></a>
   223    382   <div class="header">
   224    383   <p>
   225         -Next: <a href="#Copying-This-Manual" accesskey="n" rel="next">Copying This Manual</a>, Previous: <a href="#Introduction" accesskey="p" rel="previous">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          384  +Next: <a href="#Copying-This-Manual" accesskey="n" rel="next">Copying This Manual</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   226    385   </div>
   227    386   <a name="Commands-1"></a>
   228    387   <h2 class="chapter">2 Commands</h2>
   229    388   
   230    389   <p>Three commands are provided with zeptodb: <code>zdbs</code>, for creating
   231    390   databases and storing records in them; <code>zdbf</code>, for fetching
   232    391   records from databases; and <code>zdbr</code>, for removing records from
   233         -databases. 
          392  +databases.
   234    393   </p>
   235    394   <table class="menu" border="0" cellspacing="0">
   236    395   <tr><td align="left" valign="top">&bull; <a href="#zdbc" accesskey="1">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   237    396   </td></tr>
   238    397   <tr><td align="left" valign="top">&bull; <a href="#zdbs" accesskey="2">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   239    398   </td></tr>
   240    399   <tr><td align="left" valign="top">&bull; <a href="#zdbf" accesskey="3">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
................................................................................
   244    403   </table>
   245    404   
   246    405   
   247    406   <hr>
   248    407   <a name="zdbc"></a>
   249    408   <div class="header">
   250    409   <p>
   251         -Next: <a href="#zdbs" accesskey="n" rel="next">zdbs</a>, Previous: <a href="#Commands" accesskey="p" rel="previous">Commands</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          410  +Next: <a href="#zdbs" accesskey="n" rel="next">zdbs</a>, Previous: <a href="#Commands" accesskey="p" rel="prev">Commands</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   252    411   </div>
   253    412   <a name="zdbc-1"></a>
   254    413   <h3 class="section">2.1 zdbc</h3>
   255    414   
   256    415   <p><code>zdbc</code> is used to create a new database file.  It accepts two
   257    416   options, one to choose the number of buckets for the database and the
   258    417   other to choose the size of the memory-mapped region.  These options
................................................................................
   294    453   </p></dd>
   295    454   </dl>
   296    455   
   297    456   <hr>
   298    457   <a name="zdbs"></a>
   299    458   <div class="header">
   300    459   <p>
   301         -Next: <a href="#zdbf" accesskey="n" rel="next">zdbf</a>, Previous: <a href="#zdbc" accesskey="p" rel="previous">zdbc</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          460  +Next: <a href="#zdbf" accesskey="n" rel="next">zdbf</a>, Previous: <a href="#zdbc" accesskey="p" rel="prev">zdbc</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   302    461   </div>
   303    462   <a name="zdbs-1"></a>
   304    463   <h3 class="section">2.2 zdbs</h3>
   305    464   
   306    465   <p><code>zdbs</code> is used to store records in a database file.  Records
   307    466   are entered via <samp>stdin</samp> or, optionally, they are read from an
   308    467   input file, with one record per line.  Each record should consist of
................................................................................
   338    497   </p></dd>
   339    498   </dl>
   340    499   
   341    500   <hr>
   342    501   <a name="zdbf"></a>
   343    502   <div class="header">
   344    503   <p>
   345         -Next: <a href="#zdbr" accesskey="n" rel="next">zdbr</a>, Previous: <a href="#zdbs" accesskey="p" rel="previous">zdbs</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          504  +Next: <a href="#zdbr" accesskey="n" rel="next">zdbr</a>, Previous: <a href="#zdbs" accesskey="p" rel="prev">zdbs</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   346    505   </div>
   347    506   <a name="zdbf-1"></a>
   348    507   <h3 class="section">2.3 zdbf</h3>
   349    508   
   350    509   <p><code>zdbf</code> is used to fetch records from a database file.  Queries
   351    510   are read from <samp>stdin</samp> or, optionally, from a text file.  Records
   352    511   with key values that match the queries will be printed to
................................................................................
   389    548   </p></dd>
   390    549   </dl>
   391    550   
   392    551   <hr>
   393    552   <a name="zdbr"></a>
   394    553   <div class="header">
   395    554   <p>
   396         -Previous: <a href="#zdbf" accesskey="p" rel="previous">zdbf</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          555  +Previous: <a href="#zdbf" accesskey="p" rel="prev">zdbf</a>, Up: <a href="#Commands" accesskey="u" rel="up">Commands</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   397    556   </div>
   398    557   <a name="zdbr-1"></a>
   399    558   <h3 class="section">2.4 zdbr</h3>
   400    559   
   401    560   <p><code>zdbr</code> is used to remove records from a database.  The records
   402    561   to be removed are specified by their keys and are entered via
   403    562   <samp>stdin</samp> or, optionally, they are read from a text file.  If many
................................................................................
   434    593   </p></dd>
   435    594   </dl>
   436    595   
   437    596   <hr>
   438    597   <a name="Copying-This-Manual"></a>
   439    598   <div class="header">
   440    599   <p>
   441         -Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Commands" accesskey="p" rel="previous">Commands</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          600  +Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#Commands" accesskey="p" rel="prev">Commands</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   442    601   </div>
   443    602   <a name="Copying-This-Manual-1"></a>
   444    603   <h2 class="appendix">Appendix A Copying This Manual</h2>
   445    604   
   446    605   <table class="menu" border="0" cellspacing="0">
   447    606   <tr><td align="left" valign="top">&bull; <a href="#GNU-Free-Documentation-License" accesskey="1">GNU Free Documentation License</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">License for copying this manual.
   448    607   </td></tr>
   449    608   </table>
   450    609   
   451    610   <hr>
   452    611   <a name="GNU-Free-Documentation-License"></a>
   453    612   <div class="header">
   454    613   <p>
   455         -Previous: <a href="#Copying-This-Manual" accesskey="p" rel="previous">Copying This Manual</a>, Up: <a href="#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
          614  +Previous: <a href="#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="#Copying-This-Manual" accesskey="u" rel="up">Copying This Manual</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   456    615   </div>
   457    616   <a name="GNU-Free-Documentation-License-1"></a>
   458    617   <h3 class="section">A.1 GNU Free Documentation License</h3>
   459    618   <div align="center">Version 1.3, 3 November 2008
   460    619   </div>
   461    620   
   462    621   <div class="display">
................................................................................
   926   1085   </p>
   927   1086   
   928   1087   
   929   1088   <hr>
   930   1089   <a name="Index"></a>
   931   1090   <div class="header">
   932   1091   <p>
   933         -Previous: <a href="#Copying-This-Manual" accesskey="p" rel="previous">Copying This Manual</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
         1092  +Previous: <a href="#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
   934   1093   </div>
   935   1094   <a name="Index-1"></a>
   936   1095   <h2 class="unnumbered">Index</h2>
   937   1096   
   938   1097   
   939   1098   <hr>
   940   1099   
   941   1100   
   942   1101   
   943   1102   </body>
   944   1103   </html>

Changes to www/zeptodb.html.gz.

cannot compute difference between binary files

Changes to www/zeptodb.html_node.tar.gz.

cannot compute difference between binary files

Changes to www/zeptodb.info.tar.gz.

cannot compute difference between binary files

Changes to www/zeptodb.pdf.

cannot compute difference between binary files

Changes to www/zeptodb.texi.tar.gz.

cannot compute difference between binary files

Changes to www/zeptodb.txt.

     1      1   zeptodb
     2      2   1 Introduction
     3         -  1.1 Back-ends
            3  +  1.1 Tutorial
            4  +  1.2 Back-ends
     4      5   2 Commands
     5      6     2.1 zdbc
     6      7     2.2 zdbs
     7      8     2.3 zdbf
     8      9     2.4 zdbr
     9     10   Appendix A Copying This Manual
    10     11     A.1 GNU Free Documentation License
    11     12   Index
    12     13   zeptodb
    13     14   *******
    14     15   
    15         -This manual is for zeptodb (version 2.0.1, updated 3 July 2013).
           16  +This manual is for zeptodb (version 2.0.2, updated 13 November 2013).
    16     17   
    17     18      Copyright (C) 2013 Brandon Invergo
    18     19   
    19     20        Permission is granted to copy, distribute and/or modify this
    20     21        document under the terms of the GNU Free Documentation License,
    21     22        Version 1.3 or any later version published by the Free Software
    22     23        Foundation; with no Invariant Sections, no Front-Cover Texts, and
................................................................................
    27     28        Foundation Web site at <http://www.gnu.org/licenses/fdl.html>.
    28     29   
    29     30      The document was typeset with GNU Texinfo (http://www.texinfo.org/).
    30     31   
    31     32   1 Introduction
    32     33   **************
    33     34   
    34         -zeptodb is a small collection of relatively tiny tools for interacting
    35         -with flat (non-relational) databases.  In fact, they are merely minimal
    36         -command-line tools implementing the functionality of a DBM library.
    37         -Thus, the databases they manipulate are simple, key-value hash tables.
           35  +zeptodb is a small collection of relatively tiny command-line tools for
           36  +interacting with DBM databases.  For the uninitiated, DBM databases are
           37  +flat (non-relational) a databases; in other words, they are persistent
           38  +key-value hash tables.  Typically they are created via a library for C,
           39  +Python, Perl, etc.  These tools fill in a gap by providing useful
           40  +command-line tools.  Some DBM libraries come with really basic binaries
           41  +for manipulating the databases, but they are not designed to be very
           42  +flexible or useful in the real world.
    38     43   
    39     44      These tools may be helpful in scripts, for example, when persistant
    40     45   data storage is needed but when a full database would be overkill.  They
    41     46   may also be useful if, for whatever reason, one would like to
    42     47   manipulate, via the command-line or scripts, DBM databases created by
    43     48   other programs.
    44     49   
    45         -1.1 Back-ends
           50  +1.1 Tutorial
           51  +============
           52  +
           53  +The zeptodb tools are used to create small databases that are stored to
           54  +disk and then to store, fetch and remove records from those databases.
           55  +Note that these databases are much simpler than, say, SQL databases.
           56  +The databases follow the DBM format as created by the GDBM library *note
           57  +Back-ends::.  Each record in a DBM database consists of a key and a
           58  +value.  All keys and values are stored as plain text, regardless of
           59  +their formats.
           60  +
           61  +   First, you create a new database with 'zdbc':
           62  +
           63  +     $ zdbc foo.db
           64  +
           65  +   You can customize the creation of a database in two ways.  The first
           66  +is by specifying the number of "buckets" that comprise the database,
           67  +specified via the '-b'/'--num-buckets' option.  A DBM database can be
           68  +imagined as a series of buckets.  When a new item is added, an algorithm
           69  +determines which bucket it belongs in based on its value.  Likewise, the
           70  +same algorithm will be used in determining the bucket from which to
           71  +fetch an item.  If each bucket only contains a maximum of one item, then
           72  +you are guaranteed to be able to find any item in the same amount of
           73  +time as any other item.  On the other hand, if the number of buckets is
           74  +smaller than the number of items, then when you go to fetch an item from
           75  +a bucket, you might then have to search through all the items in that
           76  +bucket to find the one that you want.  This might slow you down.  On the
           77  +other hand, if the number of buckets is far greater than the maximum
           78  +number of items that will be added, the algorithm will be wasteful.
           79  +Thus it's best to use a number of buckets that will be slightly greater
           80  +than the expected maximum number of items.  As a rule of them, use about
           81  +four times more buckets.
           82  +
           83  +   The second option is the size (in bytes) of the memory mapped region
           84  +to use, via the '-m'/'--mmap-size' option.  While the database is stored
           85  +on the disk as a file, when it is opened by zeptodb, some or all of that
           86  +file is mapped in a one-to-one manner with a region of virtual memory.
           87  +Thus, when the program reads from some address in that region of memory,
           88  +it reads directly from the corresponding address in the file.  This will
           89  +generally speed up reading and writing compared to traditional file
           90  +access.  If the memory-mapped region is smaller than the size of the
           91  +database, only portions of the file can be mapped at a time, thus
           92  +slowing down performance.  Therefore, it is recommended to use a
           93  +sufficiently larger value than the size of the database (taking into
           94  +account the expected number of records and the size of the data that is
           95  +expected to fill the record values).
           96  +
           97  +   Thus, for a big database, you might do:
           98  +
           99  +     $ zdbc --num-buckets=10000 --mmap-size=512000000 big.db
          100  +
          101  +   With the database created, you may now store values to it using
          102  +'zdbs'.  'zdbs' normally takes its input from 'stdin'.  It expects one
          103  +record per line and for each key/value pair to be separated by a
          104  +delimiter character ('|' by default).  Note that records are unique: an
          105  +attempt to store a record with a pre-existing key will overwrite that
          106  +record with a new value.
          107  +
          108  +   For example, let's say that you have a text file 'emails.txt'
          109  +containing the following records:
          110  +
          111  +     Brandon|foo@example.com
          112  +     Joe|bar@example.com
          113  +     Mary|baz@example.com
          114  +
          115  +   You could store the records in 'foo.db' like so:
          116  +
          117  +     $ zdbs foo.db <emails.txt
          118  +
          119  +   Note that if you simply don't like shell redirections like this, you
          120  +can also use the '-i' or '--input' option to specify the input file:
          121  +
          122  +     $ zdbs -i emails.txt foo.db
          123  +
          124  +   Of course, it's more likely that you'll want to pipe in records from
          125  +some other process:
          126  +
          127  +     $ fancy_pipeline.sh | zdbs foo.db
          128  +
          129  +   If your records are formatted differently, using, say, '-' as the
          130  +delimiter (i.e "key-value"), you would specify it using the '-d' or
          131  +'--delimiter' option.
          132  +
          133  +   Records can then be fetched from the database using 'zdbf'.  In this
          134  +case, queries in the form of keys with one key per line are read from
          135  +'stdin':
          136  +
          137  +     $ zdbf foo.db
          138  +     Brandon
          139  +     foo@example.com
          140  +     Joe
          141  +     bar@example.com
          142  +     Jon
          143  +     ../trunk/src/zdbf: Key does not exist in the database: Jon: Invalid argument
          144  +
          145  +   As with 'zdbs', you can also specify a file containing the queries
          146  +using the '-i' option or you can read them in through a pipe.
          147  +
          148  +   If you would prefer the output to include the key, you must specify
          149  +your desired delimiter using the '-d' option:
          150  +
          151  +     $ echo Brandon | zdbf -d':' foo.db
          152  +     Brandon:foo@example.com
          153  +
          154  +   Finally, you can dump out all of the contents of the database using
          155  +the '-a' option.  Note that the order of the records is in no way
          156  +guaranteed.
          157  +
          158  +     $ zdbf -d'|' -a foo.db
          159  +     Joe|bar@example.com
          160  +     Brandon|foo@example.com
          161  +     Mary|baz@example.com
          162  +
          163  +   Records may then be removed from the database using 'zdbr'.  'zdbr'
          164  +operates in a very similar way to 'zdbf':
          165  +
          166  +     $ zdbr foo.db <<EOF
          167  +     > Brandon
          168  +     > Joe
          169  +     > EOF
          170  +     $ zdbf -a -d'|' foo.db
          171  +     Mary|baz@example.com
          172  +
          173  +1.2 Back-ends
    46    174   =============
    47    175   
    48    176   By default, zeptodb uses the GNU dbm (http://www.gnu.org/software/gdb)
    49    177   (GDBM) library to create and manipulate the DBM databases.
    50    178   Alternatively, you may choose to use the Kyoto Cabinet
    51    179   (http://fallabs.com/kyotocabinet/) library instead.  This is specified
    52    180   by passing the '--with-kyotocabinet' option to the 'configure' script

Changes to www/zeptodb.txt.gz.

cannot compute difference between binary files