Mercurial > hg > octave-lyh

comparison scripts/deprecated/java_new.m @ 15771:4698ea77aa75

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Hide java_init, java_exit functions. Deprecate java_new, java_set, java_get. * ov-java.cc: Rename java_init, java_exit to internal versions __java_init__, __java_exit__. Remove java_new. Rename java_set, java_get to __java_set__, __java_get__. Use #ifdef HAVE_JAVA blocks to compile the docstrings for Java functions regardless of whether Java is present. Use Octave coding conventions. * scripts/deprecated/java_get.m, scripts/deprecated/java_new.m, scripts/deprecated/java_set.m: Create new scripts to issue a warning about deprecated functions. * scripts/deprecated/module.mk: Add new deprecated scripts to build system.
author Rik <rik@octave.org>
date Wed, 12 Dec 2012 13:33:37 -0800
parents
children 2abea2cfdace
comparison
equal deleted inserted replaced
15770:e61405133a76 15771:4698ea77aa75
1 ## Copyright (C) 1995-2012 Kurt Hornik
2 ##
3 ## This file is part of Octave.
4 ##
5 ## Octave is free software; you can redistribute it and/or modify it
6 ## under the terms of the GNU General Public License as published by
7 ## the Free Software Foundation; either version 3 of the License, or (at
8 ## your option) any later version.
9 ##
10 ## Octave is distributed in the hope that it will be useful, but
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 ## General Public License for more details.
14 ##
15 ## You should have received a copy of the GNU General Public License
16 ## along with Octave; see the file COPYING. If not, see
17 ## <http://www.gnu.org/licenses/>.
18
19 ## -*- texinfo -*-
20 ## @deftypefn {Loadable Function} {@var{obj} =} java_new (@var{name})
21 ## @deftypefnx {Loadable Function} {@var{obj} =} java_new (@var{name}, @var{arg1}, @dots{})
22 ## Create a Java object of class @var{name}, by calling the class constructor
23 ## with the arguments @var{arg1}, @dots{}
24 ##
25 ## @example
26 ## @group
27 ## x = java_new ("java.lang.StringBuffer")
28 ## x = java_new ("java.lang.StringBuffer", "Initial string")
29 ## @end group
30 ## @end example
31 ##
32 ## @seealso{javaObject, java_invoke}
33 ## @end deftypefn
34
35 function retval = java_new (varargin)
36
37 persistent warned = false;
38 if (! warned)
39 warned = true;
40 warning ("Octave:deprecated-function",
41 "java_new is obsolete and will be removed from a future version of Octave; please use javaObject instead");
42 endif
43
44 if (nargin < 2)
45 print_usage ();
46 endif
47
48 retval = javaObject (varargin);
49
50 endfunction
51