% -*- texinfo -*-
% @deftypefn {Function File} {} dlmwrite (@var{file}, @var{a})
% @deftypefnx {Function File} {} dmlwrite (@var{file}, @var{a}, @var{delim}, @var{r}, @var{c})
% @deftypefnx {Function File} {} dmlwrite (@var{file}, @var{a}, 'attrib1', @var{value1}, 'attrib2', @var{value2}, @dots{})
% @deftypefnx {Function File} {} dmlwrite (@var{file}, @var{a}, '-append', @dots{})
%
% Write the matrix @var{a} to the text @var{file} using delimiters.
%
% @table @var
% @item delim
% the delimiter to use to separate values on a row
%
% @item r
% the number of delimiter-only lines to add to the start of the file
%
% @item c
% the number of delimiters to prepend to each line of data.
%
% @item '-append'
% append to the end of the @var{file}.
%
% @item 'append', state
% Either @samp{'on'} or @samp{'off'}. See @samp{'-append'} above.
%
% @item 'delimiter', d
% See @var{delim} above.
%
% @item 'newline', os
% The character(s) to use to separate each row. Three special cases
% exist for this option. @samp{'unix'} is changed into '\n',
% @samp{'pc'} is changed into '\r\n', and @samp{'mac'} is changed
% into '\r'. Other values for this option are kept as is.
%
% @item 'roffset', r
% See @var{r} above.
%
% @item 'coffset', c
% See @var{c} above.
%
% @item 'precision', p
% The precision to use when writing the file. It can either be a
% format string (as used by fprintf) or a number of significant digits.
% @end table
%
% @example
% @var{A} = reshape(1:16,4,4);
% dlmwrite(@code{'file.csv'}, @var{A})
% @end example
%
% @example
% dlmwrite (@code{'file.tex'}, @var{a}, 'delimiter', '&', 'newline', '\\n')
% @end example
%
% @seealso{dlmread, csvread, csvwrite}
% @end deftypefn