1########################################################################
2##
3## Copyright (C) 2017-2021 The Octave Project Developers
4##
5## See the file COPYRIGHT.md in the top-level directory of this
6## distribution or <https://octave.org/copyright/>.
7##
8## This file is part of Octave.
9##
10## Octave is free software: you can redistribute it and/or modify it
11## under the terms of the GNU General Public License as published by
12## the Free Software Foundation, either version 3 of the License, or
13## (at your option) any later version.
14##
15## Octave is distributed in the hope that it will be useful, but
16## WITHOUT ANY WARRANTY; without even the implied warranty of
17## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18## GNU General Public License for more details.
19##
20## You should have received a copy of the GNU General Public License
21## along with Octave; see the file COPYING.  If not, see
22## <https://www.gnu.org/licenses/>.
23##
24########################################################################
25
26## -*- texinfo -*-
27## @deftypefn  {} {} import PACKAGE.FUNCTION
28## @deftypefnx {} {} import PACKAGE.CLASS
29## @deftypefnx {} {} import PACKAGE.*
30## @deftypefnx {} {} import
31## @deftypefnx {} {@var{list} =} import
32##
33## Import function or classes into the current scope.
34##
35## @strong{Warning:} This functionality is not yet implemented, and invoking
36## the function will emit an error.
37##
38## When invoked with the name of a PACKAGE and a FUNCTION or CLASS name, that
39## name is made available in the current code without having to use namespace
40## qualifiers.  This can facilitate the readability of the code, and require
41## less typing by programmers.
42##
43## Example
44##
45## @example
46## @group
47## import containers.Map;
48##
49## m = Map (@{"A", "B"@}, @{[1], [2]@});
50## @end group
51## @end example
52##
53## When called with no inputs and no outputs @code{import} prints a list of
54## any import definitions.
55##
56## When called with no inputs and one output, a cell array of strings
57## @var{list} is returned with any import definitions.
58##
59## @end deftypefn
60
61function list = import (varargin)
62
63  error ("the import function is not yet implemented in Octave");
64
65endfunction
66
67
68%!error <not yet implemented> import ("foobar");
69