annotate libinterp/op-kw-docs @ 29949:f254c302bb9c

remove JIT compiler from Octave sources As stated in the NEWS file entry added with this changeset, no one has ever seriously taken on further development of the JIT compiler in Octave since it was first added as part of a Google Summer of Code project in 2012 and it still does nothing significant. It is out of date with the default interpreter that walks the parse tree. Even though we have fixed the configure script to disable it by default, people still ask questions about how to build it, but it doesn’t seem that they are doing that to work on it but because they think it will make Octave code run faster (it never did, except for some extremely simple bits of code as examples for demonstration purposes only). * NEWS: Note change. * configure.ac, acinclude.m4: Eliminate checks and macros related to the JIT compiler and LLVM. * basics.txi, install.txi, octave.texi, vectorize.txi: Remove mention of JIT compiler and LLVM. * jit-ir.cc, jit-ir.h, jit-typeinfo.cc, jit-typeinfo.h, jit-util.cc, jit-util.h, pt-jit.cc, pt-jit.h: Delete. * libinterp/parse-tree/module.mk: Update. * Array-jit.cc: Delete. * libinterp/template-inst/module.mk: Update. * test/jit.tst: Delete. * test/module.mk: Update. * interpreter.cc (interpreter::interpreter): Don't check options for debug_jit or jit_compiler. * toplev.cc (F__octave_config_info__): Remove JIT compiler and LLVM info from struct. * ov-base.h (octave_base_value::grab, octave_base_value::release): Delete. * ov-builtin.h, ov-builtin.cc (octave_builtin::to_jit, octave_builtin::stash_jit): Delete. (octave_builtin::m_jtype): Delete data member and all uses. * ov-usr-fcn.h, ov-usr-fcn.cc (octave_user_function::m_jit_info): Delete data member and all uses. (octave_user_function::get_info, octave_user_function::stash_info): Delete. * options.h (DEBUG_JIT_OPTION, JIT_COMPILER_OPTION): Delete macro definitions and all uses. * octave.h, octave.cc (cmdline_options::cmdline_options): Don't handle DEBUG_JIT_OPTION, JIT_COMPILER_OPTION): Delete. (cmdline_options::debug_jit, cmdline_options::jit_compiler): Delete functions and all uses. (cmdline_options::m_debug_jit, cmdline_options::m_jit_compiler): Delete data members and all uses. (octave_getopt_options long_opts): Remove "debug-jit" and "jit-compiler" from the list. * pt-eval.cc (tree_evaluator::visit_simple_for_command, tree_evaluator::visit_complex_for_command, tree_evaluator::visit_while_command, tree_evaluator::execute_user_function): Eliminate JIT compiler code. * pt-loop.h, pt-loop.cc (tree_while_command::get_info, tree_while_command::stash_info, tree_simple_for_command::get_info, tree_simple_for_command::stash_info): Delete functions and all uses. (tree_while_command::m_compiled, tree_simple_for_command::m_compiled): Delete member variable and all uses. * usage.h (usage_string, octave_print_verbose_usage_and_exit): Remove [--debug-jit] and [--jit-compiler] from the message. * Array.h (Array<T>::Array): Remove constructor that was only intended to be used by the JIT compiler. (Array<T>::jit_ref_count, Array<T>::jit_slice_data, Array<T>::jit_dimensions, Array<T>::jit_array_rep): Delete. * Marray.h (MArray<T>::MArray): Remove constructor that was only intended to be used by the JIT compiler. * NDArray.h (NDArray::NDarray): Remove constructor that was only intended to be used by the JIT compiler. * dim-vector.h (dim_vector::to_jit): Delete. (dim_vector::dim_vector): Remove constructor that was only intended to be used by the JIT compiler. * codeql-analysis.yaml, make.yaml: Don't require llvm-dev. * subst-config-vals.in.sh, subst-cross-config-vals.in.sh: Don't substitute OCTAVE_CONF_LLVM_CPPFLAGS, OCTAVE_CONF_LLVM_LDFLAGS, or OCTAVE_CONF_LLVM_LIBS. * Doxyfile.in: Don't define HAVE_LLVM. * aspell-octave.en.pws: Eliminate jit, JIT, and LLVM from the list of spelling exceptions. * build-env.h, build-env.in.cc (LLVM_CPPFLAGS, LLVM_LDFLAGS, LLVM_LIBS): Delete variables and all uses. * libinterp/corefcn/module.mk (%canon_reldir%_libcorefcn_la_CPPFLAGS): Remove $(LLVM_CPPFLAGS) from the list. * libinterp/parse-tree/module.mk (%canon_reldir%_libparse_tree_la_CPPFLAGS): Remove $(LLVM_CPPFLAGS) from the list.
author John W. Eaton <jwe@octave.org>
date Tue, 10 Aug 2021 16:42:29 -0400
parents 1591e7470f1a
children 796f54d4ddbf
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
27923
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
1 ########################################################################
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
2 ##
29358
0a5b15007766 update Octave Project Developers copyright for the new year
John W. Eaton <jwe@octave.org>
parents: 27923
diff changeset
3 ## Copyright (C) 1993-2021 The Octave Project Developers
27918
b442ec6dda5c use centralized file for copyright info for individual contributors
John W. Eaton <jwe@octave.org>
parents: 26778
diff changeset
4 ##
27923
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
5 ## See the file COPYRIGHT.md in the top-level directory of this
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
6 ## distribution or <https://octave.org/copyright/>.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
7 ##
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
8 ## This file is part of Octave.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
9 ##
24534
194eb4bd202b maint: Update punctuation for GPL v3 license text.
Rik <rik@octave.org>
parents: 24510
diff changeset
10 ## Octave is free software: you can redistribute it and/or modify it
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
11 ## under the terms of the GNU General Public License as published by
24534
194eb4bd202b maint: Update punctuation for GPL v3 license text.
Rik <rik@octave.org>
parents: 24510
diff changeset
12 ## the Free Software Foundation, either version 3 of the License, or
22755
3a2b891d0b33 maint: Standardize Copyright formatting.
Rik <rik@octave.org>
parents: 22431
diff changeset
13 ## (at your option) any later version.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
14 ##
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
15 ## Octave is distributed in the hope that it will be useful, but
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
16 ## WITHOUT ANY WARRANTY; without even the implied warranty of
22755
3a2b891d0b33 maint: Standardize Copyright formatting.
Rik <rik@octave.org>
parents: 22431
diff changeset
17 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3a2b891d0b33 maint: Standardize Copyright formatting.
Rik <rik@octave.org>
parents: 22431
diff changeset
18 ## GNU General Public License for more details.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
19 ##
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
20 ## You should have received a copy of the GNU General Public License
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
21 ## along with Octave; see the file COPYING. If not, see
24534
194eb4bd202b maint: Update punctuation for GPL v3 license text.
Rik <rik@octave.org>
parents: 24510
diff changeset
22 ## <https://www.gnu.org/licenses/>.
27923
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
23 ##
bd51beb6205e update formatting of copyright notices
John W. Eaton <jwe@octave.org>
parents: 27919
diff changeset
24 ########################################################################
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
25
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
26 !
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
27 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
28 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
29 @deftypefn {} {} !
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
30 Logical 'not' operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
31 @seealso{~, not}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
32 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
33 ~
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
34 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
35 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
36 @deftypefn {} {} ~
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
37 Logical 'not' operator.
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
38
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
39 The symbol may also be used to discard outputs of a function that are unwanted
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
40 without using a temporary variable.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
41
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
42 @example
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
43 [~, @var{idx_of_max}] = max (@var{x})
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
44 @end example
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
45 @seealso{!, not}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
46 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
47 !=
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
48 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
49 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
50 @deftypefn {} {} !=
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
51 Logical 'not equals' operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
52 @seealso{~=, ne}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
53 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
54 ~=
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
55 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
56 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
57 @deftypefn {} {} ~=
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
58 Logical 'not equals' operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
59 @seealso{!=, ne}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
60 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
61 "
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
62 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
63 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
64 @deftypefn {} {} "
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
65 String delimiter.
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
66
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
67 Escape sequences within double-quoted strings are expanded. I.e., "\n" is a
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
68 1-character string representing a newline. See the single quote delimiter (')
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
69 to create strings without escape sequence processing.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
70 @seealso{'}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
71 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
72 #
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
73 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
74 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
75 @deftypefn {} {} #
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
76 Begin comment character.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
77 @seealso{%, #@\{}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
78 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
79 %
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
80 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
81 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
82 @deftypefn {} {} %
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
83 Begin comment character.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
84 @seealso{#, %@\{}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
85 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
86 #{
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
87 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
88 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
89 @deftypefn {} {} #@{
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
90 Begin block comment.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
91
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
92 The sequence @code{#@{} must appear alone on a line with no other characters,
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
93 other than whitespace, before or after it. It is possible to nest block
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
94 comments.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
95 @seealso{%@\{, #@\}, #}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
96 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
97 %{
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
98 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
99 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
100 @deftypefn {} {} %@{
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
101 Begin block comment.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
102
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
103 The sequence @code{%@{} must appear alone on a line with no other characters,
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
104 other than whitespace, before or after it. It is possible to nest block
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
105 comments.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
106 @seealso{#@\{, %@\}, %}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
107 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
108 #}
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
109 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
110 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
111 @deftypefn {} {} #@}
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
112 Close block comment.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
113
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
114 The sequence @code{#@}} must appear alone on a line with no other characters,
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
115 other than whitespace, before or after it. It is possible to nest block
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
116 comments.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
117 @seealso{%@\}, #@\{, #}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
118 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
119 %}
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
120 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
121 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
122 @deftypefn {} {} %@}
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
123 Close block comment.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
124
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
125 The sequence @code{%@}} must appear alone on a line with no other characters,
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
126 other than whitespace, before or after it. It is possible to nest block
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
127 comments.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
128 @seealso{#@\}, %@\{, %}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
129 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
130 ...
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
131 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
132 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
133 @deftypefn {} {} ...
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
134 Continuation marker.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
135
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
136 Joins current line with following line before parsing. This can be used to
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
137 improve the human-readability of Octave code, without affecting interpretation.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
138 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
139 &
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
140 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
141 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
142 @deftypefn {} {} &
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
143 Element-by-element logical 'and' operator.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
144 @seealso{and, &&}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
145 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
146 &&
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
147 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
148 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
149 @deftypefn {} {} &&
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
150 Logical 'and' operator (with short-circuit evaluation).
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
151 @seealso{&}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
152 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
153 '
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
154 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
155 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
156 @deftypefn {} {} '
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
157 Matrix transpose operator or string delimiter.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
158
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
159 For complex matrices, computes the complex conjugate (Hermitian) transpose.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
160
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
161 The single quote character may also be used to delimit strings. Escape
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
162 sequences within single-quoted strings are not expanded. I.e., '\n' is a
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
163 2-character string '\' and 'n' rather than "\n" which is a single character
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
164 representing a newline.
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
165 @seealso{ctranspose, .', "}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
166 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
167 (
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
168 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
169 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
170 @deftypefn {} {} (
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
171 Array index or function argument delimiter.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
172 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
173 )
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
174 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
175 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
176 @deftypefn {} {})
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
177 Array index or function argument delimiter.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
178 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
179 *
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
180 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
181 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
182 @deftypefn {} {} *
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
183 Multiplication operator.
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
184 @seealso{mtimes, .*}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
185 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
186 **
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
187 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
188 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
189 @deftypefn {} {} **
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
190 Power operator.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
191
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
192 This may return complex results for real inputs. Use @code{realsqrt},
25642
cf452aa01cd5 doc: Replace instances of realroot (non-existent) with realpow (bug #54336).
Rik <rik@octave.org>
parents: 25280
diff changeset
193 @code{cbrt}, @code{nthroot}, or @code{realpow} to obtain real results when
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
194 possible.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
195 @seealso{power, ^, .**, .^, realpow, realsqrt, cbrt, nthroot}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
196 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
197 ^
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
198 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
199 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
200 @deftypefn {} {} ^
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
201 Power operator.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
202
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
203 This may return complex results for real inputs. Use @code{realsqrt},
25642
cf452aa01cd5 doc: Replace instances of realroot (non-existent) with realpow (bug #54336).
Rik <rik@octave.org>
parents: 25280
diff changeset
204 @code{cbrt}, @code{nthroot}, or @code{realpow} to obtain real results when
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
205 possible.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
206 @seealso{power, **, .^, .**, realpow, realsqrt, cbrt, nthroot}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
207 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
208 +
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
209 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
210 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
211 @deftypefn {} {} +
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
212 Addition operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
213 @seealso{plus}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
214 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
215 ++
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
216 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
217 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
218 @deftypefn {} {} ++
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
219 Increment operator.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
220
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
221 Add 1 to existing value of variable. As in C, may be applied as a prefix
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
222 (@code{++x}) or postfix (@code{x++}) operator.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
223 @seealso{--}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
224 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
225 ,
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
226 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
227 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
228 @deftypefn {} {} ,
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
229 Array index, function argument, or command separator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
230 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
231 -
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
232 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
233 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
234 @deftypefn {} {} -
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
235 Subtraction or unary negation operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
236 @seealso{minus}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
237 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
238 --
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
239 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
240 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
241 @deftypefn {} {} --
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
242 Decrement operator.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
243
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
244 Subtract 1 from existing value of variable. As in C, may be applied as a
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
245 prefix (@code{--x}) or postfix (@code{x--}) operator.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
246 @seealso{++}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
247 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
248 .'
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
249 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
250 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
251 @deftypefn {} {} .'
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
252 Matrix transpose operator.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
253
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
254 For complex matrices, computes the transpose, @emph{not} the complex conjugate
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
255 (Hermitian) transpose.
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
256 @seealso{transpose, '}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
257 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
258 .*
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
259 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
260 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
261 @deftypefn {} {} .*
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
262 Element-by-element multiplication operator.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
263 @seealso{times, *}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
264 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
265 .**
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
266 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
267 -*- texinfo -*-
22431
475b4cd1b789 doc: Correct docstring for '.**' operator (bug #48973)
Rik <rik@octave.org>
parents: 22430
diff changeset
268 @deftypefn {} {} .**
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
269 Element-by-element power operator.
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
270
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
271 If several complex results are possible, returns the one with smallest
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
272 non-negative argument (angle). Use @code{realpow}, @code{realsqrt},
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
273 @code{cbrt}, or @code{nthroot} if a real result is preferred.
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
274 @seealso{power, .^, **, ^, realpow, realsqrt, cbrt, nthroot}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
275 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
276 .^
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
277 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
278 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
279 @deftypefn {} {} .^
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
280 Element-by-element power operator.
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
281
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
282 If several complex results are possible, returns the one with smallest
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
283 non-negative argument (angle). Use @code{realpow}, @code{realsqrt},
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
284 @code{cbrt}, or @code{nthroot} if a real result is preferred.
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
285 @seealso{power, .**, ^, **, realpow, realsqrt, cbrt, nthroot}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
286 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
287 ./
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
288 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
289 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
290 @deftypefn {} {} ./
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
291 Element-by-element right division operator.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
292 @seealso{rdivide, /, mrdivide, .\\}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
293 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
294 /
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
295 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
296 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
297 @deftypefn {} {} /
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
298 Right division operator.
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
299 @seealso{mrdivide, ./, rdivide, \\}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
300 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
301 .\
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
302 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
303 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
304 @deftypefn {} {} .\
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
305 Element-by-element left division operator.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
306 @seealso{ldivide, \\, mldivide, ./}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
307 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
308 \
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
309 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
310 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
311 @deftypefn {} {} \
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
312 Left division operator.
24509
d8ed90ecd4fd doc: Add documentation for '\' string continuation marker (bug #52774).
Rik <rik@octave.org>
parents: 24414
diff changeset
313
d8ed90ecd4fd doc: Add documentation for '\' string continuation marker (bug #52774).
Rik <rik@octave.org>
parents: 24414
diff changeset
314 Within double-quoted strings, @samp{\} is the line continuation marker used
d8ed90ecd4fd doc: Add documentation for '\' string continuation marker (bug #52774).
Rik <rik@octave.org>
parents: 24414
diff changeset
315 to join the current line with the following line.
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
316 @seealso{mldivide, .\\, ldivide, /}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
317 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
318 :
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
319 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
320 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
321 @deftypefn {} {} :
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
322 Select all elements in the specified dimension when indexing.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
323
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
324 @example
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
325 x(2, :) # selects 2nd row, all columns
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
326 @end example
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
327 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
328 ;
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
329 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
330 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
331 @deftypefn {} {} ;
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
332 Array row or command separator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
333 @seealso{,}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
334 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
335 <
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
336 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
337 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
338 @deftypefn {} {} <
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
339 'Less than' operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
340 @seealso{lt}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
341 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
342 <=
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
343 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
344 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
345 @deftypefn {} {} <=
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
346 'Less than' or 'equals' operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
347 @seealso{le}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
348 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
349 =
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
350 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
351 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
352 @deftypefn {} {} =
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
353 Assignment operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
354 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
355 ==
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
356 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
357 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
358 @deftypefn {} {} ==
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
359 Equality test operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
360 @seealso{eq}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
361 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
362 >
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
363 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
364 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
365 @deftypefn {} {} >
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
366 'Greater than' operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
367 @seealso{gt}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
368 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
369 >=
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
370 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
371 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
372 @deftypefn {} {} >=
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
373 'Greater than' or 'equals' operator.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
374 @seealso{ge}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
375 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
376 [
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
377 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
378 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
379 @deftypefn {} {} [
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
380 Return list delimiter.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
381 @seealso{]}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
382 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
383 ]
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
384 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
385 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
386 @deftypefn {} {} ]
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
387 Return list delimiter.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
388 @seealso{[}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
389 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
390 |
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
391 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
392 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
393 @deftypefn {} {} |
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
394 Element-by-element logical 'or' operator.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
395 @seealso{or, ||}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
396 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
397 ||
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
398 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
399 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
400 @deftypefn {} {} ||
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
401 Logical 'or' (with short-circuit evaluation) operator.
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
402 @seealso{|}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
403 @end deftypefn
24510
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
404 @
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
405 @c libinterp/parse-tree/oct-parse.yy
24510
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
406 -*- texinfo -*-
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
407 @deftypefn {} {} @@
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
408 Return handle to a function.
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
409
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
410 Example:
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
411
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
412 @example
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
413 @group
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
414 f = @@plus;
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
415 f (2, 2)
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
416 @result{} 4
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
417 @end group
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
418 @end example
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
419
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
420 (Note: @@ also finds use in creating classes. See the manual chapter titled
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
421 Object Oriented Programming for a detailed description.)
24510
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
422 @seealso{function, functions, func2str, str2func}
a2569d574ae5 Add a help entry and documentation for @ character (bug #52771).
Daniel J Sebald <daniel.sebald@ieee.org>
parents: 24509
diff changeset
423 @end deftypefn
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
424 break
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
425 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
426 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
427 @deftypefn {} {} break
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
428 Exit the innermost enclosing do, while, or for loop.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
429 @seealso{do, while, for, parfor, continue}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
430 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
431 case
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
432 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
433 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
434 @deftypefn {} {} case @var{value}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
435 @deftypefnx {} {} case @{@var{value}, @dots{}@}
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
436 A case statement in a switch block.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
437
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
438 Octave cases are exclusive and do not fall-through as do C-language cases. A
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
439 switch statement must have at least one case. See @code{switch} for an
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
440 example.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
441 @seealso{switch}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
442 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
443 catch
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
444 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
445 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
446 @deftypefn {} {} catch
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
447 @deftypefnx {} {} catch @var{value}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
448 Begin the cleanup part of a try-catch block.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
449 @seealso{try}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
450 @end deftypefn
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
451 classdef
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
452 @c libinterp/parse-tree/oct-parse.yy
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
453 -*- texinfo -*-
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
454 @deftypefn {} {} classdef
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
455 Begin a classdef block.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
456 @seealso{properties, methods, events, enumeration}
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
457 @end deftypefn
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
458 continue
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
459 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
460 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
461 @deftypefn {} {} continue
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
462 Jump to the end of the innermost enclosing do, while, or for loop.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
463 @seealso{break, do, while, for, parfor}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
464 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
465 do
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
466 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
467 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
468 @deftypefn {} {} do
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
469 Begin a do-until loop.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
470
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
471 This differs from a while loop in that the body of the loop is executed at
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
472 least once.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
473
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
474 @example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
475 @group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
476 i = 0;
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
477 do
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
478 i++
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
479 until (i == 10)
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
480 @end group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
481 @end example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
482 @seealso{for, until, while}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
483 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
484 else
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
485 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
486 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
487 @deftypefn {} {} else
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
488 Alternate action for an if block.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
489
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
490 See @code{if} for an example.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
491 @seealso{if}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
492 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
493 elseif
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
494 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
495 -*- texinfo -*-
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
496 @deftypefn {} {} elseif (@var{cond})
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
497 Alternate conditional test for an if block.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
498
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
499 The conditional @var{cond} is true if it is not empty and if @emph{all} values
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
500 are nonzero.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
501
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
502 See @code{if} for an example.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
503 @seealso{if}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
504 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
505 end_try_catch
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
506 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
507 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
508 @deftypefn {} {} end_try_catch
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
509 Mark the end of a @code{try-catch} block.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
510 @seealso{try, catch}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
511 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
512 end_unwind_protect
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
513 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
514 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
515 @deftypefn {} {} end_unwind_protect
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
516 Mark the end of an unwind_protect block.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
517 @seealso{unwind_protect}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
518 @end deftypefn
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
519 endclassdef
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
520 @c libinterp/parse-tree/oct-parse.yy
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
521 -*- texinfo -*-
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
522 @deftypefn {} {} endclassdef
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
523 Mark the end of a classdef definition.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
524 @seealso{classdef}
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
525 @end deftypefn
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
526 endenumeration
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
527 @c libinterp/parse-tree/oct-parse.yy
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
528 -*- texinfo -*-
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
529 @deftypefn {} {} endenumeration
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
530 Mark the end of an enumeration block in a classdef definition.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
531 @seealso{enumeration}
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
532 @end deftypefn
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
533 endevents
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
534 @c libinterp/parse-tree/oct-parse.yy
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
535 -*- texinfo -*-
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
536 @deftypefn {} {} endevents
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
537 Mark the end of an events block in a classdef definition.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
538 @seealso{events}
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
539 @end deftypefn
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
540 endfor
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
541 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
542 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
543 @deftypefn {} {} endfor
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
544 Mark the end of a for loop.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
545
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
546 See @code{for} for an example.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
547 @seealso{for}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
548 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
549 endfunction
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
550 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
551 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
552 @deftypefn {} {} endfunction
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
553 Mark the end of a function.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
554 @seealso{function}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
555 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
556 endif
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
557 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
558 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
559 @deftypefn {} {} endif
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
560 Mark the end of an if block.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
561
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
562 See @code{if} for an example.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
563 @seealso{if}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
564 @end deftypefn
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
565 endmethods
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
566 @c libinterp/parse-tree/oct-parse.yy
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
567 -*- texinfo -*-
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
568 @deftypefn {} {} endmethods
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
569 Mark the end of a methods block in a classdef definition.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
570 @seealso{methods}
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
571 @end deftypefn
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
572 endparfor
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
573 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
574 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
575 @deftypefn {} {} endparfor
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
576 Mark the end of a parfor loop.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
577
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
578 See @code{parfor} for an example.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
579 @seealso{parfor}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
580 @end deftypefn
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
581 endproperties
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
582 @c libinterp/parse-tree/oct-parse.yy
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
583 -*- texinfo -*-
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
584 @deftypefn {} {} endproperties
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
585 Mark the end of a properties block in a classdef definition.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
586 @seealso{properties}
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
587 @end deftypefn
28517
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
588 endspmd
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
589 @c libinterp/parse-tree/oct-parse.yy
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
590 -*- texinfo -*-
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
591 @deftypefn {} {} endparfor
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
592 Mark the end of an spmd block. See @code{spmd} for an example.
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
593 @seealso{spmd, parfor}
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
594 @end deftypefn
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
595 endswitch
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
596 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
597 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
598 @deftypefn {} {} endswitch
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
599 Mark the end of a switch block.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
600
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
601 See @code{switch} for an example.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
602 @seealso{switch}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
603 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
604 endwhile
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
605 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
606 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
607 @deftypefn {} {} endwhile
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
608 Mark the end of a while loop.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
609
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
610 See @code{while} for an example.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
611 @seealso{do, while}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
612 @end deftypefn
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
613 enumeration
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
614 @c libinterp/parse-tree/oct-parse.yy
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
615 -*- texinfo -*-
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
616 @deftypefn {} {} enumeration
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
617 Begin an enumeration block in a classdef definition.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
618 @end deftypefn
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
619 events
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
620 @c libinterp/parse-tree/oct-parse.yy
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
621 -*- texinfo -*-
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
622 @deftypefn {} {} events
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
623 Begin an events block in a classdef definition.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
624 @end deftypefn
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
625 for
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
626 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
627 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
628 @deftypefn {} {} for @var{i} = @var{range}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
629 Begin a for loop.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
630
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
631 @example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
632 @group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
633 for i = 1:10
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
634 i
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
635 endfor
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
636 @end group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
637 @end example
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
638 @seealso{parfor, do, while}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
639 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
640 function
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
641 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
642 -*- texinfo -*-
25087
8f1ab6db6709 doc: Improve docstring for function keyword (bug #53146)
Rik <rik@octave.org>
parents: 25054
diff changeset
643 @deftypefn {} {} function @var{outputs} = function_name (@var{input}, @dots{})
8f1ab6db6709 doc: Improve docstring for function keyword (bug #53146)
Rik <rik@octave.org>
parents: 25054
diff changeset
644 @deftypefnx {} {} function {} function_name (@var{input}, @dots{})
8f1ab6db6709 doc: Improve docstring for function keyword (bug #53146)
Rik <rik@octave.org>
parents: 25054
diff changeset
645 @deftypefnx {} {} function @var{outputs} = function_name
8f1ab6db6709 doc: Improve docstring for function keyword (bug #53146)
Rik <rik@octave.org>
parents: 25054
diff changeset
646 Begin a function body with name @code{function_name}, with @var{outputs} as
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
647 results, and with @var{inputs} as parameters.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
648
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
649 The function can later be invoked in Octave using the syntax
25087
8f1ab6db6709 doc: Improve docstring for function keyword (bug #53146)
Rik <rik@octave.org>
parents: 25054
diff changeset
650
8f1ab6db6709 doc: Improve docstring for function keyword (bug #53146)
Rik <rik@octave.org>
parents: 25054
diff changeset
651 @example
8f1ab6db6709 doc: Improve docstring for function keyword (bug #53146)
Rik <rik@octave.org>
parents: 25054
diff changeset
652 [@var{output1}, @var{output2}, @dots{}] = function_name (@var{input1}, @var{input2}, @dots{})
8f1ab6db6709 doc: Improve docstring for function keyword (bug #53146)
Rik <rik@octave.org>
parents: 25054
diff changeset
653 @end example
8f1ab6db6709 doc: Improve docstring for function keyword (bug #53146)
Rik <rik@octave.org>
parents: 25054
diff changeset
654
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
655 @seealso{return}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
656 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
657 global
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
658 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
659 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
660 @deftypefn {} {} global @var{var}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
661 Declare variables to have global scope.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
662
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
663 @example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
664 @group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
665 global @var{x};
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
666 if (isempty (@var{x}))
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
667 x = 1;
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
668 endif
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
669 @end group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
670 @end example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
671 @seealso{persistent}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
672 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
673 if
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
674 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
675 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
676 @deftypefn {} {} if (@var{cond}) @dots{} endif
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
677 @deftypefnx {} {} if (@var{cond}) @dots{} else @dots{} endif
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
678 @deftypefnx {} {} if (@var{cond}) @dots{} elseif (@var{cond}) @dots{} endif
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
679 @deftypefnx {} {} if (@var{cond}) @dots{} elseif (@var{cond}) @dots{} else @dots{} endif
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
680 Begin an if block.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
681
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
682 The conditional @var{cond} is true if it is not empty and if @emph{all} values
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
683 are nonzero.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
684
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
685 @example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
686 @group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
687 x = 1;
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
688 if (x == 1)
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
689 disp ("one");
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
690 elseif (x == 2)
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
691 disp ("two");
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
692 else
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
693 disp ("not one or two");
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
694 endif
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
695 @end group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
696 @end example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
697 @seealso{switch}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
698 @end deftypefn
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
699 @c ## FIXME: Can't have duplicate DOCSTRING entries. The function methods()
25280
1eff55e9debe doc: Stop cruft from being printed after "help if".
Rik <rik@octave.org>
parents: 25087
diff changeset
700 @c ## already has a docstring which overrides this keyword definition.
1eff55e9debe doc: Stop cruft from being printed after "help if".
Rik <rik@octave.org>
parents: 25087
diff changeset
701 @c #methods
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
702 @c #@c libinterp/parse-tree/oct-parse.yy
25280
1eff55e9debe doc: Stop cruft from being printed after "help if".
Rik <rik@octave.org>
parents: 25087
diff changeset
703 @c #-*- texinfo -*-
1eff55e9debe doc: Stop cruft from being printed after "help if".
Rik <rik@octave.org>
parents: 25087
diff changeset
704 @c #@deftypefn {} {} methods
1eff55e9debe doc: Stop cruft from being printed after "help if".
Rik <rik@octave.org>
parents: 25087
diff changeset
705 @c #Begin a methods block in a classdef definition.
1eff55e9debe doc: Stop cruft from being printed after "help if".
Rik <rik@octave.org>
parents: 25087
diff changeset
706 @c #@end deftypefn
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
707 otherwise
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
708 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
709 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
710 @deftypefn {} {} otherwise
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
711 The default statement in a switch block which is executed when no other
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
712 case statements match the input.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
713 @seealso{switch, case}
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
714 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
715 parfor
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
716 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
717 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
718 @deftypefn {} {} parfor @var{i} = @var{range}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
719 @deftypefnx {} {} parfor (@var{i} = @var{range}, @var{maxproc})
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
720 Begin a for loop that may execute in parallel.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
721
26588
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
722 A @code{parfor} loop has the same syntax as a @code{for} loop. If your Octave
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
723 session has a parallel processing pool enabled, the iterations of the
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
724 @code{parfor} loop will be executed in parallel across the pool's workers.
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
725 Otherwise, @code{parfor} will behave exactly as @code{for}.
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
726
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
727 When operating in parallel mode, a @code{parfor} loop's iterations are not
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
728 guaranteed to occur sequentially, and there are additional restrictions about
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
729 the data access operations you can do inside the loop body.
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
730
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
731 @strong{Warning:} parallel processing pools are currently unimplemented in
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
732 Octave; @code{parfor} currently behaves exactly as a normal @code{for} loop.
21708bdc1c07 doc: Clarify that parfor is not implemented.
Andrew Janke <andrew@apjanke.net>
parents: 26515
diff changeset
733
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
734 @example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
735 @group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
736 parfor i = 1:10
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
737 i
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
738 endparfor
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
739 @end group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
740 @end example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
741 @seealso{for, do, while}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
742 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
743 persistent
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
744 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
745 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
746 @deftypefn {} {} persistent @var{var}
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
747 Declare variables as persistent.
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
748
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
749 A variable that has been declared persistent within a function will retain its
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
750 contents in memory between subsequent calls to the same function. The
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
751 difference between persistent variables and global variables is that persistent
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
752 variables are local in scope to a particular function and are not visible
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
753 elsewhere.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
754 @seealso{global}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
755 @end deftypefn
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
756 @c ## FIXME: Can't have duplicate DOCSTRING entries. The function properties()
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
757 @c ## already has a docstring which overrides this keyword definition.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
758 @c ## properties
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
759 @c ## libinterp/parse-tree/oct-parse.yy
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
760 @c ## -*- texinfo -*-
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
761 @c ## @deftypefn {} {} properties
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
762 @c ## Begin a properties block in a classdef definition.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
763 @c ## @end deftypefn
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
764 return
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
765 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
766 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
767 @deftypefn {} {} return
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
768 Return from a function.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
769 @seealso{function}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
770 @end deftypefn
28517
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
771 spmd
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
772 @c libinterp/parse-tree/oct-parse.yy
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
773 -*- texinfo -*-
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
774 @deftypefn {} {} spmd
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
775 @deftypefnx {} {} spmd (@var{n})
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
776 @deftypefnx {} {} spmd (@var{m}, @var{n})
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
777 Begin a block of statements which may execute in parallel across multiple
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
778 workers.
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
779
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
780 If Octave has a parallel processing pool enabled, the block of code will be
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
781 executed in parallel across all of the pool's workers. Otherwise, @code{spmd}
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
782 has no effect and the statements are processed as normal code by the main
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
783 Octave interpreter.
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
784
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
785 If called with one additional argument @var{n} then use exactly @var{n} workers
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
786 from the pool. If called with two arguments @var{m}, @var{n} then use a
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
787 minimum of @var{m} workers and a maximum of @var{n} workers from the parallel
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
788 pool.
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
789
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
790 @strong{Warning:} parallel processing pools are currently unimplemented in
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
791 Octave; @code{spmd} currently does nothing, but is included to avoid breaking
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
792 existing @sc{matlab} code.
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
793
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
794 @seealso{parfor}
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
795 @end deftypefn
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
796 switch
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
797 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
798 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
799 @deftypefn {} {} switch @var{statement}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
800 Begin a switch block.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
801
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
802 @example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
803 @group
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
804 yesno = "yes";
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
805
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
806 switch (yesno)
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
807 case @{"Yes" "yes" "YES" "y" "Y"@}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
808 value = 1;
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
809 case @{"No" "no" "NO" "n" "N"@}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
810 value = 0;
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
811 otherwise
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
812 error ("invalid value");
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
813 endswitch
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
814 @end group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
815 @end example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
816 @seealso{if, case, otherwise}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
817 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
818 try
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
819 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
820 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
821 @deftypefn {} {} try
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
822 Begin a try-catch block.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
823
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
824 If an error occurs within a try block, then the catch code will be run and
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
825 execution will proceed after the catch block (though it is often recommended to
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
826 use the @code{lasterr} function to re-throw the error after cleanup is
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
827 completed).
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
828 @seealso{catch, unwind_protect}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
829 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
830 until
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
831 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
832 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
833 @deftypefn {} {} until (@var{cond})
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
834 End a do-until loop.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
835
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
836 The conditional @var{cond} is true if it is not empty and if @emph{all} values
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
837 are nonzero.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
838
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
839 See @code{do} for an example.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
840 @seealso{do}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
841 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
842 unwind_protect
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
843 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
844 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
845 @deftypefn {} {} unwind_protect
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
846 Begin an unwind_protect block.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
847
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
848 If an error occurs within the first part of an unwind_protect block the
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
849 commands within the unwind_protect_cleanup block are executed before the error
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
850 is thrown. If an error is not thrown, then the unwind_protect_cleanup block is
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
851 still executed. In other words, the unwind_protect_cleanup code is guaranteed
24691
b658e0fa0cb3 maint: Remove trailing whitespace from files.
Rik <rik@octave.org>
parents: 24534
diff changeset
852 to execute regardless of success or failure in the unwind_protect block.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
853 @seealso{unwind_protect_cleanup, try}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
854 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
855 unwind_protect_cleanup
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
856 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
857 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
858 @deftypefn {} {} unwind_protect_cleanup
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
859 Begin the cleanup section of an unwind_protect block.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
860 @seealso{unwind_protect}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
861 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
862 varargin
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
863 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
864 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
865 @deftypefn {} {} varargin
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
866 Pass an arbitrary number of arguments into a function.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
867 @seealso{varargout, nargin, isargout, nargout, nthargout}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
868 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
869 varargout
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
870 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
871 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
872 @deftypefn {} {} varargout
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
873 Pass an arbitrary number of arguments out of a function.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
874 @seealso{varargin, nargin, isargout, nargout, nthargout}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
875 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
876 while
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
877 @c libinterp/parse-tree/oct-parse.yy
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
878 -*- texinfo -*-
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
879 @deftypefn {} {} while (@var{cond})
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
880 Begin a while loop.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
881
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
882 The conditional @var{cond} is true if it is not empty and if @emph{all} values
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
883 are nonzero.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
884
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
885 @example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
886 @group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
887 i = 0;
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
888 while (i < 10)
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
889 i++
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
890 endwhile
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
891 @end group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
892 @end example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
893 @seealso{do, endwhile, for, until}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
894 @end deftypefn