Accumulated nits

diff --git a/.gitattributes b/.gitattributes
new file mode 100644 (file)
index 0000000..ecf3cd6
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,2 @@
+cdb linguist-language=Lua
+cdb-util linguist-language=Lua

diff --git a/README.rst b/README.rst
index fa06bf7b77aa91ce8d82d8235d2d146035b60300..f031933310ab815c5012065912f9ff4dde6af6df 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -192,8 +192,8 @@ Superseder records can also be added from ``stdin`` using ``addsuperhash`` (or
 
   old-digest new-digest notes
 
-The ``notes`` field extends to the end of the line; if newlines are desired in
-the recorded notes, use ``--inul`` and separate records by NUL bytes.
+The ``notes`` field extends to the end of the record; if newlines are desired in
+the recorded notes, use ``--inul`` (``-1``) and separate records by NUL bytes.
 
 Ingest
 ======

diff --git a/cdb b/cdb
index e23758e6aa4643648b22147772cdff83921ab71f..8d40dbc86c695b23019a9ed71c1b7748e7852b10 100755 (executable)
--- a/cdb
+++ b/cdb
@@ -182,6 +182,7 @@ end
 -------------------- Argparse Globals and Command Grouping part 1 {{{
 
 local argp = argparse("cdb", "checksum database tool")
+-- TODO: argp:add_help_command()
 
 -- global options must come before commands, and must be options rather than
 -- arguments if we want --help to do the right thing, sadly.

diff --git a/cdb-util b/cdb-util
index 87fd60bd8cc06effaad829fb8279637a25e8693a..a96a4e68bdb6b86ae9cde86211f04ab88cd3ca93 100755 (executable)
--- a/cdb-util
+++ b/cdb-util
@@ -10,6 +10,9 @@ local plpath    = require "pl.path"
 plapp.require_here()
 local cdblib    = require "cdblib"
 
+----------------------------------------------------------------- }}}
+---------------------------------------------- Argparse utilities {{{
+
 local function argparse_flag_nul(c)
   return c:flag("--nul -0")
    :description("NUL-terminate output records")

diff --git a/cdblib.lua b/cdblib.lua
index f6cc9fcef44f9e59b954e92c9558766a01380785..c902360349e7869b7a8216c023042e07262f0146 100644 (file)
--- a/cdblib.lua
+++ b/cdblib.lua
@@ -1,3 +1,4 @@
+-- Library of code shared by cdb and cdb-util programs
 -- SPDX-License-Identifier: AGPL-3.0-or-later
 
 local plstringx = require "pl.stringx"