Not logged in

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

Overview
Comment:update web docs
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1:4732722534353722e7e6d7e5ae009e46b9a692aa
User & Date: brandon 2016-06-12 20:00:05
Context
2016-06-12
20:01
update web docs check-in: b6d26739c7 user: brandon tags: trunk
20:00
update web docs check-in: 4732722534 user: brandon tags: trunk
19:33
remove more swbis stuff from Makefile.am check-in: a39e686ced user: brandon tags: trunk, v3.0
Changes

Deleted www/html_node/Back_002dends.html.

     1         -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     2         -<html>
     3         -<!-- This manual is for zeptodb (version 2.0.2b, updated 17 November 2013).
     4         -
     5         -Copyright (C) 2013  Brandon Invergo
     6         -
     7         -Permission is granted to copy, distribute and/or modify this document
     8         -under the terms of the GNU Free Documentation License, Version 1.3
     9         -or any later version published by the Free Software Foundation;
    10         -with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
    11         -A copy of the license is included in the section entitled "GNU
    12         -Free Documentation License".
    13         -
    14         -A copy of the license is also available from the Free Software
    15         -Foundation Web site at http://www.gnu.org/licenses/fdl.html.
    16         -
    17         -
    18         -The document was typeset with
    19         -http://www.texinfo.org/ (GNU Texinfo).
    20         - -->
    21         -<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
    22         -<head>
    23         -<title>zeptodb: Back-ends</title>
    24         -
    25         -<meta name="description" content="zeptodb: Back-ends">
    26         -<meta name="keywords" content="zeptodb: Back-ends">
    27         -<meta name="resource-type" content="document">
    28         -<meta name="distribution" content="global">
    29         -<meta name="Generator" content="makeinfo">
    30         -<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31         -<link href="index.html#Top" rel="start" title="Top">
    32         -<link href="Index.html#Index" rel="index" title="Index">
    33         -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
    34         -<link href="Introduction.html#Introduction" rel="up" title="Introduction">
    35         -<link href="Commands.html#Commands" rel="next" title="Commands">
    36         -<link href="Tutorial.html#Tutorial" rel="prev" title="Tutorial">
    37         -<style type="text/css">
    38         -<!--
    39         -a.summary-letter {text-decoration: none}
    40         -blockquote.smallquotation {font-size: smaller}
    41         -div.display {margin-left: 3.2em}
    42         -div.example {margin-left: 3.2em}
    43         -div.indentedblock {margin-left: 3.2em}
    44         -div.lisp {margin-left: 3.2em}
    45         -div.smalldisplay {margin-left: 3.2em}
    46         -div.smallexample {margin-left: 3.2em}
    47         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    48         -div.smalllisp {margin-left: 3.2em}
    49         -kbd {font-style:oblique}
    50         -pre.display {font-family: inherit}
    51         -pre.format {font-family: inherit}
    52         -pre.menu-comment {font-family: serif}
    53         -pre.menu-preformatted {font-family: serif}
    54         -pre.smalldisplay {font-family: inherit; font-size: smaller}
    55         -pre.smallexample {font-size: smaller}
    56         -pre.smallformat {font-family: inherit; font-size: smaller}
    57         -pre.smalllisp {font-size: smaller}
    58         -span.nocodebreak {white-space:nowrap}
    59         -span.nolinebreak {white-space:nowrap}
    60         -span.roman {font-family:serif; font-weight:normal}
    61         -span.sansserif {font-family:sans-serif; font-weight:normal}
    62         -ul.no-bullet {list-style: none}
    63         --->
    64         -</style>
    65         -
    66         -
    67         -</head>
    68         -
    69         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
    70         -<a name="Back_002dends"></a>
    71         -<div class="header">
    72         -<p>
    73         -Previous: <a href="Tutorial.html#Tutorial" accesskey="p" rel="prev">Tutorial</a>, Up: <a href="Introduction.html#Introduction" accesskey="u" rel="up">Introduction</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         -</div>
    75         -<hr>
    76         -<a name="Back_002dends-1"></a>
    77         -<h3 class="section">1.2 Back-ends</h3>
    78         -
    79         -<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.
    80         -Alternatively, you may choose to use the
    81         -<a href="http://fallabs.com/kyotocabinet/">Kyoto Cabinet</a> library
    82         -instead.  This is specified by passing the
    83         -<samp>--with-kyotocabinet</samp> option to the <samp>configure</samp> script
    84         -before compiling zeptodb.
    85         -</p>
    86         -<p>Note that databases created with these two different back-ends are
    87         -<em>not</em> compatible, thus databases created with Kyoto Cabinet can
    88         -only be accessed by zeptodb if it has been compiled with support for
    89         -the library.
    90         -</p>
    91         -<p>Databases created with Kyoto Cabinet are required to have the
    92         -<samp>.kch</samp> file extension.  By convention, databases created with
    93         -GDBM should have the <samp>.db</samp> file extension.
    94         -</p>
    95         -<p>For most purposes, databases created with GDBM should be sufficient.
    96         -For particularly large data sets, however, Kyoto Cabinet is
    97         -preferred, since it can add values more quickly and has a much larger
    98         -upper limit on the database size.  On the other hand, Kyoto Cabinet is
    99         -not as widely available in GNU/Linux distributions as GDBM so it often
   100         -must be installed manually.
   101         -</p>
   102         -
   103         -
   104         -
   105         -</body>
   106         -</html>

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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, 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="prev" title="Back-ends">
           36  +<link href="Common-Options.html#Common-Options" rel="prev" title="Common Options">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
           40  +blockquote.indentedblock {margin-right: 0em}
           41  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    40     42   blockquote.smallquotation {font-size: smaller}
    41     43   div.display {margin-left: 3.2em}
    42     44   div.example {margin-left: 3.2em}
    43         -div.indentedblock {margin-left: 3.2em}
    44     45   div.lisp {margin-left: 3.2em}
    45     46   div.smalldisplay {margin-left: 3.2em}
    46     47   div.smallexample {margin-left: 3.2em}
    47         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    48     48   div.smalllisp {margin-left: 3.2em}
    49         -kbd {font-style:oblique}
           49  +kbd {font-style: oblique}
    50     50   pre.display {font-family: inherit}
    51     51   pre.format {font-family: inherit}
    52     52   pre.menu-comment {font-family: serif}
    53     53   pre.menu-preformatted {font-family: serif}
    54     54   pre.smalldisplay {font-family: inherit; font-size: smaller}
    55     55   pre.smallexample {font-size: smaller}
    56     56   pre.smallformat {font-family: inherit; font-size: smaller}
    57     57   pre.smalllisp {font-size: smaller}
    58         -span.nocodebreak {white-space:nowrap}
    59         -span.nolinebreak {white-space:nowrap}
    60         -span.roman {font-family:serif; font-weight:normal}
    61         -span.sansserif {font-family:sans-serif; font-weight:normal}
           58  +span.nolinebreak {white-space: nowrap}
           59  +span.roman {font-family: initial; font-weight: normal}
           60  +span.sansserif {font-family: sans-serif; font-weight: normal}
    62     61   ul.no-bullet {list-style: none}
    63     62   -->
    64     63   </style>
           64  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    65     65   
    66     66   
    67     67   </head>
    68     68   
    69         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           69  +<body lang="en">
    70     70   <a name="Commands"></a>
    71     71   <div class="header">
    72     72   <p>
    73     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         -<p>Three commands are provided with zeptodb: <code>zdbc</code>, for creating
           79  +<p>Five commands are provided with zeptodb: <code>zdbc</code>, for creating
    80     80   databases, <code>zdbs</code> for storing records in them, <code>zdbf</code>,
    81         -for fetching records, and <code>zdbr</code>, for removing records.
           81  +for fetching records, <code>zdbr</code>, for removing records, and
           82  +<code>zdbi</code> for displaying information about a database.
    82     83   </p>
    83     84   <table class="menu" border="0" cellspacing="0">
    84     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">
    85     86   </td></tr>
    86     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">
    87     88   </td></tr>
    88     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">
    89     90   </td></tr>
    90     91   <tr><td align="left" valign="top">&bull; <a href="zdbr.html#zdbr" accesskey="4">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
           92  +</td></tr>
           93  +<tr><td align="left" valign="top">&bull; <a href="zdbi.html#zdbi" accesskey="5">zdbi</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
    91     94   </td></tr>
    92     95   </table>
    93     96   
    94     97   
    95     98   
    96     99   
    97    100   
    98    101   </body>
    99    102   </html>

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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, 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="prev" title="zdbr">
           36  +<link href="zdbi.html#zdbi" rel="prev" title="zdbi">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
           40  +blockquote.indentedblock {margin-right: 0em}
           41  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    40     42   blockquote.smallquotation {font-size: smaller}
    41     43   div.display {margin-left: 3.2em}
    42     44   div.example {margin-left: 3.2em}
    43         -div.indentedblock {margin-left: 3.2em}
    44     45   div.lisp {margin-left: 3.2em}
    45     46   div.smalldisplay {margin-left: 3.2em}
    46     47   div.smallexample {margin-left: 3.2em}
    47         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    48     48   div.smalllisp {margin-left: 3.2em}
    49         -kbd {font-style:oblique}
           49  +kbd {font-style: oblique}
    50     50   pre.display {font-family: inherit}
    51     51   pre.format {font-family: inherit}
    52     52   pre.menu-comment {font-family: serif}
    53     53   pre.menu-preformatted {font-family: serif}
    54     54   pre.smalldisplay {font-family: inherit; font-size: smaller}
    55     55   pre.smallexample {font-size: smaller}
    56     56   pre.smallformat {font-family: inherit; font-size: smaller}
    57     57   pre.smalllisp {font-size: smaller}
    58         -span.nocodebreak {white-space:nowrap}
    59         -span.nolinebreak {white-space:nowrap}
    60         -span.roman {font-family:serif; font-weight:normal}
    61         -span.sansserif {font-family:sans-serif; font-weight:normal}
           58  +span.nolinebreak {white-space: nowrap}
           59  +span.roman {font-family: initial; font-weight: normal}
           60  +span.sansserif {font-family: sans-serif; font-weight: normal}
    62     61   ul.no-bullet {list-style: none}
    63     62   -->
    64     63   </style>
           64  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    65     65   
    66     66   
    67     67   </head>
    68     68   
    69         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           69  +<body lang="en">
    70     70   <a name="Copying-This-Manual"></a>
    71     71   <div class="header">
    72     72   <p>
    73     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>

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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, 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">
................................................................................
    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     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  +blockquote.indentedblock {margin-right: 0em}
           41  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    40     42   blockquote.smallquotation {font-size: smaller}
    41     43   div.display {margin-left: 3.2em}
    42     44   div.example {margin-left: 3.2em}
    43         -div.indentedblock {margin-left: 3.2em}
    44     45   div.lisp {margin-left: 3.2em}
    45     46   div.smalldisplay {margin-left: 3.2em}
    46     47   div.smallexample {margin-left: 3.2em}
    47         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    48     48   div.smalllisp {margin-left: 3.2em}
    49         -kbd {font-style:oblique}
           49  +kbd {font-style: oblique}
    50     50   pre.display {font-family: inherit}
    51     51   pre.format {font-family: inherit}
    52     52   pre.menu-comment {font-family: serif}
    53     53   pre.menu-preformatted {font-family: serif}
    54     54   pre.smalldisplay {font-family: inherit; font-size: smaller}
    55     55   pre.smallexample {font-size: smaller}
    56     56   pre.smallformat {font-family: inherit; font-size: smaller}
    57     57   pre.smalllisp {font-size: smaller}
    58         -span.nocodebreak {white-space:nowrap}
    59         -span.nolinebreak {white-space:nowrap}
    60         -span.roman {font-family:serif; font-weight:normal}
    61         -span.sansserif {font-family:sans-serif; font-weight:normal}
           58  +span.nolinebreak {white-space: nowrap}
           59  +span.roman {font-family: initial; font-weight: normal}
           60  +span.sansserif {font-family: sans-serif; font-weight: normal}
    62     61   ul.no-bullet {list-style: none}
    63     62   -->
    64     63   </style>
           64  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    65     65   
    66     66   
    67     67   </head>
    68     68   
    69         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           69  +<body lang="en">
    70     70   <a name="GNU-Free-Documentation-License"></a>
    71     71   <div class="header">
    72     72   <p>
    73     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>

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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, 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">
................................................................................
    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     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  +blockquote.indentedblock {margin-right: 0em}
           40  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    39     41   blockquote.smallquotation {font-size: smaller}
    40     42   div.display {margin-left: 3.2em}
    41     43   div.example {margin-left: 3.2em}
    42         -div.indentedblock {margin-left: 3.2em}
    43     44   div.lisp {margin-left: 3.2em}
    44     45   div.smalldisplay {margin-left: 3.2em}
    45     46   div.smallexample {margin-left: 3.2em}
    46         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    47     47   div.smalllisp {margin-left: 3.2em}
    48         -kbd {font-style:oblique}
           48  +kbd {font-style: oblique}
    49     49   pre.display {font-family: inherit}
    50     50   pre.format {font-family: inherit}
    51     51   pre.menu-comment {font-family: serif}
    52     52   pre.menu-preformatted {font-family: serif}
    53     53   pre.smalldisplay {font-family: inherit; font-size: smaller}
    54     54   pre.smallexample {font-size: smaller}
    55     55   pre.smallformat {font-family: inherit; font-size: smaller}
    56     56   pre.smalllisp {font-size: smaller}
    57         -span.nocodebreak {white-space:nowrap}
    58         -span.nolinebreak {white-space:nowrap}
    59         -span.roman {font-family:serif; font-weight:normal}
    60         -span.sansserif {font-family:sans-serif; font-weight:normal}
           57  +span.nolinebreak {white-space: nowrap}
           58  +span.roman {font-family: initial; font-weight: normal}
           59  +span.sansserif {font-family: sans-serif; font-weight: normal}
    61     60   ul.no-bullet {list-style: none}
    62     61   -->
    63     62   </style>
           63  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    64     64   
    65     65   
    66     66   </head>
    67     67   
    68         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           68  +<body lang="en">
    69     69   <a name="Index"></a>
    70     70   <div class="header">
    71     71   <p>
    72     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>

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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, 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">
................................................................................
    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="Tutorial.html#Tutorial" rel="next" title="Tutorial">
    36     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  +blockquote.indentedblock {margin-right: 0em}
           41  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    40     42   blockquote.smallquotation {font-size: smaller}
    41     43   div.display {margin-left: 3.2em}
    42     44   div.example {margin-left: 3.2em}
    43         -div.indentedblock {margin-left: 3.2em}
    44     45   div.lisp {margin-left: 3.2em}
    45     46   div.smalldisplay {margin-left: 3.2em}
    46     47   div.smallexample {margin-left: 3.2em}
    47         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    48     48   div.smalllisp {margin-left: 3.2em}
    49         -kbd {font-style:oblique}
           49  +kbd {font-style: oblique}
    50     50   pre.display {font-family: inherit}
    51     51   pre.format {font-family: inherit}
    52     52   pre.menu-comment {font-family: serif}
    53     53   pre.menu-preformatted {font-family: serif}
    54     54   pre.smalldisplay {font-family: inherit; font-size: smaller}
    55     55   pre.smallexample {font-size: smaller}
    56     56   pre.smallformat {font-family: inherit; font-size: smaller}
    57     57   pre.smalllisp {font-size: smaller}
    58         -span.nocodebreak {white-space:nowrap}
    59         -span.nolinebreak {white-space:nowrap}
    60         -span.roman {font-family:serif; font-weight:normal}
    61         -span.sansserif {font-family:sans-serif; font-weight:normal}
           58  +span.nolinebreak {white-space: nowrap}
           59  +span.roman {font-family: initial; font-weight: normal}
           60  +span.sansserif {font-family: sans-serif; font-weight: normal}
    62     61   ul.no-bullet {list-style: none}
    63     62   -->
    64     63   </style>
           64  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    65     65   
    66     66   
    67     67   </head>
    68     68   
    69         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           69  +<body lang="en">
    70     70   <a name="Introduction"></a>
    71     71   <div class="header">
    72     72   <p>
    73     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 command-line tools for
    80         -interacting with <em>DBM databases</em>.  For the uninitiated, DBM
    81         -databases are flat (non-relational) a databases; in other words, they
    82         -are persistent key-value hash tables. Typically they are created via a
    83         -library for C, Python, Perl, etc. These tools fill in a gap by providing
    84         -useful command-line tools. Some DBM libraries come with really basic
    85         -binaries for manipulating the databases, but they are not designed to be
    86         -very flexible or useful in the real world.
           79  +<p>zeptodb is a small collection of relatively tiny command-line tools
           80  +for interacting with <em>DBM databases</em>.  DBM databases are flat
           81  +(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.
    87     87   </p>
    88         -<p>These tools may be helpful in scripts, for example, when persistant data
    89         -storage is needed but when a full database would be overkill.  DBM
    90         -databases offer a constant look-up time for any record in them, as
           88  +<p>These tools may be helpful in scripts, for example, when persistant
           89  +data storage is needed but when a full database would be overkill.
           90  +DBM databases offer a constant look-up time for any record in them, as
    91     91   opposed to, say, searching through a text file, which scales linearly
    92         -with the number of lines in the file.  Thus, scripts requiring fast data
    93         -look-up would benefit greatly from them.  These commands may also be
    94         -useful if, for whatever reason, one would like to manipulate, via the
    95         -command-line or scripts, DBM databases created by other programs.
           92  +with the number of lines in the file.  Thus, scripts requiring fast
           93  +data look-up would benefit greatly from them (but note that, of
           94  +course, disk access is slower than memory access, so if you really
           95  +need the performance and you can fit your table in memory, these are
           96  +not the appropriate tools).  These commands may also be useful if, for
           97  +whatever reason, one would like to manipulate, via the command-line or
           98  +scripts, DBM databases created by other programs.
    96     99   </p>
    97    100   <table class="menu" border="0" cellspacing="0">
    98    101   <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">
    99    102   </td></tr>
   100         -<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">
          103  +<tr><td align="left" valign="top">&bull; <a href="Common-Options.html#Common-Options" accesskey="2">Common Options</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   101    104   </td></tr>
   102    105   </table>
   103    106   
   104    107   
   105    108   
   106    109   
   107    110   </body>
   108    111   </html>

Changes to www/html_node/Tutorial.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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: Tutorial</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: Tutorial">
    26     26   <meta name="keywords" content="zeptodb: Tutorial">
    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="Introduction.html#Introduction" rel="up" title="Introduction">
    35         -<link href="Back_002dends.html#Back_002dends" rel="next" title="Back-ends">
           35  +<link href="Common-Options.html#Common-Options" rel="next" title="Common Options">
    36     36   <link href="Introduction.html#Introduction" rel="prev" title="Introduction">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
           40  +blockquote.indentedblock {margin-right: 0em}
           41  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    40     42   blockquote.smallquotation {font-size: smaller}
    41     43   div.display {margin-left: 3.2em}
    42     44   div.example {margin-left: 3.2em}
    43         -div.indentedblock {margin-left: 3.2em}
    44     45   div.lisp {margin-left: 3.2em}
    45     46   div.smalldisplay {margin-left: 3.2em}
    46     47   div.smallexample {margin-left: 3.2em}
    47         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    48     48   div.smalllisp {margin-left: 3.2em}
    49         -kbd {font-style:oblique}
           49  +kbd {font-style: oblique}
    50     50   pre.display {font-family: inherit}
    51     51   pre.format {font-family: inherit}
    52     52   pre.menu-comment {font-family: serif}
    53     53   pre.menu-preformatted {font-family: serif}
    54     54   pre.smalldisplay {font-family: inherit; font-size: smaller}
    55     55   pre.smallexample {font-size: smaller}
    56     56   pre.smallformat {font-family: inherit; font-size: smaller}
    57     57   pre.smalllisp {font-size: smaller}
    58         -span.nocodebreak {white-space:nowrap}
    59         -span.nolinebreak {white-space:nowrap}
    60         -span.roman {font-family:serif; font-weight:normal}
    61         -span.sansserif {font-family:sans-serif; font-weight:normal}
           58  +span.nolinebreak {white-space: nowrap}
           59  +span.roman {font-family: initial; font-weight: normal}
           60  +span.sansserif {font-family: sans-serif; font-weight: normal}
    62     61   ul.no-bullet {list-style: none}
    63     62   -->
    64     63   </style>
           64  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    65     65   
    66     66   
    67     67   </head>
    68     68   
    69         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           69  +<body lang="en">
    70     70   <a name="Tutorial"></a>
    71     71   <div class="header">
    72     72   <p>
    73         -Next: <a href="Back_002dends.html#Back_002dends" accesskey="n" rel="next">Back-ends</a>, Previous: <a href="Introduction.html#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="Introduction.html#Introduction" accesskey="u" rel="up">Introduction</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="Common-Options.html#Common-Options" accesskey="n" rel="next">Common Options</a>, Previous: <a href="Introduction.html#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="Introduction.html#Introduction" accesskey="u" rel="up">Introduction</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="Tutorial-1"></a>
    77     77   <h3 class="section">1.1 Tutorial</h3>
    78     78   
    79         -<p>The zeptodb tools are used to create small databases that are stored to
    80         -disk and then to store, fetch and remove records from those databases.
    81         -Note that these databases are much simpler than, say, SQL databases.
    82         -The databases follow the DBM format as created by the GDBM library
    83         -(see <a href="Back_002dends.html#Back_002dends">Back-ends</a>).  Each record in a DBM database consists of a key and
    84         -a value.  All keys and values are stored as plain text, regardless of
    85         -their formats.
           79  +<p>The zeptodb tools are used to create small databases that are stored
           80  +to disk and then to store, fetch and remove records from those
           81  +databases.  These databases are much simpler than, say, SQL databases,
           82  +so no queries need to be constructed.  The databases follow the DBM
           83  +format as created by the GDBM library.  Each record in a DBM database
           84  +consists of a key and a value.  All keys and values are stored as
           85  +plain text, regardless of their formats.
    86     86   </p>
    87     87   <p>First, you create a new database with <code>zdbc</code>:
    88     88   </p>
    89     89   <div class="example">
    90     90   <pre class="example">$ zdbc foo.db
    91     91   </pre></div>
    92     92   
    93         -<p>Note: the following two paragraphs contain technical information that is
    94         -only necessary if you will be creating large databases with many
    95         -records.  If that is not the case, you may safely skip them.
    96         -</p>
    97         -<p>You can customize the creation of a database in two ways.  The first is
    98         -by specifying the number of <em>buckets</em> that comprise the database,
    99         -specified via the <samp>-b</samp>/<samp>--num-buckets</samp> option.  A DBM
   100         -database can be imagined as a series of buckets.  When a new item is
   101         -added, an algorithm determines which bucket it belongs in based on its
   102         -key.  Likewise, the same algorithm will be used in determining the
   103         -bucket from which to fetch an item.  If each bucket only contains a
   104         -maximum of one item, then you are guaranteed to be able to find any item
   105         -in the same amount of time as any other item.  On the other hand, if the
   106         -number of buckets is smaller than the number of items, then when you go
   107         -to fetch an item from a bucket, you might then have to search through
   108         -all the items in that bucket to find the one that you want.  This might
   109         -slow you down.  On the other hand, if the number of buckets is far
   110         -greater than the maximum number of items that will be added, the
   111         -algorithm will be wasteful.  Thus it&rsquo;s best to use a number of buckets
   112         -that will be slightly greater than the expected maximum number of items.
   113         -As a rule of thumb, use about four times more buckets.
   114         -</p>
   115         -<p>The second option is the size (in bytes) of the memory mapped region to
   116         -use, via the <samp>-m</samp>/<samp>--mmap-size</samp> option.  While the
   117         -database is stored on the disk as a file, when it is opened by zeptodb,
   118         -some or all of that file is mapped in a one-to-one manner with a region
   119         -of virtual memory.  Thus, when the program reads from some address in
   120         -that region of memory, it reads directly from the corresponding address
   121         -in the file.  This will generally speed up reading and writing compared
   122         -to traditional file access.  If the memory-mapped region is smaller than
   123         -the size of the database, only portions of the file can be mapped at a
   124         -time, thus slowing down performance.  Therefore, it is recommended to
   125         -use a sufficiently larger value than the size of the database (taking
   126         -into account the expected number of records and the size of the data
   127         -that is expected to fill the record values).
   128         -</p>
   129         -<p>Thus, for a big database, you might do:
   130         -</p>
   131         -<div class="example">
   132         -<pre class="example">$ zdbc --num-buckets=10000 --mmap-size=512000000 big.db
   133         -</pre></div>
   134         -
   135     93   <p>With the database created, you may now store values to it using
   136     94   <code>zdbs</code>.  <code>zdbs</code> normally takes its input from
   137     95   <samp>stdin</samp>.  It expects one record per line and for each key/value
   138     96   pair to be separated by a delimiter character (&rsquo;|&rsquo; by default).  Note
   139     97   that records are unique: an attempt to store a record with a
   140     98   pre-existing key will overwrite that record with a new value.
   141     99   </p>
................................................................................
   229    187   between multiple databases, storing the keys of one database as values
   230    188   in another database, allowing quite complex, but always fast, look-ups
   231    189   within your scripts.
   232    190   </p>
   233    191   <hr>
   234    192   <div class="header">
   235    193   <p>
   236         -Next: <a href="Back_002dends.html#Back_002dends" accesskey="n" rel="next">Back-ends</a>, Previous: <a href="Introduction.html#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="Introduction.html#Introduction" accesskey="u" rel="up">Introduction</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>
          194  +Next: <a href="Common-Options.html#Common-Options" accesskey="n" rel="next">Common Options</a>, Previous: <a href="Introduction.html#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="Introduction.html#Introduction" accesskey="u" rel="up">Introduction</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>
   237    195   </div>
   238    196   
   239    197   
   240    198   
   241    199   </body>
   242    200   </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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, 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">
    29     29   <meta name="Generator" content="makeinfo">
    30     30   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31     31   <link href="#Top" rel="start" title="Top">
    32     32   <link href="Index.html#Index" rel="index" title="Index">
    33     33   <link href="#SEC_Contents" rel="contents" title="Table of Contents">
    34         -<link href="../dir/index.html" rel="up" title="(dir)">
           34  +<link href="/manual" rel="up" title="(dir)">
    35     35   <link href="Introduction.html#Introduction" rel="next" title="Introduction">
    36     36   <style type="text/css">
    37     37   <!--
    38     38   a.summary-letter {text-decoration: none}
           39  +blockquote.indentedblock {margin-right: 0em}
           40  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    39     41   blockquote.smallquotation {font-size: smaller}
    40     42   div.display {margin-left: 3.2em}
    41     43   div.example {margin-left: 3.2em}
    42         -div.indentedblock {margin-left: 3.2em}
    43     44   div.lisp {margin-left: 3.2em}
    44     45   div.smalldisplay {margin-left: 3.2em}
    45     46   div.smallexample {margin-left: 3.2em}
    46         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    47     47   div.smalllisp {margin-left: 3.2em}
    48         -kbd {font-style:oblique}
           48  +kbd {font-style: oblique}
    49     49   pre.display {font-family: inherit}
    50     50   pre.format {font-family: inherit}
    51     51   pre.menu-comment {font-family: serif}
    52     52   pre.menu-preformatted {font-family: serif}
    53     53   pre.smalldisplay {font-family: inherit; font-size: smaller}
    54     54   pre.smallexample {font-size: smaller}
    55     55   pre.smallformat {font-family: inherit; font-size: smaller}
    56     56   pre.smalllisp {font-size: smaller}
    57         -span.nocodebreak {white-space:nowrap}
    58         -span.nolinebreak {white-space:nowrap}
    59         -span.roman {font-family:serif; font-weight:normal}
    60         -span.sansserif {font-family:sans-serif; font-weight:normal}
           57  +span.nolinebreak {white-space: nowrap}
           58  +span.roman {font-family: initial; font-weight: normal}
           59  +span.sansserif {font-family: sans-serif; font-weight: normal}
    61     60   ul.no-bullet {list-style: none}
    62     61   -->
    63     62   </style>
           63  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    64     64   
    65     65   
    66     66   </head>
    67     67   
    68         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           68  +<body lang="en">
    69     69   <h1 class="settitle" align="center">zeptodb</h1>
    70     70   
    71     71   
    72     72   
    73     73   <a name="SEC_Contents"></a>
    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     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  +    <li><a name="toc-Common-Options-1" href="Common-Options.html#Common-Options">1.2 Common Options</a></li>
    83     83     </ul></li>
    84     84     <li><a name="toc-Commands-1" href="Commands.html#Commands">2 Commands</a>
    85     85     <ul class="no-bullet">
    86     86       <li><a name="toc-zdbc-1" href="zdbc.html#zdbc">2.1 zdbc</a></li>
    87     87       <li><a name="toc-zdbs-1" href="zdbs.html#zdbs">2.2 zdbs</a></li>
    88     88       <li><a name="toc-zdbf-1" href="zdbf.html#zdbf">2.3 zdbf</a></li>
    89     89       <li><a name="toc-zdbr-1" href="zdbr.html#zdbr">2.4 zdbr</a></li>
           90  +    <li><a name="toc-zdbi-1" href="zdbi.html#zdbi">2.5 zdbi</a></li>
    90     91     </ul></li>
    91     92     <li><a name="toc-Copying-This-Manual-1" href="Copying-This-Manual.html#Copying-This-Manual">Appendix A Copying This Manual</a>
    92     93     <ul class="no-bullet">
    93     94       <li><a name="toc-GNU-Free-Documentation-License-1" href="GNU-Free-Documentation-License.html#GNU-Free-Documentation-License">A.1 GNU Free Documentation License</a></li>
    94     95     </ul></li>
    95     96     <li><a name="toc-Index-1" href="Index.html#Index">Index</a></li>
    96     97   </ul>
    97     98   </div>
    98     99   
    99    100   
   100    101   <a name="Top"></a>
   101    102   <div class="header">
   102    103   <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>
          104  +Next: <a href="Introduction.html#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="/manual" accesskey="p" rel="prev">(dir)</a>, Up: <a href="/manual" 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>
   104    105   </div>
   105    106   <hr>
   106    107   <a name="zeptodb"></a>
   107    108   <h1 class="top">zeptodb</h1>
   108    109   
   109         -<p>This manual is for zeptodb (version 2.0.2b, updated 17 November 2013).
          110  +<p>This manual is for zeptodb (version 3.0, updated 12 June 2016).
   110    111   </p>
   111         -<p>Copyright &copy; 2013  Brandon Invergo
          112  +<p>Copyright &copy; 2013, 2016  Brandon Invergo
   112    113   </p>
   113    114   <blockquote>
   114    115   <p>Permission is granted to copy, distribute and/or modify this document
   115    116   under the terms of the GNU Free Documentation License, Version 1.3
   116    117   or any later version published by the Free Software Foundation;
   117    118   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
   118    119   A copy of the license is included in the section entitled &ldquo;GNU
................................................................................
   134    135   <tr><td align="left" valign="top">&bull; <a href="Commands.html#Commands" accesskey="2">Commands</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   135    136   </td></tr>
   136    137   <tr><td align="left" valign="top">&bull; <a href="Copying-This-Manual.html#Copying-This-Manual" accesskey="3">Copying This Manual</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   137    138   </td></tr>
   138    139   <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">
   139    140   </td></tr>
   140    141   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
          142  +
   141    143   </pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;
   142    144   
   143    145   Introduction
   144    146   
   145    147   </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    148   </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">
          149  +<tr><td align="left" valign="top">&bull; <a href="Common-Options.html#Common-Options" accesskey="6">Common Options</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   148    150   </td></tr>
   149    151   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
          152  +
   150    153   Commands
   151    154   
   152    155   </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    156   </td></tr>
   154    157   <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">
   155    158   </td></tr>
   156    159   <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">
   157    160   </td></tr>
   158    161   <tr><td align="left" valign="top">&bull; <a href="zdbr.html#zdbr">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   159    162   </td></tr>
          163  +<tr><td align="left" valign="top">&bull; <a href="zdbi.html#zdbi">zdbi</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          164  +</td></tr>
   160    165   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
          166  +
   161    167   Copying This Manual
   162    168   
   163    169   </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.
   164    170   </td></tr>
   165    171   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
          172  +
   166    173   </pre></th></tr></table>
   167    174   
   168    175   <hr>
   169    176   <div class="header">
   170    177   <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>
          178  +Next: <a href="Introduction.html#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="/manual" accesskey="p" rel="prev">(dir)</a>, Up: <a href="/manual" 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>
   172    179   </div>
   173    180   
   174    181   
   175    182   
   176    183   </body>
   177    184   </html>

Changes to www/html_node/zdbc.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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
    22     22   <head>
    23     23   <title>zeptodb: zdbc</title>
    24     24   
    25     25   <meta name="description" content="zeptodb: zdbc">
    26     26   <meta name="keywords" content="zeptodb: zdbc">
    27     27   <meta name="resource-type" content="document">
    28     28   <meta name="distribution" content="global">
................................................................................
    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="zdbs.html#zdbs" rel="next" title="zdbs">
    36     36   <link href="Commands.html#Commands" rel="prev" title="Commands">
    37     37   <style type="text/css">
    38     38   <!--
    39     39   a.summary-letter {text-decoration: none}
           40  +blockquote.indentedblock {margin-right: 0em}
           41  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    40     42   blockquote.smallquotation {font-size: smaller}
    41     43   div.display {margin-left: 3.2em}
    42     44   div.example {margin-left: 3.2em}
    43         -div.indentedblock {margin-left: 3.2em}
    44     45   div.lisp {margin-left: 3.2em}
    45     46   div.smalldisplay {margin-left: 3.2em}
    46     47   div.smallexample {margin-left: 3.2em}
    47         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    48     48   div.smalllisp {margin-left: 3.2em}
    49         -kbd {font-style:oblique}
           49  +kbd {font-style: oblique}
    50     50   pre.display {font-family: inherit}
    51     51   pre.format {font-family: inherit}
    52     52   pre.menu-comment {font-family: serif}
    53     53   pre.menu-preformatted {font-family: serif}
    54     54   pre.smalldisplay {font-family: inherit; font-size: smaller}
    55     55   pre.smallexample {font-size: smaller}
    56     56   pre.smallformat {font-family: inherit; font-size: smaller}
    57     57   pre.smalllisp {font-size: smaller}
    58         -span.nocodebreak {white-space:nowrap}
    59         -span.nolinebreak {white-space:nowrap}
    60         -span.roman {font-family:serif; font-weight:normal}
    61         -span.sansserif {font-family:sans-serif; font-weight:normal}
           58  +span.nolinebreak {white-space: nowrap}
           59  +span.roman {font-family: initial; font-weight: normal}
           60  +span.sansserif {font-family: sans-serif; font-weight: normal}
    62     61   ul.no-bullet {list-style: none}
    63     62   -->
    64     63   </style>
           64  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    65     65   
    66     66   
    67     67   </head>
    68     68   
    69         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           69  +<body lang="en">
    70     70   <a name="zdbc"></a>
    71     71   <div class="header">
    72     72   <p>
    73     73   Next: <a href="zdbs.html#zdbs" accesskey="n" rel="next">zdbs</a>, Previous: <a href="Commands.html#Commands" accesskey="p" rel="prev">Commands</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="zdbc-1"></a>
    77     77   <h3 class="section">2.1 zdbc</h3>
    78     78   
    79         -<p><code>zdbc</code> is used to create a new database file.  It accepts two
    80         -options, one to choose the number of buckets for the database and the
    81         -other to choose the size of the memory-mapped region.  These options
    82         -may only be set upon database creation and may not be altered later.
           79  +<p><code>zdbc</code> is used to create a new database file.  It accepts all
           80  +of the common options.  Running the command on an existing database
           81  +will <em>overwrite</em> the existing contents!
    83     82   </p>
    84         -<p>As a general rule of thumb, you should have around one to four times
    85         -as many buckets as entries in the database.  So, if your database will
    86         -have 200 entries, you should specify 200 to 800 buckets.  A greater
    87         -number of buckets lowers the probability of collisions (two entries
    88         -mapping to the same location).
    89         -</p>
    90         -<p>If possible, you should set the size of the memory-mapped region (in
    91         -bytes) to be larger than the expected size of the database or
    92         -otherwise as large as possible.
           83  +<p>In addition to the database file to be used and the common options,
           84  +the <code>zdbc</code> command accepts the following options:
    93     85   </p>
    94     86   <dl compact="compact">
    95         -<dt><samp>-b, --num-buckets=NUM</samp></dt>
    96         -<dd><p>The number of buckets to use
    97         -</p>
    98         -</dd>
    99         -<dt><samp>-m, --mmap-size=NUM</samp></dt>
   100         -<dd><p>The size (in bytes) of the memory-mapped region to use
   101         -</p>
   102         -</dd>
   103         -<dt><samp>-v, --verbose</samp></dt>
   104         -<dd><p>Print more run-time information
   105         -</p>
   106         -</dd>
   107         -<dt><samp>-?, --help</samp></dt>
   108         -<dd><p>Show helpful information
   109         -</p>
   110         -</dd>
   111         -<dt><samp>--usage</samp></dt>
   112         -<dd><p>Show shorter helpful information
   113         -</p>
   114         -</dd>
   115         -<dt><samp>-V, --version</samp></dt>
   116         -<dd><p>Print the program version
           87  +<dt><samp>-s, --sync</samp></dt>
           88  +<dd><p>Automatically synchronize all database operations to the disk.
   117     89   </p></dd>
   118     90   </dl>
   119     91   
   120     92   
   121     93   
   122     94   
   123     95   </body>
   124     96   </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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, 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">
................................................................................
    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     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  +blockquote.indentedblock {margin-right: 0em}
           41  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    40     42   blockquote.smallquotation {font-size: smaller}
    41     43   div.display {margin-left: 3.2em}
    42     44   div.example {margin-left: 3.2em}
    43         -div.indentedblock {margin-left: 3.2em}
    44     45   div.lisp {margin-left: 3.2em}
    45     46   div.smalldisplay {margin-left: 3.2em}
    46     47   div.smallexample {margin-left: 3.2em}
    47         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    48     48   div.smalllisp {margin-left: 3.2em}
    49         -kbd {font-style:oblique}
           49  +kbd {font-style: oblique}
    50     50   pre.display {font-family: inherit}
    51     51   pre.format {font-family: inherit}
    52     52   pre.menu-comment {font-family: serif}
    53     53   pre.menu-preformatted {font-family: serif}
    54     54   pre.smalldisplay {font-family: inherit; font-size: smaller}
    55     55   pre.smallexample {font-size: smaller}
    56     56   pre.smallformat {font-family: inherit; font-size: smaller}
    57     57   pre.smalllisp {font-size: smaller}
    58         -span.nocodebreak {white-space:nowrap}
    59         -span.nolinebreak {white-space:nowrap}
    60         -span.roman {font-family:serif; font-weight:normal}
    61         -span.sansserif {font-family:sans-serif; font-weight:normal}
           58  +span.nolinebreak {white-space: nowrap}
           59  +span.roman {font-family: initial; font-weight: normal}
           60  +span.sansserif {font-family: sans-serif; font-weight: normal}
    62     61   ul.no-bullet {list-style: none}
    63     62   -->
    64     63   </style>
           64  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    65     65   
    66     66   
    67     67   </head>
    68     68   
    69         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           69  +<body lang="en">
    70     70   <a name="zdbf"></a>
    71     71   <div class="header">
    72     72   <p>
    73     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>
................................................................................
    80     80   are read from <samp>stdin</samp> or, optionally, from a text file.  Records
    81     81   with key values that match the queries will be printed to
    82     82   <samp>stdout</samp>.  By default, only the corresponding values will be
    83     83   printed.  However, if a delimiter character is provided, both keys and
    84     84   values will be printed.  Finally, an option is available to simply
    85     85   print all records in the database.
    86     86   </p>
    87         -<p>In addition to the database file to be used, the <code>zdbf</code>
    88         -command accepts the following options:
           87  +<p>In addition to the database file to be used and the common options,
           88  +the <code>zdbf</code> command accepts the following options:
    89     89   </p>
    90     90   <dl compact="compact">
    91     91   <dt><samp>-a, --all</samp></dt>
    92         -<dd><p>Fetch all the records in the database
           92  +<dd><p>Fetch all the records in the database.
    93     93   </p>
    94     94   </dd>
    95     95   <dt><samp>-d, --delim=CHAR</samp></dt>
    96     96   <dd><p>Delimiter character to separate printed keys from values (default
    97         -none; only values will be printed)
           97  +none; only values will be printed).
    98     98   </p>
    99     99   </dd>
   100    100   <dt><samp>-i, --input=FILE</samp></dt>
   101         -<dd><p>Read queries from a file instead of from <samp>stdin</samp>
   102         -</p>
   103         -</dd>
   104         -<dt><samp>-v, --verbose</samp></dt>
   105         -<dd><p>Print more run-time information
   106         -</p>
   107         -</dd>
   108         -<dt><samp>-?, --help</samp></dt>
   109         -<dd><p>Show helpful information
   110         -</p>
   111         -</dd>
   112         -<dt><samp>--usage</samp></dt>
   113         -<dd><p>Show shorter helpful information
   114         -</p>
   115         -</dd>
   116         -<dt><samp>-V, --version</samp></dt>
   117         -<dd><p>Print the program version
          101  +<dd><p>Read queries from a file instead of from <samp>stdin</samp>.
   118    102   </p></dd>
   119    103   </dl>
   120    104   
   121    105   
   122    106   
   123    107   
   124    108   </body>
   125    109   </html>

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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, 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         -<link href="Copying-This-Manual.html#Copying-This-Manual" rel="next" title="Copying This Manual">
           35  +<link href="zdbi.html#zdbi" rel="next" title="zdbi">
    36     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  +blockquote.indentedblock {margin-right: 0em}
           41  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    40     42   blockquote.smallquotation {font-size: smaller}
    41     43   div.display {margin-left: 3.2em}
    42     44   div.example {margin-left: 3.2em}
    43         -div.indentedblock {margin-left: 3.2em}
    44     45   div.lisp {margin-left: 3.2em}
    45     46   div.smalldisplay {margin-left: 3.2em}
    46     47   div.smallexample {margin-left: 3.2em}
    47         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    48     48   div.smalllisp {margin-left: 3.2em}
    49         -kbd {font-style:oblique}
           49  +kbd {font-style: oblique}
    50     50   pre.display {font-family: inherit}
    51     51   pre.format {font-family: inherit}
    52     52   pre.menu-comment {font-family: serif}
    53     53   pre.menu-preformatted {font-family: serif}
    54     54   pre.smalldisplay {font-family: inherit; font-size: smaller}
    55     55   pre.smallexample {font-size: smaller}
    56     56   pre.smallformat {font-family: inherit; font-size: smaller}
    57     57   pre.smalllisp {font-size: smaller}
    58         -span.nocodebreak {white-space:nowrap}
    59         -span.nolinebreak {white-space:nowrap}
    60         -span.roman {font-family:serif; font-weight:normal}
    61         -span.sansserif {font-family:sans-serif; font-weight:normal}
           58  +span.nolinebreak {white-space: nowrap}
           59  +span.roman {font-family: initial; font-weight: normal}
           60  +span.sansserif {font-family: sans-serif; font-weight: normal}
    62     61   ul.no-bullet {list-style: none}
    63     62   -->
    64     63   </style>
           64  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    65     65   
    66     66   
    67     67   </head>
    68     68   
    69         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           69  +<body lang="en">
    70     70   <a name="zdbr"></a>
    71     71   <div class="header">
    72     72   <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>
           73  +Next: <a href="zdbi.html#zdbi" accesskey="n" rel="next">zdbi</a>, 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
    81     81   <samp>stdin</samp> or, optionally, they are read from a text file.  If many
    82     82   records are removed from the database, some fragmentation can occur.
    83     83   In this case, it is advisable to reorganize the database, which is
    84     84   possible via the <samp>--reorganize</samp> option.
    85     85   </p>
    86         -<p>In addition to the database file to be used, the <code>zdbf</code>
    87         -command accepts the following options:
           86  +<p>In addition to the database file to be used and the common options,
           87  +the <code>zdbf</code> command accepts the following options:
    88     88   </p>
    89     89   <dl compact="compact">
    90     90   <dt><samp>-i, --input=FILE</samp></dt>
    91         -<dd><p>Read queries from a file instead of from <samp>stdin</samp>
           91  +<dd><p>Read queries from a file instead of from <samp>stdin</samp>.
    92     92   </p>
    93     93   </dd>
    94     94   <dt><samp>-r, --reorganize</samp></dt>
    95         -<dd><p>Reorganize the database
           95  +<dd><p>Reorganize the database.
    96     96   </p>
    97     97   </dd>
    98         -<dt><samp>-v, --verbose</samp></dt>
    99         -<dd><p>Print more run-time information
   100         -</p>
   101         -</dd>
   102         -<dt><samp>-?, --help</samp></dt>
   103         -<dd><p>Show helpful information
   104         -</p>
   105         -</dd>
   106         -<dt><samp>--usage</samp></dt>
   107         -<dd><p>Show shorter helpful information
   108         -</p>
   109         -</dd>
   110         -<dt><samp>-V, --version</samp></dt>
   111         -<dd><p>Print the program version
           98  +<dt><samp>-s, --sync</samp></dt>
           99  +<dd><p>Automatically synchronize all database operations to the disk.
   112    100   </p></dd>
   113    101   </dl>
   114    102   
   115    103   
   116    104   
   117    105   
   118    106   </body>
   119    107   </html>

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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, 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">
................................................................................
    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     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  +blockquote.indentedblock {margin-right: 0em}
           41  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    40     42   blockquote.smallquotation {font-size: smaller}
    41     43   div.display {margin-left: 3.2em}
    42     44   div.example {margin-left: 3.2em}
    43         -div.indentedblock {margin-left: 3.2em}
    44     45   div.lisp {margin-left: 3.2em}
    45     46   div.smalldisplay {margin-left: 3.2em}
    46     47   div.smallexample {margin-left: 3.2em}
    47         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    48     48   div.smalllisp {margin-left: 3.2em}
    49         -kbd {font-style:oblique}
           49  +kbd {font-style: oblique}
    50     50   pre.display {font-family: inherit}
    51     51   pre.format {font-family: inherit}
    52     52   pre.menu-comment {font-family: serif}
    53     53   pre.menu-preformatted {font-family: serif}
    54     54   pre.smalldisplay {font-family: inherit; font-size: smaller}
    55     55   pre.smallexample {font-size: smaller}
    56     56   pre.smallformat {font-family: inherit; font-size: smaller}
    57     57   pre.smalllisp {font-size: smaller}
    58         -span.nocodebreak {white-space:nowrap}
    59         -span.nolinebreak {white-space:nowrap}
    60         -span.roman {font-family:serif; font-weight:normal}
    61         -span.sansserif {font-family:sans-serif; font-weight:normal}
           58  +span.nolinebreak {white-space: nowrap}
           59  +span.roman {font-family: initial; font-weight: normal}
           60  +span.sansserif {font-family: sans-serif; font-weight: normal}
    62     61   ul.no-bullet {list-style: none}
    63     62   -->
    64     63   </style>
           64  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    65     65   
    66     66   
    67     67   </head>
    68     68   
    69         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           69  +<body lang="en">
    70     70   <a name="zdbs"></a>
    71     71   <div class="header">
    72     72   <p>
    73     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>
................................................................................
    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
    81     81   input file, with one record per line.  Each record should consist of
    82     82   one key-value pair.  The values should be separated from the keys by a
    83     83   common delimiter (&rsquo;|&rsquo; by default), for example &ldquo;key|value&rdquo;.
    84     84   </p>
    85         -<p>In addition to the database file to be used, the <code>zdbs</code>
    86         -command accepts the following options:
           85  +<p>In addition to the database file to be used and the common options,
           86  +the <code>zdbs</code> command accepts the following options:
    87     87   </p>
    88     88   <dl compact="compact">
    89     89   <dt><samp>-d, --delim=CHAR</samp></dt>
    90         -<dd><p>Delimiter character separating keys from values (default &rsquo;|&rsquo;)
           90  +<dd><p>Delimiter character separating keys from values (default &rsquo;|&rsquo;).
    91     91   </p>
    92     92   </dd>
    93     93   <dt><samp>-i, --input=FILE</samp></dt>
    94         -<dd><p>Read new records from a file instead of from <samp>stdin</samp>
           94  +<dd><p>Read new records from a file instead of from <samp>stdin</samp>.
    95     95   </p>
    96     96   </dd>
    97         -<dt><samp>-v, --verbose</samp></dt>
    98         -<dd><p>Print more run-time information
    99         -</p>
   100         -</dd>
   101         -<dt><samp>-?, --help</samp></dt>
   102         -<dd><p>Show helpful information
   103         -</p>
   104         -</dd>
   105         -<dt><samp>--usage</samp></dt>
   106         -<dd><p>Show shorter helpful information
   107         -</p>
   108         -</dd>
   109         -<dt><samp>-V, --version</samp></dt>
   110         -<dd><p>Print the program version
           97  +<dt><samp>-s, --sync</samp></dt>
           98  +<dd><p>Automatically synchronize all database operations to the disk.
   111     99   </p></dd>
   112    100   </dl>
   113    101   
   114    102   
   115    103   
   116    104   
   117    105   </body>
   118    106   </html>

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.2b, updated 17 November 2013).
            3  +<!-- This manual is for zeptodb (version 3.0, updated 12 June 2016).
     4      4   
     5         -Copyright (C) 2013  Brandon Invergo
            5  +Copyright (C) 2013, 2016  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.
    11     11   A copy of the license is included in the section entitled "GNU
    12     12   Free Documentation License".
................................................................................
    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.2, http://www.gnu.org/software/texinfo/ -->
           21  +<!-- Created by GNU Texinfo 6.1, 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">
    29     29   <meta name="Generator" content="makeinfo">
    30     30   <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    31     31   <link href="#Top" rel="start" title="Top">
    32     32   <link href="#Index" rel="index" title="Index">
    33     33   <link href="#SEC_Contents" rel="contents" title="Table of Contents">
    34         -<link href="dir.html#Top" rel="up" title="(dir)">
           34  +<link href="/manual" rel="up" title="(dir)">
    35     35   <style type="text/css">
    36     36   <!--
    37     37   a.summary-letter {text-decoration: none}
           38  +blockquote.indentedblock {margin-right: 0em}
           39  +blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
    38     40   blockquote.smallquotation {font-size: smaller}
    39     41   div.display {margin-left: 3.2em}
    40     42   div.example {margin-left: 3.2em}
    41         -div.indentedblock {margin-left: 3.2em}
    42     43   div.lisp {margin-left: 3.2em}
    43     44   div.smalldisplay {margin-left: 3.2em}
    44     45   div.smallexample {margin-left: 3.2em}
    45         -div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
    46     46   div.smalllisp {margin-left: 3.2em}
    47         -kbd {font-style:oblique}
           47  +kbd {font-style: oblique}
    48     48   pre.display {font-family: inherit}
    49     49   pre.format {font-family: inherit}
    50     50   pre.menu-comment {font-family: serif}
    51     51   pre.menu-preformatted {font-family: serif}
    52     52   pre.smalldisplay {font-family: inherit; font-size: smaller}
    53     53   pre.smallexample {font-size: smaller}
    54     54   pre.smallformat {font-family: inherit; font-size: smaller}
    55     55   pre.smalllisp {font-size: smaller}
    56         -span.nocodebreak {white-space:nowrap}
    57         -span.nolinebreak {white-space:nowrap}
    58         -span.roman {font-family:serif; font-weight:normal}
    59         -span.sansserif {font-family:sans-serif; font-weight:normal}
           56  +span.nolinebreak {white-space: nowrap}
           57  +span.roman {font-family: initial; font-weight: normal}
           58  +span.sansserif {font-family: sans-serif; font-weight: normal}
    60     59   ul.no-bullet {list-style: none}
    61     60   -->
    62     61   </style>
           62  +<link rel="stylesheet" type="text/css" href="/software/gnulib/manual.css">
    63     63   
    64     64   
    65     65   </head>
    66     66   
    67         -<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
           67  +<body lang="en">
    68     68   <h1 class="settitle" align="center">zeptodb</h1>
    69     69   
    70     70   
    71     71   
    72     72   <a name="SEC_Contents"></a>
    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     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  +    <li><a name="toc-Common-Options-1" href="#Common-Options">1.2 Common Options</a></li>
    82     82     </ul></li>
    83     83     <li><a name="toc-Commands-1" href="#Commands">2 Commands</a>
    84     84     <ul class="no-bullet">
    85     85       <li><a name="toc-zdbc-1" href="#zdbc">2.1 zdbc</a></li>
    86     86       <li><a name="toc-zdbs-1" href="#zdbs">2.2 zdbs</a></li>
    87     87       <li><a name="toc-zdbf-1" href="#zdbf">2.3 zdbf</a></li>
    88     88       <li><a name="toc-zdbr-1" href="#zdbr">2.4 zdbr</a></li>
           89  +    <li><a name="toc-zdbi-1" href="#zdbi">2.5 zdbi</a></li>
    89     90     </ul></li>
    90     91     <li><a name="toc-Copying-This-Manual-1" href="#Copying-This-Manual">Appendix A Copying This Manual</a>
    91     92     <ul class="no-bullet">
    92     93       <li><a name="toc-GNU-Free-Documentation-License-1" href="#GNU-Free-Documentation-License">A.1 GNU Free Documentation License</a></li>
    93     94     </ul></li>
    94     95     <li><a name="toc-Index-1" href="#Index">Index</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" 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>
          103  +Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="/manual" accesskey="p" rel="prev">(dir)</a>, Up: <a href="/manual" 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>
   103    104   </div>
   104    105   <a name="zeptodb"></a>
   105    106   <h1 class="top">zeptodb</h1>
   106    107   
   107         -<p>This manual is for zeptodb (version 2.0.2b, updated 17 November 2013).
          108  +<p>This manual is for zeptodb (version 3.0, updated 12 June 2016).
   108    109   </p>
   109         -<p>Copyright &copy; 2013  Brandon Invergo
          110  +<p>Copyright &copy; 2013, 2016  Brandon Invergo
   110    111   </p>
   111    112   <blockquote>
   112    113   <p>Permission is granted to copy, distribute and/or modify this document
   113    114   under the terms of the GNU Free Documentation License, Version 1.3
   114    115   or any later version published by the Free Software Foundation;
   115    116   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
   116    117   A copy of the license is included in the section entitled &ldquo;GNU
................................................................................
   132    133   <tr><td align="left" valign="top">&bull; <a href="#Commands" accesskey="2">Commands</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   133    134   </td></tr>
   134    135   <tr><td align="left" valign="top">&bull; <a href="#Copying-This-Manual" accesskey="3">Copying This Manual</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   135    136   </td></tr>
   136    137   <tr><td align="left" valign="top">&bull; <a href="#Index" accesskey="4">Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   137    138   </td></tr>
   138    139   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
          140  +
   139    141   </pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;
   140    142   
   141    143   Introduction
   142    144   
   143    145   </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    146   </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">
          147  +<tr><td align="left" valign="top">&bull; <a href="#Common-Options" accesskey="6">Common Options</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   146    148   </td></tr>
   147    149   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
          150  +
   148    151   Commands
   149    152   
   150    153   </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    154   </td></tr>
   152    155   <tr><td align="left" valign="top">&bull; <a href="#zdbs" accesskey="8">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   153    156   </td></tr>
   154    157   <tr><td align="left" valign="top">&bull; <a href="#zdbf" accesskey="9">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   155    158   </td></tr>
   156    159   <tr><td align="left" valign="top">&bull; <a href="#zdbr">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   157    160   </td></tr>
          161  +<tr><td align="left" valign="top">&bull; <a href="#zdbi">zdbi</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          162  +</td></tr>
   158    163   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
          164  +
   159    165   Copying This Manual
   160    166   
   161    167   </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.
   162    168   </td></tr>
   163    169   <tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">
          170  +
   164    171   </pre></th></tr></table>
   165    172   
   166    173   <hr>
   167    174   <a name="Introduction"></a>
   168    175   <div class="header">
   169    176   <p>
   170    177   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>
   171    178   </div>
   172    179   <a name="Introduction-1"></a>
   173    180   <h2 class="chapter">1 Introduction</h2>
   174    181   
   175         -<p>zeptodb is a small collection of relatively tiny command-line tools for
   176         -interacting with <em>DBM databases</em>.  For the uninitiated, DBM
   177         -databases are flat (non-relational) a databases; in other words, they
   178         -are persistent key-value hash tables. Typically they are created via a
   179         -library for C, Python, Perl, etc. These tools fill in a gap by providing
   180         -useful command-line tools. Some DBM libraries come with really basic
   181         -binaries for manipulating the databases, but they are not designed to be
   182         -very flexible or useful in the real world.
          182  +<p>zeptodb is a small collection of relatively tiny command-line tools
          183  +for interacting with <em>DBM databases</em>.  DBM databases are flat
          184  +(non-relational) a databases; in other words, they are persistent
          185  +key-value hash tables. Typically they are created via a library for C,
          186  +Python, Perl, etc. These tools fill in a gap by providing useful
          187  +command-line tools. Some DBM libraries come with really basic binaries
          188  +for manipulating the databases, but they are not designed to be very
          189  +flexible or useful in the real world.
   183    190   </p>
   184         -<p>These tools may be helpful in scripts, for example, when persistant data
   185         -storage is needed but when a full database would be overkill.  DBM
   186         -databases offer a constant look-up time for any record in them, as
          191  +<p>These tools may be helpful in scripts, for example, when persistant
          192  +data storage is needed but when a full database would be overkill.
          193  +DBM databases offer a constant look-up time for any record in them, as
   187    194   opposed to, say, searching through a text file, which scales linearly
   188         -with the number of lines in the file.  Thus, scripts requiring fast data
   189         -look-up would benefit greatly from them.  These commands may also be
   190         -useful if, for whatever reason, one would like to manipulate, via the
   191         -command-line or scripts, DBM databases created by other programs.
          195  +with the number of lines in the file.  Thus, scripts requiring fast
          196  +data look-up would benefit greatly from them (but note that, of
          197  +course, disk access is slower than memory access, so if you really
          198  +need the performance and you can fit your table in memory, these are
          199  +not the appropriate tools).  These commands may also be useful if, for
          200  +whatever reason, one would like to manipulate, via the command-line or
          201  +scripts, DBM databases created by other programs.
   192    202   </p>
   193    203   <table class="menu" border="0" cellspacing="0">
   194    204   <tr><td align="left" valign="top">&bull; <a href="#Tutorial" accesskey="1">Tutorial</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   195    205   </td></tr>
   196         -<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">
          206  +<tr><td align="left" valign="top">&bull; <a href="#Common-Options" accesskey="2">Common Options</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   197    207   </td></tr>
   198    208   </table>
   199    209   
   200    210   <hr>
   201    211   <a name="Tutorial"></a>
   202    212   <div class="header">
   203    213   <p>
   204         -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>
          214  +Next: <a href="#Common-Options" accesskey="n" rel="next">Common Options</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>
   205    215   </div>
   206    216   <a name="Tutorial-1"></a>
   207    217   <h3 class="section">1.1 Tutorial</h3>
   208    218   
   209         -<p>The zeptodb tools are used to create small databases that are stored to
   210         -disk and then to store, fetch and remove records from those databases.
   211         -Note that these databases are much simpler than, say, SQL databases.
   212         -The databases follow the DBM format as created by the GDBM library
   213         -(see <a href="#Back_002dends">Back-ends</a>).  Each record in a DBM database consists of a key and
   214         -a value.  All keys and values are stored as plain text, regardless of
   215         -their formats.
          219  +<p>The zeptodb tools are used to create small databases that are stored
          220  +to disk and then to store, fetch and remove records from those
          221  +databases.  These databases are much simpler than, say, SQL databases,
          222  +so no queries need to be constructed.  The databases follow the DBM
          223  +format as created by the GDBM library.  Each record in a DBM database
          224  +consists of a key and a value.  All keys and values are stored as
          225  +plain text, regardless of their formats.
   216    226   </p>
   217    227   <p>First, you create a new database with <code>zdbc</code>:
   218    228   </p>
   219    229   <div class="example">
   220    230   <pre class="example">$ zdbc foo.db
   221    231   </pre></div>
   222    232   
   223         -<p>Note: the following two paragraphs contain technical information that is
   224         -only necessary if you will be creating large databases with many
   225         -records.  If that is not the case, you may safely skip them.
   226         -</p>
   227         -<p>You can customize the creation of a database in two ways.  The first is
   228         -by specifying the number of <em>buckets</em> that comprise the database,
   229         -specified via the <samp>-b</samp>/<samp>--num-buckets</samp> option.  A DBM
   230         -database can be imagined as a series of buckets.  When a new item is
   231         -added, an algorithm determines which bucket it belongs in based on its
   232         -key.  Likewise, the same algorithm will be used in determining the
   233         -bucket from which to fetch an item.  If each bucket only contains a
   234         -maximum of one item, then you are guaranteed to be able to find any item
   235         -in the same amount of time as any other item.  On the other hand, if the
   236         -number of buckets is smaller than the number of items, then when you go
   237         -to fetch an item from a bucket, you might then have to search through
   238         -all the items in that bucket to find the one that you want.  This might
   239         -slow you down.  On the other hand, if the number of buckets is far
   240         -greater than the maximum number of items that will be added, the
   241         -algorithm will be wasteful.  Thus it&rsquo;s best to use a number of buckets
   242         -that will be slightly greater than the expected maximum number of items.
   243         -As a rule of thumb, use about four times more buckets.
   244         -</p>
   245         -<p>The second option is the size (in bytes) of the memory mapped region to
   246         -use, via the <samp>-m</samp>/<samp>--mmap-size</samp> option.  While the
   247         -database is stored on the disk as a file, when it is opened by zeptodb,
   248         -some or all of that file is mapped in a one-to-one manner with a region
   249         -of virtual memory.  Thus, when the program reads from some address in
   250         -that region of memory, it reads directly from the corresponding address
   251         -in the file.  This will generally speed up reading and writing compared
   252         -to traditional file access.  If the memory-mapped region is smaller than
   253         -the size of the database, only portions of the file can be mapped at a
   254         -time, thus slowing down performance.  Therefore, it is recommended to
   255         -use a sufficiently larger value than the size of the database (taking
   256         -into account the expected number of records and the size of the data
   257         -that is expected to fill the record values).
   258         -</p>
   259         -<p>Thus, for a big database, you might do:
   260         -</p>
   261         -<div class="example">
   262         -<pre class="example">$ zdbc --num-buckets=10000 --mmap-size=512000000 big.db
   263         -</pre></div>
   264         -
   265    233   <p>With the database created, you may now store values to it using
   266    234   <code>zdbs</code>.  <code>zdbs</code> normally takes its input from
   267    235   <samp>stdin</samp>.  It expects one record per line and for each key/value
   268    236   pair to be separated by a delimiter character (&rsquo;|&rsquo; by default).  Note
   269    237   that records are unique: an attempt to store a record with a
   270    238   pre-existing key will overwrite that record with a new value.
   271    239   </p>
................................................................................
   357    325   scripts.  For example, one script might save data to a database while
   358    326   another script reads from that data.  You can even build up relations
   359    327   between multiple databases, storing the keys of one database as values
   360    328   in another database, allowing quite complex, but always fast, look-ups
   361    329   within your scripts.
   362    330   </p>
   363    331   <hr>
   364         -<a name="Back_002dends"></a>
          332  +<a name="Common-Options"></a>
   365    333   <div class="header">
   366    334   <p>
   367    335   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>
   368    336   </div>
   369         -<a name="Back_002dends-1"></a>
   370         -<h3 class="section">1.2 Back-ends</h3>
   371         -
   372         -<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.
   373         -Alternatively, you may choose to use the
   374         -<a href="http://fallabs.com/kyotocabinet/">Kyoto Cabinet</a> library
   375         -instead.  This is specified by passing the
   376         -<samp>--with-kyotocabinet</samp> option to the <samp>configure</samp> script
   377         -before compiling zeptodb.
   378         -</p>
   379         -<p>Note that databases created with these two different back-ends are
   380         -<em>not</em> compatible, thus databases created with Kyoto Cabinet can
   381         -only be accessed by zeptodb if it has been compiled with support for
   382         -the library.
   383         -</p>
   384         -<p>Databases created with Kyoto Cabinet are required to have the
   385         -<samp>.kch</samp> file extension.  By convention, databases created with
   386         -GDBM should have the <samp>.db</samp> file extension.
   387         -</p>
   388         -<p>For most purposes, databases created with GDBM should be sufficient.
   389         -For particularly large data sets, however, Kyoto Cabinet is
   390         -preferred, since it can add values more quickly and has a much larger
   391         -upper limit on the database size.  On the other hand, Kyoto Cabinet is
   392         -not as widely available in GNU/Linux distributions as GDBM so it often
   393         -must be installed manually.
   394         -</p>
          337  +<a name="Common-Options-1"></a>
          338  +<h3 class="section">1.2 Common Options</h3>
          339  +
          340  +<p>The following options are available for all zeptodb commands.
          341  +</p>
          342  +<dl compact="compact">
          343  +<dt><samp>-b, --block-size=NUM</samp></dt>
          344  +<dd><p>The block size (in bytes) to be used, representing the size of a
          345  +transfer from disk to memory.  The default value is 512.
          346  +</p>
          347  +</dd>
          348  +<dt><samp>-m, --mmap-size=NUM</samp></dt>
          349  +<dd><p>The size (in bytes) of the memory-mapped region to be used.  With a
          350  +value greater than zero, a memory map of the database will be created;
          351  +thus the size specified must be large enough to fit the entire
          352  +database.
          353  +</p>
          354  +</dd>
          355  +<dt><samp>-c, --cache-size=NUM</samp></dt>
          356  +<dd><p>The size (in bytes) of the bucket cache size to be used.
          357  +</p>
          358  +</dd>
          359  +<dt><samp>-l, --no-lock</samp></dt>
          360  +<dd><p>Do not perform file locking an the database.
          361  +</p>
          362  +</dd>
          363  +<dt><samp>-n, --no-mmap</samp></dt>
          364  +<dd><p>Do not create a memory map of the database.
          365  +</p>
          366  +</dd>
          367  +<dt><samp>-v, --verbose</samp></dt>
          368  +<dd><p>Print more run-time information.
          369  +</p>
          370  +</dd>
          371  +<dt><samp>-?, --help</samp></dt>
          372  +<dd><p>Show helpful information.
          373  +</p>
          374  +</dd>
          375  +<dt><samp>--usage</samp></dt>
          376  +<dd><p>Show shorter helpful information.
          377  +</p>
          378  +</dd>
          379  +<dt><samp>-V, --version</samp></dt>
          380  +<dd><p>Print the program version.
          381  +</p></dd>
          382  +</dl>
          383  +
          384  +
   395    385   <hr>
   396    386   <a name="Commands"></a>
   397    387   <div class="header">
   398    388   <p>
   399    389   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>
   400    390   </div>
   401    391   <a name="Commands-1"></a>
   402    392   <h2 class="chapter">2 Commands</h2>
   403    393   
   404         -<p>Three commands are provided with zeptodb: <code>zdbc</code>, for creating
          394  +<p>Five commands are provided with zeptodb: <code>zdbc</code>, for creating
   405    395   databases, <code>zdbs</code> for storing records in them, <code>zdbf</code>,
   406         -for fetching records, and <code>zdbr</code>, for removing records.
          396  +for fetching records, <code>zdbr</code>, for removing records, and
          397  +<code>zdbi</code> for displaying information about a database.
   407    398   </p>
   408    399   <table class="menu" border="0" cellspacing="0">
   409    400   <tr><td align="left" valign="top">&bull; <a href="#zdbc" accesskey="1">zdbc</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   410    401   </td></tr>
   411    402   <tr><td align="left" valign="top">&bull; <a href="#zdbs" accesskey="2">zdbs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   412    403   </td></tr>
   413    404   <tr><td align="left" valign="top">&bull; <a href="#zdbf" accesskey="3">zdbf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   414    405   </td></tr>
   415    406   <tr><td align="left" valign="top">&bull; <a href="#zdbr" accesskey="4">zdbr</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
          407  +</td></tr>
          408  +<tr><td align="left" valign="top">&bull; <a href="#zdbi" accesskey="5">zdbi</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
   416    409   </td></tr>
   417    410   </table>
   418    411   
   419    412   
   420    413   <hr>
   421    414   <a name="zdbc"></a>
   422    415   <div class="header">
   423    416   <p>
   424    417   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>
   425    418   </div>
   426    419   <a name="zdbc-1"></a>
   427    420   <h3 class="section">2.1 zdbc</h3>
   428    421   
   429         -<p><code>zdbc</code> is used to create a new database file.  It accepts two
   430         -options, one to choose the number of buckets for the database and the
   431         -other to choose the size of the memory-mapped region.  These options
   432         -may only be set upon database creation and may not be altered later.
          422  +<p><code>zdbc</code> is used to create a new database file.  It accepts all
          423  +of the common options.  Running the command on an existing database
          424  +will <em>overwrite</em> the existing contents!
   433    425   </p>
   434         -<p>As a general rule of thumb, you should have around one to four times
   435         -as many buckets as entries in the database.  So, if your database will
   436         -have 200 entries, you should specify 200 to 800 buckets.  A greater
   437         -number of buckets lowers the probability of collisions (two entries
   438         -mapping to the same location).
   439         -</p>
   440         -<p>If possible, you should set the size of the memory-mapped region (in
   441         -bytes) to be larger than the expected size of the database or
   442         -otherwise as large as possible.
          426  +<p>In addition to the database file to be used and the common options,
          427  +the <code>zdbc</code> command accepts the following options:
   443    428   </p>
   444    429   <dl compact="compact">
   445         -<dt><samp>-b, --num-buckets=NUM</samp></dt>
   446         -<dd><p>The number of buckets to use
   447         -</p>
   448         -</dd>
   449         -<dt><samp>-m, --mmap-size=NUM</samp></dt>
   450         -<dd><p>The size (in bytes) of the memory-mapped region to use
   451         -</p>
   452         -</dd>
   453         -<dt><samp>-v, --verbose</samp></dt>
   454         -<dd><p>Print more run-time information
   455         -</p>
   456         -</dd>
   457         -<dt><samp>-?, --help</samp></dt>
   458         -<dd><p>Show helpful information
   459         -</p>
   460         -</dd>
   461         -<dt><samp>--usage</samp></dt>
   462         -<dd><p>Show shorter helpful information
   463         -</p>
   464         -</dd>
   465         -<dt><samp>-V, --version</samp></dt>
   466         -<dd><p>Print the program version
          430  +<dt><samp>-s, --sync</samp></dt>
          431  +<dd><p>Automatically synchronize all database operations to the disk.
   467    432   </p></dd>
   468    433   </dl>
   469    434   
   470    435   <hr>
   471    436   <a name="zdbs"></a>
   472    437   <div class="header">
   473    438   <p>
................................................................................
   478    443   
   479    444   <p><code>zdbs</code> is used to store records in a database file.  Records
   480    445   are entered via <samp>stdin</samp> or, optionally, they are read from an
   481    446   input file, with one record per line.  Each record should consist of
   482    447   one key-value pair.  The values should be separated from the keys by a
   483    448   common delimiter (&rsquo;|&rsquo; by default), for example &ldquo;key|value&rdquo;.
   484    449   </p>
   485         -<p>In addition to the database file to be used, the <code>zdbs</code>
   486         -command accepts the following options:
          450  +<p>In addition to the database file to be used and the common options,
          451  +the <code>zdbs</code> command accepts the following options:
   487    452   </p>
   488    453   <dl compact="compact">
   489    454   <dt><samp>-d, --delim=CHAR</samp></dt>
   490         -<dd><p>Delimiter character separating keys from values (default &rsquo;|&rsquo;)
          455  +<dd><p>Delimiter character separating keys from values (default &rsquo;|&rsquo;).
   491    456   </p>
   492    457   </dd>
   493    458   <dt><samp>-i, --input=FILE</samp></dt>
   494         -<dd><p>Read new records from a file instead of from <samp>stdin</samp>
          459  +<dd><p>Read new records from a file instead of from <samp>stdin</samp>.
   495    460   </p>
   496    461   </dd>
   497         -<dt><samp>-v, --verbose</samp></dt>
   498         -<dd><p>Print more run-time information
   499         -</p>
   500         -</dd>
   501         -<dt><samp>-?, --help</samp></dt>
   502         -<dd><p>Show helpful information
   503         -</p>
   504         -</dd>
   505         -<dt><samp>--usage</samp></dt>
   506         -<dd><p>Show shorter helpful information
   507         -</p>
   508         -</dd>
   509         -<dt><samp>-V, --version</samp></dt>
   510         -<dd><p>Print the program version
          462  +<dt><samp>-s, --sync</samp></dt>
          463  +<dd><p>Automatically synchronize all database operations to the disk.
   511    464   </p></dd>
   512    465   </dl>
   513    466   
   514    467   <hr>
   515    468   <a name="zdbf"></a>
   516    469   <div class="header">
   517    470   <p>
................................................................................
   524    477   are read from <samp>stdin</samp> or, optionally, from a text file.  Records
   525    478   with key values that match the queries will be printed to
   526    479   <samp>stdout</samp>.  By default, only the corresponding values will be
   527    480   printed.  However, if a delimiter character is provided, both keys and
   528    481   values will be printed.  Finally, an option is available to simply
   529    482   print all records in the database.
   530    483   </p>
   531         -<p>In addition to the database file to be used, the <code>zdbf</code>
   532         -command accepts the following options:
          484  +<p>In addition to the database file to be used and the common options,
          485  +the <code>zdbf</code> command accepts the following options:
   533    486   </p>
   534    487   <dl compact="compact">
   535    488   <dt><samp>-a, --all</samp></dt>
   536         -<dd><p>Fetch all the records in the database
          489  +<dd><p>Fetch all the records in the database.
   537    490   </p>
   538    491   </dd>
   539    492   <dt><samp>-d, --delim=CHAR</samp></dt>
   540    493   <dd><p>Delimiter character to separate printed keys from values (default
   541         -none; only values will be printed)
          494  +none; only values will be printed).
   542    495   </p>
   543    496   </dd>
   544    497   <dt><samp>-i, --input=FILE</samp></dt>
   545         -<dd><p>Read queries from a file instead of from <samp>stdin</samp>
   546         -</p>
   547         -</dd>
   548         -<dt><samp>-v, --verbose</samp></dt>
   549         -<dd><p>Print more run-time information
   550         -</p>
   551         -</dd>
   552         -<dt><samp>-?, --help</samp></dt>
   553         -<dd><p>Show helpful information
   554         -</p>
   555         -</dd>
   556         -<dt><samp>--usage</samp></dt>
   557         -<dd><p>Show shorter helpful information
   558         -</p>
   559         -</dd>
   560         -<dt><samp>-V, --version</samp></dt>
   561         -<dd><p>Print the program version
          498  +<dd><p>Read queries from a file instead of from <samp>stdin</samp>.
   562    499   </p></dd>
   563    500   </dl>
   564    501   
   565    502   <hr>
   566    503   <a name="zdbr"></a>
   567    504   <div class="header">
   568    505   <p>
   569         -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>
          506  +Next: <a href="#zdbi" accesskey="n" rel="next">zdbi</a>, 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>
   570    507   </div>
   571    508   <a name="zdbr-1"></a>
   572    509   <h3 class="section">2.4 zdbr</h3>
   573    510   
   574    511   <p><code>zdbr</code> is used to remove records from a database.  The records
   575    512   to be removed are specified by their keys and are entered via
   576    513   <samp>stdin</samp> or, optionally, they are read from a text file.  If many
   577    514   records are removed from the database, some fragmentation can occur.
   578    515   In this case, it is advisable to reorganize the database, which is
   579    516   possible via the <samp>--reorganize</samp> option.
   580    517   </p>
   581         -<p>In addition to the database file to be used, the <code>zdbf</code>
   582         -command accepts the following options:
          518  +<p>In addition to the database file to be used and the common options,
          519  +the <code>zdbf</code> command accepts the following options:
   583    520   </p>
   584    521   <dl compact="compact">
   585    522   <dt><samp>-i, --input=FILE</samp></dt>
   586         -<dd><p>Read queries from a file instead of from <samp>stdin</samp>
          523  +<dd><p>Read queries from a file instead of from <samp>stdin</samp>.
   587    524   </p>
   588    525   </dd>
   589    526   <dt><samp>-r, --reorganize</samp></dt>
   590         -<dd><p>Reorganize the database
          527  +<dd><p>Reorganize the database.
   591    528   </p>
   592    529   </dd>
   593         -<dt><samp>-v, --verbose</samp></dt>
   594         -<dd><p>Print more run-time information
   595         -</p>
   596         -</dd>
   597         -<dt><samp>-?, --help</samp></dt>
   598         -<dd><p>Show helpful information
   599         -</p>
   600         -</dd>
   601         -<dt><samp>--usage</samp></dt>
   602         -<dd><p>Show shorter helpful information
   603         -</p>
   604         -</dd>
   605         -<dt><samp>-V, --version</samp></dt>
   606         -<dd><p>Print the program version
          530  +<dt><samp>-s, --sync</samp></dt>
          531  +<dd><p>Automatically synchronize all database operations to the disk.
   607    532   </p></dd>
   608    533   </dl>
   609    534   
          535  +<hr>
          536  +<a name="zdbi"></a>
          537  +<div class="header">
          538  +<p>
          539  +Previous: <a href="#zdbr" accesskey="p" rel="prev">zdbr</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>
          540  +</div>
          541  +<a name="zdbi-1"></a>
          542  +<h3 class="section">2.5 zdbi</h3>
          543  +
          544  +<p><code>zdbi</code> prints out information on a database file.  It accepts
          545  +the common options.
          546  +</p>
   610    547   <hr>
   611    548   <a name="Copying-This-Manual"></a>
   612    549   <div class="header">
   613    550   <p>
   614    551   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>
   615    552   </div>
   616    553   <a name="Copying-This-Manual-1"></a>

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      3     1.1 Tutorial
     4         -  1.2 Back-ends
            4  +  1.2 Common Options
     5      5   2 Commands
     6      6     2.1 zdbc
     7      7     2.2 zdbs
     8      8     2.3 zdbf
     9      9     2.4 zdbr
           10  +  2.5 zdbi
    10     11   Appendix A Copying This Manual
    11     12     A.1 GNU Free Documentation License
    12     13   Index
    13     14   zeptodb
    14     15   *******
    15     16   
    16         -This manual is for zeptodb (version 2.0.2b, updated 17 November 2013).
           17  +This manual is for zeptodb (version 3.0, updated 12 June 2016).
    17     18   
    18         -   Copyright (C) 2013 Brandon Invergo
           19  +   Copyright (C) 2013, 2016 Brandon Invergo
    19     20   
    20     21        Permission is granted to copy, distribute and/or modify this
    21     22        document under the terms of the GNU Free Documentation License,
    22     23        Version 1.3 or any later version published by the Free Software
    23     24        Foundation; with no Invariant Sections, no Front-Cover Texts, and
    24     25        no Back-Cover Texts.  A copy of the license is included in the
    25     26        section entitled "GNU Free Documentation License".
................................................................................
    29     30   
    30     31      The document was typeset with GNU Texinfo (http://www.texinfo.org/).
    31     32   
    32     33   1 Introduction
    33     34   **************
    34     35   
    35     36   zeptodb is a small collection of relatively tiny command-line tools for
    36         -interacting with "DBM databases".  For the uninitiated, DBM databases
    37         -are flat (non-relational) a databases; in other words, they are
    38         -persistent key-value hash tables.  Typically they are created via a
    39         -library for C, Python, Perl, etc.  These tools fill in a gap by
    40         -providing useful command-line tools.  Some DBM libraries come with
    41         -really basic binaries for manipulating the databases, but they are not
    42         -designed to be very flexible or useful in the real world.
           37  +interacting with "DBM databases".  DBM databases are flat
           38  +(non-relational) a databases; in other words, they are persistent
           39  +key-value hash tables.  Typically they are created via a library for C,
           40  +Python, Perl, etc.  These tools fill in a gap by providing useful
           41  +command-line tools.  Some DBM libraries come with really basic binaries
           42  +for manipulating the databases, but they are not designed to be very
           43  +flexible or useful in the real world.
    43     44   
    44     45      These tools may be helpful in scripts, for example, when persistant
    45     46   data storage is needed but when a full database would be overkill.  DBM
    46     47   databases offer a constant look-up time for any record in them, as
    47     48   opposed to, say, searching through a text file, which scales linearly
    48     49   with the number of lines in the file.  Thus, scripts requiring fast data
    49         -look-up would benefit greatly from them.  These commands may also be
    50         -useful if, for whatever reason, one would like to manipulate, via the
    51         -command-line or scripts, DBM databases created by other programs.
           50  +look-up would benefit greatly from them (but note that, of course, disk
           51  +access is slower than memory access, so if you really need the
           52  +performance and you can fit your table in memory, these are not the
           53  +appropriate tools).  These commands may also be useful if, for whatever
           54  +reason, one would like to manipulate, via the command-line or scripts,
           55  +DBM databases created by other programs.
    52     56   
    53     57   1.1 Tutorial
    54     58   ============
    55     59   
    56     60   The zeptodb tools are used to create small databases that are stored to
    57     61   disk and then to store, fetch and remove records from those databases.
    58         -Note that these databases are much simpler than, say, SQL databases.
    59         -The databases follow the DBM format as created by the GDBM library
    60         -(*note Back-ends::).  Each record in a DBM database consists of a key
           62  +These databases are much simpler than, say, SQL databases, so no queries
           63  +need to be constructed.  The databases follow the DBM format as created
           64  +by the GDBM library.  Each record in a DBM database consists of a key
    61     65   and a value.  All keys and values are stored as plain text, regardless
    62     66   of their formats.
    63     67   
    64     68      First, you create a new database with 'zdbc':
    65     69   
    66     70        $ zdbc foo.db
    67     71   
    68         -   Note: the following two paragraphs contain technical information that
    69         -is only necessary if you will be creating large databases with many
    70         -records.  If that is not the case, you may safely skip them.
    71         -
    72         -   You can customize the creation of a database in two ways.  The first
    73         -is by specifying the number of "buckets" that comprise the database,
    74         -specified via the '-b'/'--num-buckets' option.  A DBM database can be
    75         -imagined as a series of buckets.  When a new item is added, an algorithm
    76         -determines which bucket it belongs in based on its key.  Likewise, the
    77         -same algorithm will be used in determining the bucket from which to
    78         -fetch an item.  If each bucket only contains a maximum of one item, then
    79         -you are guaranteed to be able to find any item in the same amount of
    80         -time as any other item.  On the other hand, if the number of buckets is
    81         -smaller than the number of items, then when you go to fetch an item from
    82         -a bucket, you might then have to search through all the items in that
    83         -bucket to find the one that you want.  This might slow you down.  On the
    84         -other hand, if the number of buckets is far greater than the maximum
    85         -number of items that will be added, the algorithm will be wasteful.
    86         -Thus it's best to use a number of buckets that will be slightly greater
    87         -than the expected maximum number of items.  As a rule of thumb, use
    88         -about four times more buckets.
    89         -
    90         -   The second option is the size (in bytes) of the memory mapped region
    91         -to use, via the '-m'/'--mmap-size' option.  While the database is stored
    92         -on the disk as a file, when it is opened by zeptodb, some or all of that
    93         -file is mapped in a one-to-one manner with a region of virtual memory.
    94         -Thus, when the program reads from some address in that region of memory,
    95         -it reads directly from the corresponding address in the file.  This will
    96         -generally speed up reading and writing compared to traditional file
    97         -access.  If the memory-mapped region is smaller than the size of the
    98         -database, only portions of the file can be mapped at a time, thus
    99         -slowing down performance.  Therefore, it is recommended to use a
   100         -sufficiently larger value than the size of the database (taking into
   101         -account the expected number of records and the size of the data that is
   102         -expected to fill the record values).
   103         -
   104         -   Thus, for a big database, you might do:
   105         -
   106         -     $ zdbc --num-buckets=10000 --mmap-size=512000000 big.db
   107         -
   108     72      With the database created, you may now store values to it using
   109     73   'zdbs'.  'zdbs' normally takes its input from 'stdin'.  It expects one
   110     74   record per line and for each key/value pair to be separated by a
   111     75   delimiter character ('|' by default).  Note that records are unique: an
   112     76   attempt to store a record with a pre-existing key will overwrite that
   113     77   record with a new value.
   114     78   
................................................................................
   181    145   programs from the command-line, you are more likely to use them in
   182    146   scripts.  For example, one script might save data to a database while
   183    147   another script reads from that data.  You can even build up relations
   184    148   between multiple databases, storing the keys of one database as values
   185    149   in another database, allowing quite complex, but always fast, look-ups
   186    150   within your scripts.
   187    151   
   188         -1.2 Back-ends
   189         -=============
   190         -
   191         -By default, zeptodb uses the GNU dbm (http://www.gnu.org/software/gdb)
   192         -(GDBM) library to create and manipulate the DBM databases.
   193         -Alternatively, you may choose to use the Kyoto Cabinet
   194         -(http://fallabs.com/kyotocabinet/) library instead.  This is specified
   195         -by passing the '--with-kyotocabinet' option to the 'configure' script
   196         -before compiling zeptodb.
   197         -
   198         -   Note that databases created with these two different back-ends are
   199         -_not_ compatible, thus databases created with Kyoto Cabinet can only be
   200         -accessed by zeptodb if it has been compiled with support for the
   201         -library.
   202         -
   203         -   Databases created with Kyoto Cabinet are required to have the '.kch'
   204         -file extension.  By convention, databases created with GDBM should have
   205         -the '.db' file extension.
   206         -
   207         -   For most purposes, databases created with GDBM should be sufficient.
   208         -For particularly large data sets, however, Kyoto Cabinet is preferred,
   209         -since it can add values more quickly and has a much larger upper limit
   210         -on the database size.  On the other hand, Kyoto Cabinet is not as widely
   211         -available in GNU/Linux distributions as GDBM so it often must be
   212         -installed manually.
          152  +1.2 Common Options
          153  +==================
          154  +
          155  +The following options are available for all zeptodb commands.
          156  +
          157  +'-b, --block-size=NUM'
          158  +     The block size (in bytes) to be used, representing the size of a
          159  +     transfer from disk to memory.  The default value is 512.
          160  +
          161  +'-m, --mmap-size=NUM'
          162  +     The size (in bytes) of the memory-mapped region to be used.  With a
          163  +     value greater than zero, a memory map of the database will be
          164  +     created; thus the size specified must be large enough to fit the
          165  +     entire database.
          166  +
          167  +'-c, --cache-size=NUM'
          168  +     The size (in bytes) of the bucket cache size to be used.
          169  +
          170  +'-l, --no-lock'
          171  +     Do not perform file locking an the database.
          172  +
          173  +'-n, --no-mmap'
          174  +     Do not create a memory map of the database.
          175  +
          176  +'-v, --verbose'
          177  +     Print more run-time information.
          178  +
          179  +'-?, --help'
          180  +     Show helpful information.
          181  +
          182  +'--usage'
          183  +     Show shorter helpful information.
          184  +
          185  +'-V, --version'
          186  +     Print the program version.
   213    187   
   214    188   2 Commands
   215    189   **********
   216    190   
   217         -Three commands are provided with zeptodb: 'zdbc', for creating
   218         -databases, 'zdbs' for storing records in them, 'zdbf', for fetching
   219         -records, and 'zdbr', for removing records.
          191  +Five commands are provided with zeptodb: 'zdbc', for creating databases,
          192  +'zdbs' for storing records in them, 'zdbf', for fetching records,
          193  +'zdbr', for removing records, and 'zdbi' for displaying information
          194  +about a database.
   220    195   
   221    196   2.1 zdbc
   222    197   ========
   223    198   
   224         -'zdbc' is used to create a new database file.  It accepts two options,
   225         -one to choose the number of buckets for the database and the other to
   226         -choose the size of the memory-mapped region.  These options may only be
   227         -set upon database creation and may not be altered later.
          199  +'zdbc' is used to create a new database file.  It accepts all of the
          200  +common options.  Running the command on an existing database will
          201  +_overwrite_ the existing contents!
   228    202   
   229         -   As a general rule of thumb, you should have around one to four times
   230         -as many buckets as entries in the database.  So, if your database will
   231         -have 200 entries, you should specify 200 to 800 buckets.  A greater
   232         -number of buckets lowers the probability of collisions (two entries
   233         -mapping to the same location).
          203  +   In addition to the database file to be used and the common options,
          204  +the 'zdbc' command accepts the following options:
   234    205   
   235         -   If possible, you should set the size of the memory-mapped region (in
   236         -bytes) to be larger than the expected size of the database or otherwise
   237         -as large as possible.
   238         -
   239         -'-b, --num-buckets=NUM'
   240         -     The number of buckets to use
   241         -
   242         -'-m, --mmap-size=NUM'
   243         -     The size (in bytes) of the memory-mapped region to use
   244         -
   245         -'-v, --verbose'
   246         -     Print more run-time information
   247         -
   248         -'-?, --help'
   249         -     Show helpful information
   250         -
   251         -'--usage'
   252         -     Show shorter helpful information
   253         -
   254         -'-V, --version'
   255         -     Print the program version
          206  +'-s, --sync'
          207  +     Automatically synchronize all database operations to the disk.
   256    208   
   257    209   2.2 zdbs
   258    210   ========
   259    211   
   260    212   'zdbs' is used to store records in a database file.  Records are entered
   261    213   via 'stdin' or, optionally, they are read from an input file, with one
   262    214   record per line.  Each record should consist of one key-value pair.  The
   263    215   values should be separated from the keys by a common delimiter ('|' by
   264    216   default), for example "key|value".
   265    217   
   266         -   In addition to the database file to be used, the 'zdbs' command
   267         -accepts the following options:
          218  +   In addition to the database file to be used and the common options,
          219  +the 'zdbs' command accepts the following options:
   268    220   
   269    221   '-d, --delim=CHAR'
   270         -     Delimiter character separating keys from values (default '|')
          222  +     Delimiter character separating keys from values (default '|').
   271    223   
   272    224   '-i, --input=FILE'
   273         -     Read new records from a file instead of from 'stdin'
          225  +     Read new records from a file instead of from 'stdin'.
   274    226   
   275         -'-v, --verbose'
   276         -     Print more run-time information
   277         -
   278         -'-?, --help'
   279         -     Show helpful information
   280         -
   281         -'--usage'
   282         -     Show shorter helpful information
   283         -
   284         -'-V, --version'
   285         -     Print the program version
          227  +'-s, --sync'
          228  +     Automatically synchronize all database operations to the disk.
   286    229   
   287    230   2.3 zdbf
   288    231   ========
   289    232   
   290    233   'zdbf' is used to fetch records from a database file.  Queries are read
   291    234   from 'stdin' or, optionally, from a text file.  Records with key values
   292    235   that match the queries will be printed to 'stdout'.  By default, only
   293    236   the corresponding values will be printed.  However, if a delimiter
   294    237   character is provided, both keys and values will be printed.  Finally,
   295    238   an option is available to simply print all records in the database.
   296    239   
   297         -   In addition to the database file to be used, the 'zdbf' command
   298         -accepts the following options:
          240  +   In addition to the database file to be used and the common options,
          241  +the 'zdbf' command accepts the following options:
   299    242   
   300    243   '-a, --all'
   301         -     Fetch all the records in the database
          244  +     Fetch all the records in the database.
   302    245   
   303    246   '-d, --delim=CHAR'
   304    247        Delimiter character to separate printed keys from values (default
   305         -     none; only values will be printed)
          248  +     none; only values will be printed).
   306    249   
   307    250   '-i, --input=FILE'
   308         -     Read queries from a file instead of from 'stdin'
   309         -
   310         -'-v, --verbose'
   311         -     Print more run-time information
   312         -
   313         -'-?, --help'
   314         -     Show helpful information
   315         -
   316         -'--usage'
   317         -     Show shorter helpful information
   318         -
   319         -'-V, --version'
   320         -     Print the program version
          251  +     Read queries from a file instead of from 'stdin'.
   321    252   
   322    253   2.4 zdbr
   323    254   ========
   324    255   
   325    256   'zdbr' is used to remove records from a database.  The records to be
   326    257   removed are specified by their keys and are entered via 'stdin' or,
   327    258   optionally, they are read from a text file.  If many records are removed
   328    259   from the database, some fragmentation can occur.  In this case, it is
   329    260   advisable to reorganize the database, which is possible via the
   330    261   '--reorganize' option.
   331    262   
   332         -   In addition to the database file to be used, the 'zdbf' command
   333         -accepts the following options:
          263  +   In addition to the database file to be used and the common options,
          264  +the 'zdbf' command accepts the following options:
   334    265   
   335    266   '-i, --input=FILE'
   336         -     Read queries from a file instead of from 'stdin'
          267  +     Read queries from a file instead of from 'stdin'.
   337    268   
   338    269   '-r, --reorganize'
   339         -     Reorganize the database
          270  +     Reorganize the database.
   340    271   
   341         -'-v, --verbose'
   342         -     Print more run-time information
          272  +'-s, --sync'
          273  +     Automatically synchronize all database operations to the disk.
   343    274   
   344         -'-?, --help'
   345         -     Show helpful information
          275  +2.5 zdbi
          276  +========
   346    277   
   347         -'--usage'
   348         -     Show shorter helpful information
   349         -
   350         -'-V, --version'
   351         -     Print the program version
          278  +'zdbi' prints out information on a database file.  It accepts the common
          279  +options.
   352    280   
   353    281   Appendix A Copying This Manual
   354    282   ******************************
   355    283   
   356    284   A.1 GNU Free Documentation License
   357    285   ==================================
   358    286   

Changes to www/zeptodb.txt.gz.

cannot compute difference between binary files