% -*- texinfo -*-
% @deftypefn{Function File} ex = fexist (file, tspec, aspec)
% Checks whether a file exists.
% @var{file} is the queried file path.
% @var{tspec} is a combination of letters f,d,p,S, corresponding
% to file types:
% @itemize
% @item f: regular file
% @item d: directory
% @item p: named pipe (FIFO special file)
% @item S: socket
% @end itemize
%
% The query is true if the actual file type matches any of
% the specified options.
%
% @var{aspec} is a combination of letters r,w,x, corresponding
% to queried access privileges to the file. The query is true
% if the current user has all the spefied types of access, either
% through 'user', 'group' or 'other' specs.
%
% @seealso{stat, lstat}
% @end deftypefn