Deprecate Array::capacity() and Sparse::capacity() for numel() and nzmax(). * liboctave/array/Array.h (Array::capacity): deprecate for ::numel(). * liboctave/array/Sparse.h (Sparse::capacity): deprecate for ::nzmax(). Also move comments into doxygen docs. * libinterp/corefcn/daspk.cc, libinterp/corefcn/dasrt.cc, libinterp/corefcn/dassl.cc, libinterp/corefcn/jit-typeinfo.h, libinterp/corefcn/quad.cc, libinterp/corefcn/variables.cc, libinterp/octave-value/ov-base-sparse.h, libinterp/octave-value/ov-base.h, libinterp/octave-value/ov.h, liboctave/array/Sparse.cc, liboctave/numeric/DASPK.cc, liboctave/numeric/DASRT.cc, liboctave/numeric/DASSL.cc, liboctave/numeric/LSODE.cc, liboctave/numeric/Quad.cc, liboctave/numeric/base-de.h, liboctave/numeric/base-min.h, liboctave/numeric/oct-rand.cc: replace use of capacity by numel() or nzmax() as appropriate.

% this script is intended to be Matlab compatible
% first, run the script
%
%   ./build_bc_overloads_tests.sh overloads_only
%
% to generate the overloaded functions.
%
ex.double = 1;
ex.single = single (1);
ex.logical = true;
ex.char = 'char';
ex.int8  = int8 (1);
ex.int16 = int16 (1);
ex.int32 = int32 (1);
ex.int64 = int64 (1);
ex.uint8  = uint8 (1);
ex.uint16 = uint16 (1);
ex.uint32 = uint32 (1);
ex.uint64 = uint64 (1);
ex.cell = {};
ex.struct = struct ();
ex.function_handle = @numel;

f = fieldnames (ex);
n = numel (f);

fid = fopen ('bc_overloads_expected','w');
fid
for i = 1:n
  for j = 1:n
    s = tbcover (ex.(f{i}), ex.(f{j}));
    fprintf (fid, '%s %s %s\n', f{i}, f{j}, s);
  end
end
fclose (fid)