function m_gshhs_f(varargin);
% M_GSHHS_F Add a coastline to a given map using the 'full' resolution of
%           the Global Self-consistant Hierarchical High-resolution 
%           Shorelines.
%
%         M_GSHHS_F( (standard line option,...,...) ) draws the coastline
%         as a simple line.
%         M_GSHHS_F('patch' ( ,standard patch options,...,...) ) draws the 
%         coastline as a number of patches. 
%
%         M_GSHHS_F('save',FILENAME) saves the extracted coastline data
%         for the current projection in a file FILENAME. This allows 
%         speedier replotting using M_USERCOAST(FILENAME). 
%    
%         See also M_PROJ, M_GRID, M_COAST, M_GSHHS_L, M_GSHHS_I, M_GSHHS_C 
%         M_USERCOAST    

% Rich Pawlowicz (rich@ocgy.ubc.ca) 31/Aug/98
%
%
% This software is provided "as is" without warranty of any kind. But
% it's mine, so you can't sell it.


FILNAME='private/gshhs_f.b';

% Set current projection to geographic
Currentmap=m_coord('set');
m_coord('geographic');

if length(varargin)>1 & strcmp(varargin{1},'save'),
  [ncst,Area,k]=mu_coast('f',FILNAME);
  eval(['save ' varargin{2} ' ncst k Area']);
else
  mu_coast('f',FILNAME,varargin{:},'tag','m_gshhs_f');
end;

m_coord(Currentmap.name);