Polish some comments.

Author: maleadt

src/database.jl

@@ -156,7 +156,7 @@ end
     get(txn::Transaction, dbi::Database, key, ::Type{T}) -> T
 
 Read the value at `key`, decoded as `T`. Throws `LMDBError` if `key`
-isn't there — the same shape as `d[k]` on a regular `AbstractDict`.
+isn't there, the same as `d[k]` on a regular `AbstractDict`.
 """
 @inline function get(txn::Transaction, dbi::Database, key, ::Type{T}) where T
     val_ref = Ref(MDBValue())
@@ -168,8 +168,8 @@ end
     get(txn::Transaction, dbi::Database, key, ::Type{T}, default) -> Union{T,typeof(default)}
 
 Read the value at `key`, decoded as `T`; return `default` if the key
-isn't there. Same shape as `Base.get(dict, key, default)`. Pass
-`nothing` as `default` for the `Union{T,Nothing}` form.
+isn't there. Mirrors `Base.get(dict, key, default)`. Pass `nothing`
+as `default` for the `Union{T,Nothing}` form.
 """
 @inline function get(txn::Transaction, dbi::Database, key, ::Type{T}, default) where T
     val_ref = Ref(MDBValue())

src/environment.jl

@@ -31,11 +31,10 @@ isopen(env::Environment) = env.handle != C_NULL
 Open the LMDB environment at `path`. The directory must already exist
 and be writable. The configuration kwargs go through
 `mdb_env_set_mapsize`, `mdb_env_set_maxreaders`, and `mdb_env_set_maxdbs`;
-`flags` is forwarded to `mdb_env_open`. If anything fails before the
-open completes, the half-open env is closed before the exception
-propagates.
+`flags` is forwarded to `mdb_env_open`. If anything fails along the
+way, the partially-built env is closed before rethrowing.
 
-The shape matches py-lmdb's `Environment(path, **kwargs)` and lmdb-rs's
+Matches py-lmdb's `Environment(path, **kwargs)` and lmdb-rs's
 `EnvironmentBuilder.open(path)`.
 """
 function Environment(path::AbstractString; mapsize::Union{Integer,Nothing} = nothing,
@@ -64,7 +63,7 @@ end
     Environment(f::Function, path::AbstractString; kwargs...) -> result
 
 `do`-block form. Opens the env, runs `f(env)`, closes it on the way
-out — even if `f` throws. Returns whatever `f` returns.
+out, even if `f` throws. Returns whatever `f` returns.
 """
 function Environment(f::Function, path::AbstractString; kwargs...)
     env = Environment(path; kwargs...)