annotate libinterp/op-kw-docs @ 31191:bb9d776eafac stable

Fix wrong color in PDF printout of some latex strings (bug #62884) * octave-svgconvert (draw): For "rect" elements only set brush color if necessary and eventually restore to previous color.
author Pantxo Diribarne <pantxo.diribarne@gmail.com>
date Sun, 14 Aug 2022 18:24:07 +0200
parents bca7aebe3e2d
children 597f3ee61a48
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 ##
30564
796f54d4ddbf update Octave Project Developers copyright for the new year
John W. Eaton <jwe@octave.org>
parents: 29513
diff changeset
3 ## Copyright (C) 1993-2022 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
30686
bca7aebe3e2d doc: Clarify documentation for "return" keyword (bug #61918).
Rik <rik@octave.org>
parents: 30564
diff changeset
768 Return execution control immediately from a function or script to the calling
bca7aebe3e2d doc: Clarify documentation for "return" keyword (bug #61918).
Rik <rik@octave.org>
parents: 30564
diff changeset
769 code.
bca7aebe3e2d doc: Clarify documentation for "return" keyword (bug #61918).
Rik <rik@octave.org>
parents: 30564
diff changeset
770
bca7aebe3e2d doc: Clarify documentation for "return" keyword (bug #61918).
Rik <rik@octave.org>
parents: 30564
diff changeset
771 @code{return} is used to stop executing code and exit an m-file immediately
bca7aebe3e2d doc: Clarify documentation for "return" keyword (bug #61918).
Rik <rik@octave.org>
parents: 30564
diff changeset
772 rather than continuing until the end of the function or script is reached.
bca7aebe3e2d doc: Clarify documentation for "return" keyword (bug #61918).
Rik <rik@octave.org>
parents: 30564
diff changeset
773
bca7aebe3e2d doc: Clarify documentation for "return" keyword (bug #61918).
Rik <rik@octave.org>
parents: 30564
diff changeset
774 If the function or script was invoked directly, rather than from calling code
bca7aebe3e2d doc: Clarify documentation for "return" keyword (bug #61918).
Rik <rik@octave.org>
parents: 30564
diff changeset
775 in an m-file, then Octave returns to the command line.
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
776 @seealso{function}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
777 @end deftypefn
28517
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
778 spmd
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
779 @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
780 -*- texinfo -*-
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
781 @deftypefn {} {} spmd
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
782 @deftypefnx {} {} spmd (@var{n})
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
783 @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
784 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
785 workers.
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
786
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
787 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
788 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
789 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
790 Octave interpreter.
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
791
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
792 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
793 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
794 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
795 pool.
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
796
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
797 @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
798 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
799 existing @sc{matlab} code.
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
800
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
801 @seealso{parfor}
6e8a9845d118 Add 'spmd' as interpreter keyword for Matlab compatibility (bug #58676).
Rik <rik@octave.org>
parents: 27923
diff changeset
802 @end deftypefn
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
803 switch
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
804 @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
805 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
806 @deftypefn {} {} switch @var{statement}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
807 Begin a switch block.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
808
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
809 @example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
810 @group
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
811 yesno = "yes";
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
812
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
813 switch (yesno)
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
814 case @{"Yes" "yes" "YES" "y" "Y"@}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
815 value = 1;
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
816 case @{"No" "no" "NO" "n" "N"@}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
817 value = 0;
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
818 otherwise
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
819 error ("invalid value");
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
820 endswitch
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
821 @end group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
822 @end example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
823 @seealso{if, case, otherwise}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
824 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
825 try
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
826 @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
827 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
828 @deftypefn {} {} try
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
829 Begin a try-catch block.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
830
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
831 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
832 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
833 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
834 completed).
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
835 @seealso{catch, unwind_protect}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
836 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
837 until
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
838 @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
839 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
840 @deftypefn {} {} until (@var{cond})
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
841 End a do-until loop.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
842
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
843 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
844 are nonzero.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
845
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
846 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
847 @seealso{do}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
848 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
849 unwind_protect
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
850 @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
851 -*- texinfo -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
852 @deftypefn {} {} unwind_protect
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
853 Begin an unwind_protect block.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
854
24413
50bb53905f03 doc: Update documentation for keywords to include classdef statements (Bug #52591).
Rik <rik@octave.org>
parents: 23219
diff changeset
855 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
856 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
857 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
858 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
859 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
860 @seealso{unwind_protect_cleanup, try}
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 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
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 {} {} unwind_protect_cleanup
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
866 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
867 @seealso{unwind_protect}
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 varargin
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 {} {} varargin
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 into a function.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
874 @seealso{varargout, 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 varargout
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 -*-
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
879 @deftypefn {} {} varargout
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
880 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
881 @seealso{varargin, nargin, isargout, nargout, nthargout}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
882 @end deftypefn
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
883 while
25637
e1c3d1c6e896 don't substitute api.prefix style in bison input files
John W. Eaton <jwe@octave.org>
parents: 25280
diff changeset
884 @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
885 -*- texinfo -*-
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
886 @deftypefn {} {} while (@var{cond})
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
887 Begin a while loop.
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
888
29512
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
889 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
890 are nonzero.
4f555ba551e5 doc: Update keyword docstrings (bug #60275).
Rik <rik@octave.org>
parents: 29358
diff changeset
891
22156
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
892 @example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
893 @group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
894 i = 0;
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
895 while (i < 10)
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
896 i++
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
897 endwhile
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
898 @end group
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
899 @end example
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
900 @seealso{do, endwhile, for, until}
187b6727c75e build doc-cache without running Octave (bug #48508)
John W. Eaton <jwe@octave.org>
parents:
diff changeset
901 @end deftypefn