% -*- texinfo -*-
% @deftypefn {Function File} {} bw_start
% @deftypefnx {Function File} {} bw_start (@var{f}, @var{argfile})
% Start parallel computation in a beowulf cluster.
%
% With no arguments, restart all unfinished jobs.
%
% With two arguments, (re)start job. String @var{f} names a function to
% be started multiple times in parallel. @var{argfile} names a data-file in
% the configured data directory containing a one-dimensional cell-array
% with arguments for @var{f}, one entry for each invocation of @var{f}. @var{f}
% must be of one of the following forms
%
% @example
% function @var{ret} = f (@var{args})
%
% function @var{ret} = f (@var{args}, @var{idx})
% @end example
%
% where @var{args} is an entry of the argument cell-array, @var{idx} is the
% index of this entry, and @var{ret} contains the result of computation.
%
% Users can put configuration commands into the file '~/.bwrc'.
% Variable 'data_dir' contains the configured data directory, default
% is '~/bw-data/'. Directory given in variable 'state_dir', default
% '~/.bw-state/', is used internally to read and write state
% information. If this directory does not exist it is created, which
% will fail if there would be more than one level to create.
% @seealso {bw_list, bw_retrieve, bw_clear}
% @end deftypefn