2026-07-26 Gary V. Vaughan <gary@gnu.org>

Release version 41.2.4

* NEWS.md: Record release date.

configury: bump release revision to 41.2.4.

* configure.ac (AC_INIT): Bump release revision to 41.2.4.

* .travis.yml: Regenerate.

* lib/std/debug.lua (getfenv, setfenv): Backport from

std.normalize project for compatibility with Lua 5.3, 5.4

and 5.5.

2026-07-25 Gary V. Vaughan <gary@gnu.org>

Release version 41.2.3

* NEWS.md: Record release date.

configury: bump release revision to 41.2.3.

* configure.ac (AC_INIT): Bump release revision to 41.2.3.

* .travis.yml: Regenerate.

2015-03-08 Gary V. Vaughan <gary@gnu.org>

Release version 41.2.0

* NEWS.md: Record release date.

configury: bump release revision to 41.2.0.

* configure.ac (AC_INIT): Bump release revision to 41.2.0.

* .travis.yml: Regenerate.

io: don't leak extra results from implementation details.

* lib/std/io.lua (dirname): Return parenthesised results from

internal gsub calls to prevent unexpected additional values

leaking.

* NEWS.md (Bug fixes): Update.

doc: don't tell LDoc that resulterror is called argerror!

debug: deprecate `toomanyargmsg` for `extramsg_toomany`.

* specs/debug_spec.yaml (extramsg_toomany): Add examples for

correct behaviours of new api.

* lib/std/debug.lua (toomanyargmsg): Deprecate.

(extramsg_toomany): New function, satisfies specified behaviours.

* lib/std/container.lua: Use extramsg_toomany api.

* NEWS.md (New features, Deprecations): Update.

debug: refactor and export debug.resulterror.

* specs/debug_spec.yaml (resulterror): Add examples of behaviours

for resulterror.

* lib/std/base.lua (raise): New function factored out of...

(argerror): ...this. Adjust accordingly.

* lib/std/debug.lua (resulterror): Rewrite over base.raise.

Move out of _DEBUG.argcheck guard.

Export as resulterror.

* NEWS.md (New features): Update.

debug: export formaterror as extramsg_mismatch.

* specs/debug_spec.yaml (extramsg_mismatch): Add examples for

correct behaviours of extramsg_mismatch.

* lib/std/debug.lua (formaterror): Rename from this...

(extramsg_mismatch): ...to this. Move out of _DEBUG.argcheck

guard.

(prototype, concat): Move above position of first call in file.

* NEWS.md (New features): Update.

debug: accept "bool" as a typename alias for "boolean".

* specs/debug_spec.yaml: Add examples for behaviour when given

"bool" in lieu of "boolean".

* lib/std/debug.lua (formaterror, checktype): Accept "bool" as an

alias for "boolean" in a type specification.

* NEWS.md (Bug fixes): Update.

debug: skip `self` typecheck when fname contains a colon.

* specs/debug_spec.yaml (argscheck): Specify behaviours for colon

delimited function name.

* lib/std/debug.lua (argscheck): Drop `self` argument before

checking types of remaining arguments when the function name

contains a colon.

* NEWS.md (New features): Update.

debug: export a new function to parse type table.

Close #91

* lib/std/debug.lua (normalize): Rename from this...

(typesplit): ...to this. Move to outer scope, so it will be

visible even if _DEBUG.argcheck is false.

((markdots, permute, projectuniq): Move to outer scope.

(parsetypes): New function.

(parsetypes, typesplit): Export as public APIs.

* specs/debug_spec.yaml (extendbase): Add parsetypes and

typesplit.

debug: improve argscheck patterns.

* lib/std/debug.lua (args_pat, argscheck): Improve patterns.

slingshot: sync with upstream, for git rockspec fixes.

* slingshot: Sync with upstream.

* stdlib-git-1.rockspec: Regenerate.

debug: maintain stack frame depth parity with LuaJIT.

* lib/std/debug.lua (getfenv): Be careful not to let the LuaJIT

optimizer eliminate a stack frame, and mess up the depth count.

slingshot: sync with upstream, for Lua 5.2.4 update.

* slingshot: Sync with upstream.

* .travis.yml: Regenerate.

debug: adjust numeric args for getfenv wrapper for Lua 5.1.

* lib/std/debug.lua (getfenv): When calling core getfenv from

our wrapper, make sure to add one to numeric args to compensate

for the extra stack frame.

2015-02-27 Gary V. Vaughan <gary@gnu.org>

debug: export portable getfenv and setfenv implementations.

* specs/debug_spec.yaml (getfenv, setfenv): Add examples of

behaviour of these functions.

* lib/std/debug.lua (getfenv): Fix a bug that prevented

unwrapping of functables on Lua 5.1 and LuaJIT.

(getfenv, setfenv): Export as public APIs.

* NEWS.md (New features): Update.

functional: callable returns falsey for nil argument.

* specs/functional_spec.yaml (callable): Specify correct behaviour

for uncallable argument.

* lib/std/functional.lua (callable): Don't raise an argument error

for a nil argument, just return nil like any other uncallable.

* NEWS.md (Bugs fixed): Update.

functional: add examples to show reduce handling nil arguments.

* specs/functional_spec.yaml (reduce): Add examples to show

behaviours with nil arguments.

2015-02-27 Reuben Thomas <rrt@sc3d.org>

std/io.lua: adjust catdir's return to 1 value

2015-02-26 Gary V. Vaughan <gary@gnu.org>

functional: ensure map propagates nil arguments.

* specs/functional_spec.yaml (map): Add examples to show

behaviours with nil arguments.

* lib/std/functional.lua (map): Detect iterator arity when

collecting result table.

* NEWS.md (Bug fixes): Update.

functional: ensure filter propagates nil arguments.

* specs/functional_spec.yaml (filter): Add example to show

behaviour with nil arguments.

* lib/std/functional.lua (filter): Detect iterator arity when

collecting result table.

* NEWS.md (Bug fixes): Update.

functional: ensure collect propagates nil arguments.

* specs/functional_spec.yaml (collect): Add examples to show

behaviours with nil arguments.

* lib/std/functional.lua (collect): Use npairs as a default

iterator.

Detect iterator arity when collecting result table.

* NEWS.md (Bug fixes): Update.

(Incompatible changes): Note change of default iterator.

functional: ensure compose propagates nil arguments.

* specs/functional_spec.yaml (compose): Add examples to show

behaviours with nil arguments.

* lib/std/functional.lua (compose): Simplify.

* NEWS.md (Bug fixes): Update.

functional: ensure bind propagates nil arguments.

* specs/functional_spec.yaml (bind): Add example to show

behaviours with nil arguments.

* lib/std/functional.lua (bind): Simplify.

* NEWS.md (Bug fixes): Update.

std: new npairs and rnpairs iterators.

* specs/std_spec.yaml (npairs, rnpairs): Specify correct

behaviour for these new iterators.

* lib/std/debug.lua (argpairs): Move from here...

* lib/std/base.lua (npairs): ...to here.

(rnpairs): New function.

* lib/std.lua.in (npairs, rnpairs): Reexport from here.

* NEWS.md (New features): Update.

std: fix argscheck declaration for std.getmetamethod.

* lib/std.lua.in (getmetamethod): This function works on anything

the Lua can add a metatable to. Adjust LDocs and argscheck

declaration to support that.

* specs/std_spec.yaml (getmetamethod): Adjust badargs parameters

accordingly.

* NEWS.md (Bug fixes): Update.

2015-02-26 Gary V. Vaughan <gary@vaughan.pe>

Merge pull request #96 from lua-stdlib/fix-require-version

base: require does not work with non-string module version fields

2015-02-26 Gary V. Vaughan <gary@gnu.org>

maint: fix .gitignore problems.

Close #97.

* .gitignore: Some versions of git disallow !re-include inside a

directory that has been excluded. Add a trailing '/*' to support

those versions.

(/build-aux/config.ld.in): Re-include this source file.

(/doc/config.ld): Remove exclusion of no longer generated file,

now that config.ld is also kept in build-aux.

Reported by Reuben Thomas

2015-02-25 Reuben Thomas <rrt@sc3d.org>

base: require does not work with non-string module version fields

Simple fix: run “tostring” on the version field.

It may be desired to refuse certain types. The motivating case here is

that std.optparse has version set to number 0.

2015-02-06 Gary V. Vaughan <gary@gnu.org>

list: std.ireverse is not a full replacement for list.reverse.

* lib/std/list.lua (reverse): Describe a full replacement

with functional.compose in deprecation warning message.

Reported by Reuben Thomas

2015-01-31 Gary V. Vaughan <gary@gnu.org>

maint: post-release administrivia.

* NEWS: Add header line for next release.

* .prev-version: Record previous version.

* ./local.mk (old_NEWS_hash): Auto-update.

Release version 41.1.1

* NEWS.md: Record release date.

configury: bump release version to 41.1.1.

* configure.ac (AC_INIT): Bump release version to 41.1.1.

* .travis.yml: Regenerate.

std: fix an infinite loop in std.barrel() with Lua 5.3.

Close #94

* lib/std/base.lua (maxn): This function is called from any

function wrapped by debug.argscheck, which calls debug.diagnose.

Calling std.barrel monkey-patches the global pairs function,

so we can't call that from here, otherwise it will in turn use

the monkey-patched pairs, which calls debug.diagnose to check

for argument errors before the original maxn call has finished.

Reported by Reuben Thomas

2015-01-30 Gary V. Vaughan <gary@gnu.org>

doc: add missing parameter LDoc for debug:markdots.

* lib/std/debug.lua (markdots): Add missing LDocs for v parameter.

maint: post-release administrivia.

* NEWS: Add header line for next release.

* .prev-version: Record previous version.

* ./local.mk (old_NEWS_hash): Auto-update.

Release version 41.1.0

* NEWS.md: Record release date.

package: normalize leaves valid /../.. sequences unmolested.

* specs/package_spec.yaml (normalize): Add examples of correct

behaviour with multiple .. directories.

* lib/std/package.lua (normalize): Detect redundant .. components

correctly, and only remove them when it's safe to do so.

* NEWS.md (Bug fixes): Update.

slingshot: sync with upstream.

* slingshot: Sync with upstream.

* .travis.yml: Regenerate.

configury: bump release version to 41.1.0.

* configure.ac (AC_INIT): Bump release version to 41.1.0.

table: new unpack method that behaves consistently across Lua versions.

* specs/table_spec.yaml (unpack): Specify behaviours for unpack,

especially when dealing with holes.

* lib/std/base.lua (unpack): Wrapper for the core function, but

defaulting the final index argument to table.maxn.

* lib/std/table.lua (unpack): Export from here. Add LDocs.

* lib/std/debug.lua, lib/std/functional.lua, lib/std/list.lua: Use

safer base.unpack.

* specs/spec_helper.lua (maxn, unpack): Make safe versions

available to spec examples.

* specs/debug_spec.yaml: Simplify id implementation.

* NEWS.md (New features): Update.

debug: unpack to maxn (t) for equivalence between Lua versions.

luajit alone stops unpacking at the first nil valued index, so

we have to pass explicit limits to make it behave like Lua 5.1

through 5.3.

* lib/std/debug.lua (argscheck): unpack from 1 to maxn (results).

* specs/debug_spec.yaml (argscheck): Adjust id implementation to

calculate maximum numeric index and unpack all results up to

that value.

debug: support variant return type lists with argscheck.

Sometimes we need to say `returns an int or nil,errmsg', the

syntax is `=> int or nil, string`, because `=> ?int, string` will

wrongly accept, say, `3, "oh noes!"`.

* specs/debug_spec.yaml (argscheck): Specify behaviours with

variant return type lists.

* lib/std/debug.lua (argscheck): Parse all variants and add them

to the accepted type list permutations table.

Update LDocs.

* NEWS.md (New features): Update.

2015-01-29 Gary V. Vaughan <gary@gnu.org>

refactor: store parameter dots property against each permuted list.

Rather than deciding whether a typelist has continuation dots in

the last position once for the entire table of permuted type match

lists, add it to each permutation with continuation dots.

* lib/std/debug.lua (markdots): Simplify.

(permute): Call it for each new permutation row.

(projectuniq): New function to select and de-deduplicate all

values from the table of permuted type lists at a given index.

(diagnose): Rewrite to work with new format permutations.

(argscheck): Simplify accordingly.

(match): Remove allargs parameter, and always check all arguments.

(merge, HAS_DOTS): Remove. No longer used.

2015-01-28 Gary V. Vaughan <gary@gnu.org>

refactor: clean up maxvalues calculation in debug.argscheck.

* lib/std/debug.lua (stripellipsis): Remove.

(markdots): New function encapsulating stripellipsis, maxvalue

calculation and optional normalization.

(argscheck): Simplify accordingly.

debug: argscheck supports return type checking.

Close #89

* specs/spec_helper.lua (badargs.result): Fallback implementation

until next Specl release.

(init): Use it to return a `badresult` function.

* specs/debug_spec.yaml: Specifiy behaviours with return type

checking.

* lib/std/debug.lua (toomanyargmsg): Factor this...

(toomanymsg): ...into this more general function.

(M): Adjust accordingly.

(resulterror): New function modelled after argerror, but tailored

for result type mismatch error reporting.

(has_dots): Symbol to name use of math.huge for denoting an

ellipsis was stripped from the type list.

(stripellipsis): New function.

(diagnose): Refactored to take a vtable of arguments instead of an

ever longer list of parameters.

(argscheck): Build a vtable to call diagnose for argument type

checking.

Add another diagnose() with a separate vtable for result type

checking.

Update LDocs.

* NEWS.md (New features): Update.

2015-01-27 Gary V. Vaughan <gary@gnu.org>

refactor: separate argscheck inner wrapper into its own function.

* lib/std/debug.lua (empty): New function.

(diagnose): New function...

(argscheck): ...factored out of here.

2015-01-26 Gary V. Vaughan <gary@gnu.org>

tree: don't argcheck metamethods.

Lua will not call metamethods unless the metatables are compatible,

so don't waste time rechecking the argument types.

* lib/std/tree.lua (__index, __newindex): Remove superfluous

argscheck invocations.

set: don't argcheck metamethods.

Lua will not call metamethods unless the metatables are compatible,

so don't waste time rechecking the argument types.

* lib/std/set.lua (__add, __sub, __mul, __div, __le, __lt)

(__tostring): Remove superfluous argscheck invocations.

debug: more accurate too many arguments diagnostics.

Close #76

* specs/debug_spec.yaml (argscheck): Specify behaviour when

arguments match by skipping bracketed optional parameters, but

for one unmatched argument at the end.

* lib/std/debug.lua (permutations): Rename function from this

noun...

(permute): ...to this verb.

(argscheck): Use the matching permutation to decide whether

too many arguments were passed, unless the last parameter has

an ellipsis denoting any number of matching arguments are allowed.

* NEWS.md (Bug fixes): Update.

debug: process [final|parm|types] without nil substitution hack.

* specs/debug_spec.yaml (argscheck): Specify behaviours for

bracketed final parameter more thoroughly.

* lib/std/debug.lua (argscheck): Remove hack of replacing

brackets in bracketed last parameter by 'or nil'; we really

run permutations without a bracketed final parameter now.

(permutations): Simplify accordingly; we don't need all the

sentinel gunk to track final argument nils now.

(normalize): Simplify, and fix a related bug where nils could

get dropped from the type list by a double increment.

* lib/std/functional.lua (bind): This really is a '?any...',

requiring explicit nils, and not a [any...] optional argument.

* specs/debug_spec.yaml: Adjust badargs calls as necessary.

* specs/io_spec.yaml (writelines): Now that this implementation

is a step ahead of the current Specl release generator, manually

write out bad argument examples.

* NEWS.md: Update.

debug: argscheck accepts bracketed final parameter.

* specs/debug_spec.yaml (argscheck): Add examples for bracketed

final parameters.

* lib/std/debug.lua (argscheck): Handle bracketed final parameter

and satisfy new specs. Adjust all callers accordingly.

* NEWS.md (New features): Update.

debug: use trailing `...` instead of `*` with argscheck.

* specs/debug_spec.yaml (argscheck): Add specifications for

continuation argument behavious with `...`.

* lib/std/debug.lua (argscheck): Use `...` instead of `*` as the

syntax for optional repeats of the final parameter type. Adjust

all callers.

* NEWS.md (Incompatible changes): Update.

refactor: change `types` symbol name to `argtypes`.

* lib/std/debug.lua (argscheck): Change `types` symbol name to

`argtypes`.

2015-01-25 Gary V. Vaughan <gary@gnu.org>

debug: argcheck requires leading ? for argtypes, to match specl.

Close #90

* specs/debug_spec.yaml (argcheck): Change to leading `?` over

previous trailing `?` style.

* lib/std.lua.in, lib/std/container.lua, lib/std/debug.lua,

lib/std/functional.lua, lib/std/io.lua, lib/std/list.lua,

lib/std/math.lua, lib/std/package.lua, lib/std/string.lua,

lib/std/table.lua, lib/std/tree.lua: Adjust accordingly.

strbuf: document and test functional copying style.

Close #85

* lib/std/strbuf.lua: Improve LDocs.

* specs/strbuf_spec.yaml: Add example of functional copying.

strbuf: support lazy stringification and concat anything.

* specs/strbuf_spec.yaml: Specify correct behaviours, and add

lazy stringification example.

* lib/std/strbuf.lua (__concat): Simply insert a reference.

(__tostring): Make a table of stringified elements, and concat

those instead of the object elements proper.

* NEWS.md: Update.

strbuf: allow concatenation of StrBuf objects.

* specs/strbuf_spec.yaml: Specify new behaviours.

* lib/std/strbuf.lua (concat): New function, handles concatenation

of StrBuf objects as well as strings.

* NEWS.md: Update.

strbuf: deprecate strbuf.tostring.

* specs/strbuf_spec.yaml: Specify deprecation messages from

strbuf.tostring.

* lib/std/strbuf.lua (StrBuf.tostring): Deprecate.

* NEWS.md: Update.

refactor: rearrange strbuf.lua idiomatically.

* lib/std/strbuf.lua: Rearrange declarations idiomatically.

maint: support strict mode.

Close #92

* lib/std/base.lua (loadstring): Use rawget to fetch loadstring

from _G, to bypass strict mode checks on Lua > 5.2 where

_G.loadstring is nil.

* lib/std/debug.lua (getfenv): Likewise, for Lua > 5.2 where

there is no _G.fgetenv.

* lib/std/debug_init/init.lua (_DEBUG): Likewise, for cases where

caller did not preload _G._DEBUG.

* NEWS.md: Updated.

Reported by Gergely Risko <gergely@risko.hu>

2015-01-19 Gary V. Vaughan <gary@gnu.org>

std: barrel and monkey_patch return module table.

Closes #93

In order for things like `std = require "std".barrel ()` to work

as documented, these methods must return their parent module

table, i.e. in this case, the `std` table.

* specs/io_spec.yaml (monkey_patch): Specify correct behaviour.

* specs/math_spec.yaml (monkey_patch): Likewise.

* specs/string_spec.yaml (monkey_patch): Likewise.

* specs/table_spec.yaml (money_patch): Likewise.

* specs/std_spec.yaml (barrel, monkey_patch): Likewise.

* lib/std.lua.in (barrel, monkey_patch): Return parent module

able.

* lib/std/io.lua, lib/std/math.lua, lib/std/string.lua,

lib/std/table.lua (monkey_patch): Likewise.

* NEWS.md (Bug fixes): Update.

Reported by Reuben Thomas

2015-01-14 Gary V. Vaughan <gary@gnu.org>

slingshot: sync with upstream for working Lua 5.3.0 final support.

* slingshot: Sync with upstream.

* .travis.yml: Regenerate.

slingshot: sync with upstream for Lua 5.3.0 final support.

* slingshot: Sync with upstream.

* .travis.yml: Regenerate.

2015-01-14 Gergely Risko <gergely@risko.hu>

base: remove spurious case reference from base module.

* lib/std/base.lua: Remove spurious reference to case from

export table. That function has long since moved to std.functional.

2015-01-03 Gary V. Vaughan <gary@gnu.org>

maint: post-release administrivia.

* NEWS: Add header line for next release.

* .prev-version: Record previous version.

* ./local.mk (old_NEWS_hash): Auto-update.

Release version 41.0.0

* NEWS.md: Record release date.

maint: don't use math.pow, which some Lua 5.3 builds don't support.

When compiled without -DLUA_COMPAT_5_2, Lua 5.3 removes a good

chunk of the math library, including math.pow.

* lib/std.lua.in (eval): Use math.min in LDocs usage.

* specs/functional_spec.yaml (bind, curry, eval): Instead of

math.pow, use math.min where sensible, otherwise std.operator.pow.

* specs/operator_spec.yaml (pow): Compare with result calculated

using ^ infix operator.

* specs/std_spec.yaml (eval): Use math.min over math.pow.

std: ireverse only operates on the proper sequence part.

* lib/std/base.lua (ireverse): Ignore any holes in the argument

table, returning only the reversed proper sequence part.

* NEWS.md: Update.

std: make ripairs respect contiguous integer keys like ipairs.

* lib/std/base.lua (ripairs): Start from lowest contiguous integer

key with a nil value, and iterate backwards to 1.

* NEWS.md: Update.

std: revert std.ipairs to return all contiguous key pairs 1..n.

Now that Lua 5.3 returned to an ipairs implementation that returns

contiguous key-value pairs from 1..n, where n is the last non-nil

integer key, stdlib can do the same for simpler compliance with

all supported Lua versions.

* lib/std/base.lua (ipairs): Simplify accordingly.

* lib/std.lua.in (ipairs): Update LDocs accordingly.

* NEWS.md: Update.

maint: commit git rockspec to master branch.

* .gitignore: Allow git rockspecs.

* stdlib-git-1.rockspec: New file.

configury: add ansicolors to travis_extra_rocks.

* bootstrap.conf (buildreq): Bump Specl requirement to 14.1.0.

(travis_extra_rocks): Add ansicolors for color specl output.

* .travis.yml: Regenerate.

maint: add 5.3 to compatibility statement.

* README.md: Add 5.3 to compatibility statement.

* specs/std_spec.yaml (std.version): Update accordingly.

maint: update copyrights.

* COPYING, README.md, bootstrap.conf, configure.ac, local.mk,

specs/optparse_spec.yaml, specs/string_spec.yaml: Add 2015 to

copyright statement.

rockspec: Lua 5.4 and higher not yet supported.

* rockspec.conf (dependencies): Add lua < 5.4 constraint.

io: pass io.die message as an error() string.

* lib/std/io.lua (warnfmt): New function factored out of warn().

Adjust callers.

(die): Pass result of warnfmt to error instead of writing directly

to stderr.

* specs/io_spec.yaml, specs/optparse_spec.yaml: Adjust

specifications accordingly.

* NEWS.md: Update.

specs: support Lua 5.3 variants of core error messages.

* specs/container_spec.yaml, specs/debug_spec.ymal: Also accept

slightly different error message formats from Lua 5.3 core.

slingshot: sync with upstream, for Lua 5.3.0 compatibility.

* slingshot: Sync with upstream.

* bootstrap: Update from slingshot.

* NEWS: Move from here...

* NEWS.md: ...to here. Reformat as Markdown and update.

* local.mk (old_NEWS_hash): Update.

* .gitignore: Add NEWS.

* .travis.yml: Regenerate.

2014-12-29 Gary V. Vaughan <gary@gnu.org>

string: consistent numbertosi output in Lua 5.3.

* lib/std/string.lua (numbertosi): Be careful to output an

integer even when handling a number ('double') in Lua 5.3.

maint: 5.3 uses load instead of loadstring.

* lib/std/base.lua (loadstring): Set to load if loadstring is not

available.

* lib/std/functional.lua (loadstring): Likewise.

maint: preliminary Lua 5.3.0 compatibility.

* configure.ac (AX_PROG_LUA): Accept Lua 5.3 interpreters.

* lib/std/io.lua (setmetatable): Define locally to

debug.setmetatable for resetting FILE* metatable in given

namespace.

* lib/std/base.lua, lib/std/debug.lua, lib/std/functional.lua,

lib/std/list.lua, lib/std/package.lua (unpack): Set to either

table.unpack or _G.unpack to satisfy Lua 5.1, 5.2 and 5.3.

* specs/spec_helper.lua (unpack): Set appropriately for all

supported Lua releases.

* NEWS: Update.

2014-12-24 Gary V. Vaughan <gary@gnu.org>

specs: use correct Specl > 13 arity for bad argument errors.

Now that Specl's badargs module is generating examples with

the correct messages, we can now say 'no more than 0 arguments'.

* lib/std/debug.lua (toomanyargmsg): Return singular 'argument'

in error message only for exactly 1 expected argument, otherwise

plural.

* bootstrap.conf (buildreq): Bump specl requirement.

refactor: rename operator.deref to operator.get.

* specs/operator_spec.yaml (deref): Rename from this...

(get): ...to this.

* lib/std/operator.lua (deref): Rename from this...

(get): ...to this.

Adjust all callers.

* NEWS: Update.

functional: generalize reduce to any table.

* specs/functional_spec.yaml (reduce): Specify optional iterator

argument defaulting to std.pairs.

Specify requirement for std.ielems when ignoring reduced table

keys.

* specs/operator_spec.yaml (set): Specify behaviours for a new

table element setting operator.

* specs/container_spec.yaml: Use appropriate iterator functions

for new reduce API.

* lib/std/functional.lua (reduce): Diagnose optional iterator

argument to std.pairs.

(fold): Copy old reduce implementation into deprecated call.

* lib/std.lua.in (barrel): Adjust accordingly.

* lib/std/base.lua (reduce): Default optional iterator argument

to std.pairs.

Pass all iterator results to accumulator function.

Adjust all clients.

* lib/std/operator.lua (set): Implement according to new specs.

* NEWS: Update.

functional: improve lambda expressiveness.

* specs/functional_spec.yaml: Specify new behaviours with omitted

optional '=', and '_' alias argument.

* lib/std/functional.lua (lambda): Strip more useless whitespace

in parsing to improve memoize cache hits.

Support omitting leading '=' when first non-whitespace of lambda

string is '_'.

Add '_' alias to '_1' for lambda string compiled expressions.

Update LDocs.

doc: show release version in LDocs column headings.

* build-aux/config.ld.in (project): Add release version.

2014-12-21 Gary V. Vaughan <gary@gnu.org>

string: don't return spurious additional values.

* lib/std/base.lua (escape_pattern): Wrap gsub return value in

parens to strip all but the first string return value.

* lib/std/string.lua (caps, chomp, escape_shell, ltrim, rtrim)

(trim): Likewise.

io: add dirname function again.

* specs/io_spec.yaml (dirname): Specify behaviour of a new

function to discard the final path separator in a string and all

that follows.

* lib/std/io.lua (M.dirname): Implement it.

* NEWS: Update.

vector: remove unneeded module.

On second thoughts, this is not necessary. Adding methods to core

table would give us the API benefits, and posix.curses.chstr is a

much easier way of handling arrays of attributed strings.

* lib/std/vector.lua: Remove.

* build-aux/config.ld.in (file): Remove lib/std/vector.lua.

* local.mk (dist_luastd_DATA): Likewise.

(dist_classes_DATA): Remove doc/classes/std.vector.html.

* specs/vector_spec.yaml: Remove.

* specs/string_spec.yaml (render): Remove vector examples.

* specs/specs.mk (specl_SPECS): Remove specs/vector_spec.yaml.

* NEWS: Remove vector references.

2014-12-16 Gary V. Vaughan <gary@gnu.org>

configury: adopt semantic versioning.

* configure.ac (AC_INIT): Set version to 41.0.0.

2014-11-05 Gary V. Vaughan <gary@gnu.org>

maint: fix bitrot in README.

* README.md: Update.

2014-10-05 Gary V. Vaughan <gary@gnu.org>

specs: simplify bad argument checking with specl.badargs.

* specs/spec_helper.lua (badargs): Expose specl.badargs to the

example execution environment.

(badarg, init): Remove. Superseded by badargs.init.

* specs/debug_spec.yaml, specs/string_spec.yaml: Use badargs.init

instead of init.

* specs/functional_spec.yaml, specs/io_spec.yaml,

specs/list_spec.yaml, specs/math_spec.yaml,

specs/package_spec.yaml, specs/std_spec.yaml,

specs/table_spec.yaml: Use badargs.diagnose to write bad argument

diagnostics examples automatically.

* bootstrap.conf (buildreq): Use moonscript rocks server URLs.

travis: remove temporary specl-git-1.rockspec dependency.

* .travis.yml (script): Regenerate from travis.yml.n.

2014-10-01 Gary V. Vaughan <gary@gnu.org>

slingshot: sync with upstream for SPECL_ENV improvements.

* slingshot: Sync with upstream.

* specs/specs.mk: Simplify accordingly.

* specs/spec_helper.lua (package.path): Set according to slingshot

recommendations.

* bootstrap.conf: Require latest specl, and tidy accordingly.

functional: fill unbound arguments in order with bind.

* lib/std/functional (bind): When filling unbound arguments, be

sure to traverse the remaining arguments *in* order!

debug: improve argscheck parsing patterns.

* lib/std/debug.lua (argscheck): Strip leading and trailing

whitespace from argument type list.

Allow commas without trailing whitespace.

Allow periods in `fname` pattern.

travis: reformat .travis.yml.

* .travis.yml: Reformat.

travis: use specl-git-1.rockspec from specl git master branch.

* .travis.yml (script): Adjust specl-git-1.rockspec URL.

refactor: rationalize deprecation interfaces.

Tracking one deprecation warning per deprecated function is

fiddly and confusing. Change the semantics to this: by

default calling deprecated API fires a warning message; turn

off the messages with `_DEBUG.deprecate = false`; elide

deprecated APIs entirely with `_DEBUG.deprecate = true`.

Easy and useful :)

* lib/std/debug_init/init.lua (_ARGCHECK): Remove. Adjust all

callers to use _DEBUG.argcheck instead.

(_DEBUG): Always a table, with fields initialised according to

global _DEBUG if necessary. Simplify all callers accordingly.

* lib/std/debug.lua (setcompat, getcompat): Remove.

(DEPRECATIONMSG): If _DEBUG.deprecate is nil, always return a

deprecation message, otherwise the empty string.

(DEPRECATED): If _DEBUG.deprecate is truthy, don't return a

function at all.

(_setdebug): New private function. A reliable way to jigger the

_DEBUG table contents, without worrying about nested specl

environments.

* specs/spec_helper.lua (setdebug): Import std.debug._setdebug

into the outermost execution environment.

* specs/debug_spec.yaml (extend_base): Add _setdebug.

Adjust other behaviour specs to match saner _DEBUG.deprecate

semantics.

* specs/functional_spec.yaml, specs/list_spec.yaml,

specs/string_spec.yaml, specs/table_spec.yaml: Adjust deprecation

warning behaviour examples to match new semantics.

* NEWS: Update.

2014-09-04 Gary V. Vaughan <gary@gnu.org>

tree: use argscheck on exported apis.

* lib/std/tree.lua: Move LDocs and add argschecks to returned

Tree object function declarations.

set: check for strict Set type arguments.

Since we have type checking to help maintain correctness, don't

undermine ourselves and add complexity by adding type coercions

and looser type safety. When we're using Set's, passing a table

instead of a Set is probably an error, so treat it as one!

* specs/set_spec.yaml: Remove specifications for type coercions.

* lib/std/set.lua: Remove type coercions and require strict Set

arguments everywhere.

Add type checks to metamethods.

* NEWS: Update.

strbuf: use argscheck on exported apis.

* lib/std/strbuf.lua: Move LDocs and add argschecks to returned

StrBuf object declarations.

* HACKING: Update.

set: use argscheck on exported apis.

* lib/std/set.lua: Move LDocs and add argschecks to returned Set

object declaration.

* HACKING: Add items about best practices for `debug.argscheck`.

2014-09-03 Gary V. Vaughan <gary@gnu.org>

refactor: simplify primitive std.set functions.

* lib/std/set.lua (insert, delete): Return results of calling

rawset.

refactor: simplify string.render and clients.

* lib/std/base.lua (render): Use `cb` suffix for callback

parameter names.

Rename j and w locals to k_ and v_, as they represent the values

of k and v resp. from the previous iteration.

Remove unrelated Haskell comments.

* lib/std/string.lua (prettytostring): Likewise.

* lib/std/container.lua (__tostring): Manually unroll render

invocation with base.tostring functions plugged in.

2014-09-02 Gary V. Vaughan <gary@gnu.org>

refactor: factor away std.container.__pairs.

Object pairs iteration shouldn't rely on slow in-order traversal,

we only care about key order when printing.

* lib/std/container.lua (__pairs): Remove. By the time this is

called, private keys are already moved into the metatable, and

the client would be using ipairs and okeys for ordered traversal.

(__tostring): Use ipairs and okeys here, because we do care about

ordering.

std: use numeric keys first ordering when stringifying a table.

Closes #81.

* specs/table_spec.yaml (okeys): Specify behaviours of a new

ordered keys function.

* lib/std/container.lua (__pairs): Factor key sorting algorithm

from here...

* lib/std/base.lua (keysort): New function. ...to here.

(okeys): Use keysort to extract a sorted key list from a table.

* lib/std/table.lua (okeys): Re-export from here.

* lib/std/base.lua (render): Simplify accordingly, and always

sort keys nicely as a pleasant side-effect.

* NEWS: Update.

2014-09-01 Gary V. Vaughan <gary@gnu.org>

doc: Use LDoc @object type for std.vector.

Closes #65.

* lib/std/vector.lua: Improve documentation.

2014-08-31 Gary V. Vaughan <gary@gnu.org>

doc: use LDoc @object type for std.tree.

* lib/std/tree.lua: Improve documentation.

doc: use LDoc @object type for std.strbuf.

* lib/std/strbuf.lua: Improve documentation.

doc: use LDoc @object type for std.list

* lib/std/list.lua: Improve documentation.

refactor: upgrade OptionParser implementation to a std.object.

* lib/std/optparse.lua (OptionParser): Reimplement as a std.object,

and simplify accordingly.

doc: use LDoc @object type for std.set.

* lib/std/set.lua: Improve documentation.

doc: use LDoc @object type for std.container.

* lib/std/container.lua: Improve documentation.

doc: use LDoc @object type for std.object.

* build-aux/config.ld.in (object): New type for documenting

objects.

* lib/std/object.lua: Improve documentation.

doc: add prototype chains to object LDocs.

* lib/std/list.lua, lib/std/set.lua, lib/std/strbuf.lua,

lib/std/tree.lua, lib/std/vector.lua: LDocument prototype chains.

doc: simplify and clarify container and object LDocs.

* lib/std/object.lua, lib/std/container.lua: Simplify and clarify

LDocs.

doc: fix a broken cross-reference.

* lib/std/container.lua (std.container): Now that we're not

documenting inherited methods, reference std.object.__call from

the prototype object.

* HACKING: Document rationale for slimming LDocs in this way.

debug: argcheck accepts objects as valid table type arguments.

Closes #84.

Really, table is the base type of object (or strictly speaking,

container), and its almost always desirable to be able to pass

objects to functions that operate on tables.

* specs/debug_spec.yaml (argcheck): Specify this behaviour when

an object argument is given where a table is required.

* lib/std/debug.lua (argcheck): Accept any object argument

where a table parameter is expected.

2014-08-30 Gary V. Vaughan <gary@gnu.org>

table: deprecate totable.

Closes #74.

* specs/container_spec.yaml (tablification): Remove specs.

* specs/object_spec.yaml (copy): Use this new function instead of

`totable`.

* specs/object_spec.yaml, specs/set_spec.yaml,

specs/strbuf_spec.yaml, specs/tree_spec.yaml (__totable): Remove.

* specs/table_spec.yaml (totable): Deprecate this function.

* specs/spec_helper.lua (totable): Remove.

* lib/std/table.lua (totable): Likewise.

* lib/std/base.lua (totable): Remove implementation.

* lib/std.lua.in (barrel): Remove "table.totable".

* lib/std/container.lua (__totable): Remove.

(__pairs): Return elements in order, omitting private elements.

(__tostring): Use it to concatenate elements in order.

(__call, instantiate, mapfields): Iterate with `next` to fetch

raw elements, rather than ordered object __pairs elements.

* lib/std/object (__totable): Remove reference.

* lib/std/set.lua (__totable): Remove.

(__tostring): Fetch keys for display using std.pairs.

* lib/std/string.lua (pickle): Likewise.

* NEWS: Update.

2014-08-29 Gary V. Vaughan <gary@gnu.org>

doc: overhaul LDocs for std.table.

* lib/std/table.lua: Tidy up LDocs, and add @usage examples.

2014-08-28 Gary V. Vaughan <gary@gnu.org>

table: add remove for orthogonality with insert.

* specs/table_spec.yaml (remove): Specify expected behaviour.

* lib/std/table.lua (remove): Implement specified behaviors.

* NEWS: Update.

refactor: modules can only require std.base and std.debug.

* lib/std/table.lua (totable): Move implementation from here...

* lib/std/base.lua (totable): ...to here.

* lib/std/string.lua: Import core implementation from std.base

instead of argcheck wrapper from std.table.

* lib/std/io.lua (dirsep, catfile): Move implementations from

here...

* lib/std/string.lua (escape_pattern): ...here...

* lib/std/table.lua (invert): ... and here...

* lib/std/base.lua (dirsep, catfile, invert): ...to here.

* lib/std/package.lua: Import core implementations from std.base

instead eof argcheck wrappers from user interface files.

* lib/std/list.lua, lib/std/tree.lua (func): Remove spurious

require.

* lib/std/set.lua, lib/std/tree.lua, lib/std/vector.lua

(container): Fold into Container prototype constructor.

* lib/std/list.lua, lib/std/strbuf.lua (object): Fold into

Object prototype constructor.

* lib/std/string.lua (strbuf): Fold into StrBuf prototype

constructor.

* lib/std/math.lua (debug): Fold into X definition.

* HACKING: Add a description of how to use `require`

idiomatically in stdlib source.

table: ensure there is always a maxn function.

* specs/table_spec.yaml (maxn): Specify behaviour of maxn.

(len): Add missing specifications.

* specs/std_spec.yaml (barrel): Add maxn to list of monkey_patch

apis from std.table.

* lib/std/base.lua (maxn): Use core table.maxn if available, or

else define our own.

* lib/std/container.lua, lib/std/debug.lua: Use it!

* lib/std/table.lua (maxn): Export it.

* NEWS: Update.

refactor: make all monkey_patch functions work the same.

* specs/std_spec.yaml, specs/io_spec.yaml, specs/math_spec.yaml,

specs/string_spec.yaml, specs/table_spec.yaml (monkey_patch):

Specify injection of all exported apis into the given namespace.

* lib/std/base.lua (copy): Support an optional `dest` argument.

(merge): Like copy, but don't overwrite pre-existing entries at

the same key.

* lib/std.lua.in, lib/std/io.lua, lib/std/math.lua,

lib/std/string.lua, lib/std/table.lua: Use merge and copy to

simplify tracking and injecting monkey_patches.

* specs/std_specl.yaml (barrel): Specify behaviour of running all

monkey_patch functions, and recreating the legacy global api by

additionally injecting those functions.

* lib/std.lua.in (barrel): Update to meet tighter specifications.

* HACKING: Note about global hygiene and use of monkey_patch ().

* NEWS: Update.

2014-08-27 Gary V. Vaughan <gary@gnu.org>

package: tidy up LDocs, and remove unnecessary M references.

* lib/std/package.lua (pathsub, find): Remove spurious `M.`

prefixes.

(mappath_callback): Rename from this...

(mappathcb): ...to this.

* HACKING: Add LDoc style notes.

functional: remove std.operator expansions from lambda.

There's no good reason to clog up the lambda functable with a copy