% -*- texinfo -*-
% @deftypefn {@var{data} =} fetch (@var{conn}, @var{symbol})
% @deftypefnx {@var{data} =} fetch (@dots{}, @var{fields})
% @deftypefnx {@var{data} =} fetch (@dots{}, @var{date})
% @deftypefnx {@var{data} =} fetch (@dots{}, @var{fromdate}, @var{todate})
% @deftypefnx {@var{data} =} fetch (@dots{}, @var{period})
% @deftypefnx {[@var{data}, @var{fields}] =} fetch (@dots{})
%
% Download stock data from a connection.
%
% @var{fields} are the data fields to download and must come from the
% set
% @itemize @bullet
% @item 'Symbol'
% @item 'Last'
% @item 'Date'
% @item 'Time'
% @item 'Change'
% @item 'Open'
% @item 'High',
% @item 'Low'
% @item 'Volume'
% @end itemize
%
% As an output, @var{fields} may be different than your request. This
% is because there is mapping of field names from the data source to
% the output, and what is returned is the source mapping to allow
% validation.
%
% @var{date} is the date string or datenum for the requested data. If
% you enter today's date, you will get yesterday's data. @var{fromdate}
% and @var{todate} allow you to specify a date range for the data.
%
% @var{period} (default: 'd') allows you to select the period for the
% data which can be any of the below as long as they are supported by
% the associated backend.
% @itemize @bullet
% @item 'd': daily
% @item 'w': weekly
% @item 'm': monthly (Yahoo only)
% @item 'v': dividends (Yahoo only)
% @end itemize
%
% @seealso{yahoo, google}
% @end deftypefn