home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / octa21eb.zip / octave / doc / octave.i13 < prev    next >
Encoding:
GNU Info File  |  1999-05-13  |  47.0 KB  |  862 lines

  1. This is Info file octave, produced by Makeinfo-1.64 from the input file
  2. octave.tex.
  3.  
  4. START-INFO-DIR-ENTRY
  5. * Octave: (octave).    Interactive language for numerical computations.
  6. END-INFO-DIR-ENTRY
  7.  
  8.    Copyright (C) 1996, 1997 John W. Eaton.
  9.  
  10.    Permission is granted to make and distribute verbatim copies of this
  11. manual provided the copyright notice and this permission notice are
  12. preserved on all copies.
  13.  
  14.    Permission is granted to copy and distribute modified versions of
  15. this manual under the conditions for verbatim copying, provided that
  16. the entire resulting derived work is distributed under the terms of a
  17. permission notice identical to this one.
  18.  
  19.    Permission is granted to copy and distribute translations of this
  20. manual into another language, under the above conditions for modified
  21. versions.
  22.  
  23. 
  24. File: octave,  Node: Copying,  Next: Concept Index,  Prev: Grammar,  Up: Top
  25.  
  26. GNU GENERAL PUBLIC LICENSE
  27. **************************
  28.  
  29.                          Version 2, June 1991
  30.  
  31.      Copyright (C) 1989, 1991 Free Software Foundation, Inc.
  32.      59 Temple Place - Suite 330, Boston, MA  02111-1307, USA
  33.      
  34.      Everyone is permitted to copy and distribute verbatim copies
  35.      of this license document, but changing it is not allowed.
  36.  
  37. Preamble
  38. ========
  39.  
  40.    The licenses for most software are designed to take away your
  41. freedom to share and change it.  By contrast, the GNU General Public
  42. License is intended to guarantee your freedom to share and change free
  43. software--to make sure the software is free for all its users.  This
  44. General Public License applies to most of the Free Software
  45. Foundation's software and to any other program whose authors commit to
  46. using it.  (Some other Free Software Foundation software is covered by
  47. the GNU Library General Public License instead.)  You can apply it to
  48. your programs, too.
  49.  
  50.    When we speak of free software, we are referring to freedom, not
  51. price.  Our General Public Licenses are designed to make sure that you
  52. have the freedom to distribute copies of free software (and charge for
  53. this service if you wish), that you receive source code or can get it
  54. if you want it, that you can change the software or use pieces of it in
  55. new free programs; and that you know you can do these things.
  56.  
  57.    To protect your rights, we need to make restrictions that forbid
  58. anyone to deny you these rights or to ask you to surrender the rights.
  59. These restrictions translate to certain responsibilities for you if you
  60. distribute copies of the software, or if you modify it.
  61.  
  62.    For example, if you distribute copies of such a program, whether
  63. gratis or for a fee, you must give the recipients all the rights that
  64. you have.  You must make sure that they, too, receive or can get the
  65. source code.  And you must show them these terms so they know their
  66. rights.
  67.  
  68.    We protect your rights with two steps: (1) copyright the software,
  69. and (2) offer you this license which gives you legal permission to copy,
  70. distribute and/or modify the software.
  71.  
  72.    Also, for each author's protection and ours, we want to make certain
  73. that everyone understands that there is no warranty for this free
  74. software.  If the software is modified by someone else and passed on, we
  75. want its recipients to know that what they have is not the original, so
  76. that any problems introduced by others will not reflect on the original
  77. authors' reputations.
  78.  
  79.    Finally, any free program is threatened constantly by software
  80. patents.  We wish to avoid the danger that redistributors of a free
  81. program will individually obtain patent licenses, in effect making the
  82. program proprietary.  To prevent this, we have made it clear that any
  83. patent must be licensed for everyone's free use or not licensed at all.
  84.  
  85.    The precise terms and conditions for copying, distribution and
  86. modification follow.
  87.  
  88.     TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  89.  
  90.   0. This License applies to any program or other work which contains a
  91.      notice placed by the copyright holder saying it may be distributed
  92.      under the terms of this General Public License.  The "Program",
  93.      below, refers to any such program or work, and a "work based on
  94.      the Program" means either the Program or any derivative work under
  95.      copyright law: that is to say, a work containing the Program or a
  96.      portion of it, either verbatim or with modifications and/or
  97.      translated into another language.  (Hereinafter, translation is
  98.      included without limitation in the term "modification".)  Each
  99.      licensee is addressed as "you".
  100.  
  101.      Activities other than copying, distribution and modification are
  102.      not covered by this License; they are outside its scope.  The act
  103.      of running the Program is not restricted, and the output from the
  104.      Program is covered only if its contents constitute a work based on
  105.      the Program (independent of having been made by running the
  106.      Program).  Whether that is true depends on what the Program does.
  107.  
  108.   1. You may copy and distribute verbatim copies of the Program's
  109.      source code as you receive it, in any medium, provided that you
  110.      conspicuously and appropriately publish on each copy an appropriate
  111.      copyright notice and disclaimer of warranty; keep intact all the
  112.      notices that refer to this License and to the absence of any
  113.      warranty; and give any other recipients of the Program a copy of
  114.      this License along with the Program.
  115.  
  116.      You may charge a fee for the physical act of transferring a copy,
  117.      and you may at your option offer warranty protection in exchange
  118.      for a fee.
  119.  
  120.   2. You may modify your copy or copies of the Program or any portion
  121.      of it, thus forming a work based on the Program, and copy and
  122.      distribute such modifications or work under the terms of Section 1
  123.      above, provided that you also meet all of these conditions:
  124.  
  125.        a. You must cause the modified files to carry prominent notices
  126.           stating that you changed the files and the date of any change.
  127.  
  128.        b. You must cause any work that you distribute or publish, that
  129.           in whole or in part contains or is derived from the Program
  130.           or any part thereof, to be licensed as a whole at no charge
  131.           to all third parties under the terms of this License.
  132.  
  133.        c. If the modified program normally reads commands interactively
  134.           when run, you must cause it, when started running for such
  135.           interactive use in the most ordinary way, to print or display
  136.           an announcement including an appropriate copyright notice and
  137.           a notice that there is no warranty (or else, saying that you
  138.           provide a warranty) and that users may redistribute the
  139.           program under these conditions, and telling the user how to
  140.           view a copy of this License.  (Exception: if the Program
  141.           itself is interactive but does not normally print such an
  142.           announcement, your work based on the Program is not required
  143.           to print an announcement.)
  144.  
  145.      These requirements apply to the modified work as a whole.  If
  146.      identifiable sections of that work are not derived from the
  147.      Program, and can be reasonably considered independent and separate
  148.      works in themselves, then this License, and its terms, do not
  149.      apply to those sections when you distribute them as separate
  150.      works.  But when you distribute the same sections as part of a
  151.      whole which is a work based on the Program, the distribution of
  152.      the whole must be on the terms of this License, whose permissions
  153.      for other licensees extend to the entire whole, and thus to each
  154.      and every part regardless of who wrote it.
  155.  
  156.      Thus, it is not the intent of this section to claim rights or
  157.      contest your rights to work written entirely by you; rather, the
  158.      intent is to exercise the right to control the distribution of
  159.      derivative or collective works based on the Program.
  160.  
  161.      In addition, mere aggregation of another work not based on the
  162.      Program with the Program (or with a work based on the Program) on
  163.      a volume of a storage or distribution medium does not bring the
  164.      other work under the scope of this License.
  165.  
  166.   3. You may copy and distribute the Program (or a work based on it,
  167.      under Section 2) in object code or executable form under the terms
  168.      of Sections 1 and 2 above provided that you also do one of the
  169.      following:
  170.  
  171.        a. Accompany it with the complete corresponding machine-readable
  172.           source code, which must be distributed under the terms of
  173.           Sections 1 and 2 above on a medium customarily used for
  174.           software interchange; or,
  175.  
  176.        b. Accompany it with a written offer, valid for at least three
  177.           years, to give any third party, for a charge no more than your
  178.           cost of physically performing source distribution, a complete
  179.           machine-readable copy of the corresponding source code, to be
  180.           distributed under the terms of Sections 1 and 2 above on a
  181.           medium customarily used for software interchange; or,
  182.  
  183.        c. Accompany it with the information you received as to the offer
  184.           to distribute corresponding source code.  (This alternative is
  185.           allowed only for noncommercial distribution and only if you
  186.           received the program in object code or executable form with
  187.           such an offer, in accord with Subsection b above.)
  188.  
  189.      The source code for a work means the preferred form of the work for
  190.      making modifications to it.  For an executable work, complete
  191.      source code means all the source code for all modules it contains,
  192.      plus any associated interface definition files, plus the scripts
  193.      used to control compilation and installation of the executable.
  194.      However, as a special exception, the source code distributed need
  195.      not include anything that is normally distributed (in either
  196.      source or binary form) with the major components (compiler,
  197.      kernel, and so on) of the operating system on which the executable
  198.      runs, unless that component itself accompanies the executable.
  199.  
  200.      If distribution of executable or object code is made by offering
  201.      access to copy from a designated place, then offering equivalent
  202.      access to copy the source code from the same place counts as
  203.      distribution of the source code, even though third parties are not
  204.      compelled to copy the source along with the object code.
  205.  
  206.   4. You may not copy, modify, sublicense, or distribute the Program
  207.      except as expressly provided under this License.  Any attempt
  208.      otherwise to copy, modify, sublicense or distribute the Program is
  209.      void, and will automatically terminate your rights under this
  210.      License.  However, parties who have received copies, or rights,
  211.      from you under this License will not have their licenses
  212.      terminated so long as such parties remain in full compliance.
  213.  
  214.   5. You are not required to accept this License, since you have not
  215.      signed it.  However, nothing else grants you permission to modify
  216.      or distribute the Program or its derivative works.  These actions
  217.      are prohibited by law if you do not accept this License.
  218.      Therefore, by modifying or distributing the Program (or any work
  219.      based on the Program), you indicate your acceptance of this
  220.      License to do so, and all its terms and conditions for copying,
  221.      distributing or modifying the Program or works based on it.
  222.  
  223.   6. Each time you redistribute the Program (or any work based on the
  224.      Program), the recipient automatically receives a license from the
  225.      original licensor to copy, distribute or modify the Program
  226.      subject to these terms and conditions.  You may not impose any
  227.      further restrictions on the recipients' exercise of the rights
  228.      granted herein.  You are not responsible for enforcing compliance
  229.      by third parties to this License.
  230.  
  231.   7. If, as a consequence of a court judgment or allegation of patent
  232.      infringement or for any other reason (not limited to patent
  233.      issues), conditions are imposed on you (whether by court order,
  234.      agreement or otherwise) that contradict the conditions of this
  235.      License, they do not excuse you from the conditions of this
  236.      License.  If you cannot distribute so as to satisfy simultaneously
  237.      your obligations under this License and any other pertinent
  238.      obligations, then as a consequence you may not distribute the
  239.      Program at all.  For example, if a patent license would not permit
  240.      royalty-free redistribution of the Program by all those who
  241.      receive copies directly or indirectly through you, then the only
  242.      way you could satisfy both it and this License would be to refrain
  243.      entirely from distribution of the Program.
  244.  
  245.      If any portion of this section is held invalid or unenforceable
  246.      under any particular circumstance, the balance of the section is
  247.      intended to apply and the section as a whole is intended to apply
  248.      in other circumstances.
  249.  
  250.      It is not the purpose of this section to induce you to infringe any
  251.      patents or other property right claims or to contest validity of
  252.      any such claims; this section has the sole purpose of protecting
  253.      the integrity of the free software distribution system, which is
  254.      implemented by public license practices.  Many people have made
  255.      generous contributions to the wide range of software distributed
  256.      through that system in reliance on consistent application of that
  257.      system; it is up to the author/donor to decide if he or she is
  258.      willing to distribute software through any other system and a
  259.      licensee cannot impose that choice.
  260.  
  261.      This section is intended to make thoroughly clear what is believed
  262.      to be a consequence of the rest of this License.
  263.  
  264.   8. If the distribution and/or use of the Program is restricted in
  265.      certain countries either by patents or by copyrighted interfaces,
  266.      the original copyright holder who places the Program under this
  267.      License may add an explicit geographical distribution limitation
  268.      excluding those countries, so that distribution is permitted only
  269.      in or among countries not thus excluded.  In such case, this
  270.      License incorporates the limitation as if written in the body of
  271.      this License.
  272.  
  273.   9. The Free Software Foundation may publish revised and/or new
  274.      versions of the General Public License from time to time.  Such
  275.      new versions will be similar in spirit to the present version, but
  276.      may differ in detail to address new problems or concerns.
  277.  
  278.      Each version is given a distinguishing version number.  If the
  279.      Program specifies a version number of this License which applies
  280.      to it and "any later version", you have the option of following
  281.      the terms and conditions either of that version or of any later
  282.      version published by the Free Software Foundation.  If the Program
  283.      does not specify a version number of this License, you may choose
  284.      any version ever published by the Free Software Foundation.
  285.  
  286.  10. If you wish to incorporate parts of the Program into other free
  287.      programs whose distribution conditions are different, write to the
  288.      author to ask for permission.  For software which is copyrighted
  289.      by the Free Software Foundation, write to the Free Software
  290.      Foundation; we sometimes make exceptions for this.  Our decision
  291.      will be guided by the two goals of preserving the free status of
  292.      all derivatives of our free software and of promoting the sharing
  293.      and reuse of software generally.
  294.  
  295.                                 NO WARRANTY
  296.  
  297.  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO
  298.      WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  299.      LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  300.      HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
  301.      WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT
  302.      NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
  303.      FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS TO THE
  304.      QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  305.      PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  306.      SERVICING, REPAIR OR CORRECTION.
  307.  
  308.  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  309.      WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
  310.      MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE
  311.      LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
  312.      INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
  313.      INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
  314.      DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU
  315.      OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
  316.      OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
  317.      ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  318.  
  319.                       END OF TERMS AND CONDITIONS
  320.  
  321. Appendix: How to Apply These Terms to Your New Programs
  322. =======================================================
  323.  
  324.    If you develop a new program, and you want it to be of the greatest
  325. possible use to the public, the best way to achieve this is to make it
  326. free software which everyone can redistribute and change under these
  327. terms.
  328.  
  329.    To do so, attach the following notices to the program.  It is safest
  330. to attach them to the start of each source file to most effectively
  331. convey the exclusion of warranty; and each file should have at least
  332. the "copyright" line and a pointer to where the full notice is found.
  333.  
  334.      ONE LINE TO GIVE THE PROGRAM'S NAME AND A BRIEF IDEA OF WHAT IT DOES.
  335.      Copyright (C) 19YY  NAME OF AUTHOR
  336.      
  337.      This program is free software; you can redistribute it and/or modify
  338.      it under the terms of the GNU General Public License as published by
  339.      the Free Software Foundation; either version 2 of the License, or
  340.      (at your option) any later version.
  341.      
  342.      This program is distributed in the hope that it will be useful,
  343.      but WITHOUT ANY WARRANTY; without even the implied warranty of
  344.      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  345.      GNU General Public License for more details.
  346.      
  347.      You should have received a copy of the GNU General Public License
  348.      along with this program; if not, write to the Free Software
  349.      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
  350.      02111-1307, USA.
  351.  
  352.    Also add information on how to contact you by electronic and paper
  353. mail.
  354.  
  355.    If the program is interactive, make it output a short notice like
  356. this when it starts in an interactive mode:
  357.  
  358.      Gnomovision version 69, Copyright (C) 19YY NAME OF AUTHOR
  359.      Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
  360.      type `show w'.  This is free software, and you are welcome
  361.      to redistribute it under certain conditions; type `show c'
  362.      for details.
  363.  
  364.    The hypothetical commands `show w' and `show c' should show the
  365. appropriate parts of the General Public License.  Of course, the
  366. commands you use may be called something other than `show w' and `show
  367. c'; they could even be mouse-clicks or menu items--whatever suits your
  368. program.
  369.  
  370.    You should also get your employer (if you work as a programmer) or
  371. your school, if any, to sign a "copyright disclaimer" for the program,
  372. if necessary.  Here is a sample; alter the names:
  373.  
  374.      Yoyodyne, Inc., hereby disclaims all copyright interest in the program
  375.      `Gnomovision' (which makes passes at compilers) written by James Hacker.
  376.      
  377.      SIGNATURE OF TY COON, 1 April 1989
  378.      Ty Coon, President of Vice
  379.  
  380.    This General Public License does not permit incorporating your
  381. program into proprietary programs.  If your program is a subroutine
  382. library, you may consider it more useful to permit linking proprietary
  383. applications with the library.  If this is what you want to do, use the
  384. GNU Library General Public License instead of this License.
  385.  
  386. 
  387. File: octave,  Node: Concept Index,  Next: Variable Index,  Prev: Copying,  Up: Top
  388.  
  389. Concept Index
  390. *************
  391.  
  392. * Menu:
  393.  
  394. * -braindead:                           Command Line Options.
  395. * -debug:                               Command Line Options.
  396. * -echo-commands:                       Command Line Options.
  397. * -exec-path PATH:                      Command Line Options.
  398. * -help:                                Command Line Options.
  399. * -info-file FILENAME:                  Command Line Options.
  400. * -info-program PROGRAM:                Command Line Options.
  401. * -interactive:                         Command Line Options.
  402. * -no-init-file:                        Command Line Options.
  403. * -no-line-editing:                     Command Line Options.
  404. * -no-site-file:                        Command Line Options.
  405. * -norc:                                Command Line Options.
  406. * -path PATH:                           Command Line Options.
  407. * -quiet:                               Command Line Options.
  408. * -silent:                              Command Line Options.
  409. * -traditional:                         Command Line Options.
  410. * -verbose:                             Command Line Options.
  411. * -version:                             Command Line Options.
  412. * -?:                                   Command Line Options.
  413. * -d:                                   Command Line Options.
  414. * -f:                                   Command Line Options.
  415. * -h:                                   Command Line Options.
  416. * -i:                                   Command Line Options.
  417. * -p PATH:                              Command Line Options.
  418. * -q:                                   Command Line Options.
  419. * -V:                                   Command Line Options.
  420. * -x:                                   Command Line Options.
  421. * ... <1>:                              Variable-length Return Lists.
  422. * ...:                                  Variable-length Argument Lists.
  423. * ... continuation marker:              The try Statement.
  424. * .octaverc:                            Startup Files.
  425. * break statement:                      The break Statement.
  426. * case statement:                       The switch Statement.
  427. * catch:                                The try Statement.
  428. * continue statement:                   The continue Statement.
  429. * elseif statement:                     The if Statement.
  430. * else statement:                       The if Statement.
  431. * endfor statement:                     The for Statement.
  432. * endfunction statement:                Defining Functions.
  433. * endif statement:                      The if Statement.
  434. * endswitch statement:                  The switch Statement.
  435. * endwhile statement:                   The while Statement.
  436. * end_try_catch:                        The try Statement.
  437. * end_unwind_protect:                   The unwind_protect Statement.
  438. * end statement:                        Statements.
  439. * for statement:                        The for Statement.
  440. * function statement:                   Defining Functions.
  441. * global statement:                     Global Variables.
  442. * if statement:                         The if Statement.
  443. * otags:                                Using Octave Mode.
  444. * otherwise statement:                  The switch Statement.
  445. * switch statement:                     The switch Statement.
  446. * try statement:                        The try Statement.
  447. * unwind_protect_cleanup:               The unwind_protect Statement.
  448. * unwind_protect statement:             The unwind_protect Statement.
  449. * while statement:                      The while Statement.
  450. * \ continuation marker:                The try Statement.
  451. * ~/.octaverc:                          Startup Files.
  452. * #!:                                   Executable Octave Programs.
  453. * #:                                    Comments.
  454. * %:                                    Comments.
  455. * acknowledgements:                     Acknowledgements.
  456. * addition:                             Arithmetic Ops.
  457. * and operator:                         Boolean Expressions.
  458. * answers, incorrect <1>:               Bug Criteria.
  459. * answers, incorrect:                   Bug Reporting.
  460. * any key:                              Fonts.
  461. * arguments in function call:           Calling Functions.
  462. * arithmetic operators:                 Arithmetic Ops.
  463. * assignment expressions:               Assignment Ops.
  464. * assignment operators:                 Assignment Ops.
  465. * body of a loop:                       The while Statement.
  466. * boolean expressions:                  Boolean Expressions.
  467. * boolean operators:                    Boolean Expressions.
  468. * bug criteria:                         Bug Criteria.
  469. * bug report mailing lists:             Bug Lists.
  470. * bugs:                                 Reporting Bugs.
  471. * bugs, investigating:                  Bug Reporting.
  472. * bugs, known:                          Trouble.
  473. * bugs, reporting <1>:                  Bug Reporting.
  474. * bugs, reporting:                      Bug Lists.
  475. * built-in data types:                  Built-in Data Types.
  476. * built-in function:                    A Sample Function Description.
  477. * character strings <1>:                String Objects.
  478. * character strings:                    Strings.
  479. * Cholesky factorization:               Matrix Factorizations.
  480. * clearing the screen:                  Cursor Motion.
  481. * coding standards:                     Tips.
  482. * command and ouput logs:               Diary and Echo Commands.
  483. * command completion:                   Commands For Completion.
  484. * command descriptions:                 A Sample Command Description.
  485. * command echoing:                      Diary and Echo Commands.
  486. * command history:                      Commands For History.
  487. * command options:                      Command Line Options.
  488. * command-line editing:                 Command Line Editing.
  489. * comments:                             Comments.
  490. * comparison expressions:               Comparison Ops.
  491. * complex-conjugate transpose:          Arithmetic Ops.
  492. * continuation lines:                   The try Statement.
  493. * contributing to Octave:               How You Can Contribute to Octave.
  494. * contributors:                         Preface.
  495. * conversion specifications (printf):   Formatted Output.
  496. * conversion specifications (scanf):    Formatted Input.
  497. * copyright:                            Keywords.
  498. * core dump:                            Bug Criteria.
  499. * customizing the prompt:               Customizing the Prompt.
  500. * DAE:                                  Differential Equations.
  501. * data structures <1>:                  Data Structure Objects.
  502. * data structures:                      Data Structures.
  503. * data types:                           Data Types.
  504. * data types, built-in:                 Built-in Data Types.
  505. * data types, user-defined:             User-defined Data Types.
  506. * decrement operator:                   Assignment Ops.
  507. * defining functions:                   Functions and Scripts.
  508. * description format:                   Format of Descriptions.
  509. * diary of commands and output:         Diary and Echo Commands.
  510. * Differential Equations:               Differential Equations.
  511. * diffs, submitting:                    Sending Patches.
  512. * distribution of Octave:               Distribution.
  513. * division:                             Arithmetic Ops.
  514. * documentation notation:               Evaluation Notation.
  515. * documenting Octave programs:          Comments.
  516. * dynamic linking:                      Dynamically Linked Functions.
  517. * echoing executing commands:           Diary and Echo Commands.
  518. * editing the command line:             Command Line Editing.
  519. * element-by-element evaluation:        Element-by-element Boolean Operators.
  520. * Emacs TAGS files:                     Using Octave Mode.
  521. * equality operator:                    Comparison Ops.
  522. * equality, tests for:                  Comparison Ops.
  523. * equations, nonlinear:                 Nonlinear Equations.
  524. * erroneous messages:                   Bug Criteria.
  525. * erroneous results <1>:                Bug Criteria.
  526. * erroneous results:                    Bug Reporting.
  527. * error message notation:               Error Messages.
  528. * error messages:                       Errors.
  529. * error messages, incorrect:            Bug Criteria.
  530. * escape sequence notation:             Strings.
  531. * evaluation notation:                  Evaluation Notation.
  532. * executable scripts:                   Executable Octave Programs.
  533. * execution speed:                      Coding Tips.
  534. * exiting octave <1>:                   Quitting Octave.
  535. * exiting octave:                       Running Octave.
  536. * exponentiation:                       Arithmetic Ops.
  537. * expression, range:                    Ranges.
  538. * expressions:                          Expressions.
  539. * expressions, assignment:              Assignment Ops.
  540. * expressions, boolean:                 Boolean Expressions.
  541. * expressions, comparison:              Comparison Ops.
  542. * expressions, logical:                 Boolean Expressions.
  543. * factorial function:                   Recursion.
  544. * fatal signal:                         Bug Criteria.
  545. * flag character (printf):              Output Conversion Syntax.
  546. * flag character (scanf):               Input Conversion Syntax.
  547. * flying high and fast:                 Variables.
  548. * fonts:                                Fonts.
  549. * Fordyce, A. P.:                       Evaluation.
  550. * Frobenius norm:                       Basic Matrix Functions.
  551. * function descriptions:                A Sample Function Description.
  552. * function file <1>:                    A Sample Function Description.
  553. * function file:                        Function Files.
  554. * functions, user-defined:              Functions and Scripts.
  555. * funding Octave development:           How You Can Contribute to Octave.
  556. * getting a good job:                   Variables.
  557. * global variables:                     Global Variables.
  558. * grammar rules:                        Grammar.
  559. * graphics:                             Two-Dimensional Plotting.
  560. * greater than operator:                Comparison Ops.
  561. * header comments:                      Function Headers.
  562. * help, on-line:                        Getting Help.
  563. * help, where to find:                  Service.
  564. * Hermitian operator:                   Arithmetic Ops.
  565. * Hessenberg decomposition:             Matrix Factorizations.
  566. * history:                              Preface.
  567. * history of commands:                  Commands For History.
  568. * improving Octave <1>:                 Bug Criteria.
  569. * improving Octave:                     Sending Patches.
  570. * incorrect error messages:             Bug Criteria.
  571. * incorrect output <1>:                 Bug Reporting.
  572. * incorrect output:                     Bug Criteria.
  573. * incorrect results <1>:                Bug Reporting.
  574. * incorrect results:                    Bug Criteria.
  575. * increment operator:                   Assignment Ops.
  576. * infinity norm:                        Basic Matrix Functions.
  577. * initialization:                       Startup Files.
  578. * input conversions, for scanf:         Table of Input Conversions.
  579. * input history:                        Commands For History.
  580. * installation trouble:                 Trouble.
  581. * installing Octave:                    Installation.
  582. * introduction:                         Introduction.
  583. * invalid input:                        Bug Criteria.
  584. * job hunting:                          Variables.
  585. * keywords:                             Keywords.
  586. * known causes of trouble:              Trouble.
  587. * language definition:                  Grammar.
  588. * less than operator:                   Comparison Ops.
  589. * loadable function:                    A Sample Function Description.
  590. * logging commands and output:          Diary and Echo Commands.
  591. * logical expressions:                  Boolean Expressions.
  592. * logical operators:                    Boolean Expressions.
  593. * loop:                                 The while Statement.
  594. * looping over structure elements:      Looping Over Structure Elements.
  595. * LP:                                   Optimization.
  596. * LU decomposition:                     Matrix Factorizations.
  597. * lvalue:                               Assignment Ops.
  598. * mapping function:                     A Sample Function Description.
  599. * matching failure, in scanf:           Formatted Input.
  600. * matrices:                             Matrices.
  601. * matrix multiplication:                Arithmetic Ops.
  602. * maximum field width (scanf):          Input Conversion Syntax.
  603. * messages, error:                      Errors.
  604. * minimum field width (printf):         Output Conversion Syntax.
  605. * multiplication:                       Arithmetic Ops.
  606. * negation:                             Arithmetic Ops.
  607. * NLP:                                  Optimization.
  608. * nonlinear equations:                  Nonlinear Equations.
  609. * nonlinear programming:                Optimization.
  610. * not operator:                         Boolean Expressions.
  611. * numeric constant <1>:                 Numeric Data Types.
  612. * numeric constant:                     Numeric Objects.
  613. * numeric value <1>:                    Numeric Data Types.
  614. * numeric value:                        Numeric Objects.
  615. * Octave command options:               Command Line Options.
  616. * ODE:                                  Differential Equations.
  617. * on-line help:                         Getting Help.
  618. * operator precedence:                  Operator Precedence.
  619. * operators, arithmetic:                Arithmetic Ops.
  620. * operators, assignment:                Assignment Ops.
  621. * operators, boolean:                   Boolean Expressions.
  622. * operators, decrement:                 Assignment Ops.
  623. * operators, increment:                 Assignment Ops.
  624. * operators, logical:                   Boolean Expressions.
  625. * operators, relational:                Comparison Ops.
  626. * optimization:                         Optimization.
  627. * options, Octave command:              Command Line Options.
  628. * or operator:                          Boolean Expressions.
  629. * oregonator:                           Ordinary Differential Equations.
  630. * output conversions, for printf:       Table of Output Conversions.
  631. * partial fraction expansion:           Polynomial Manipulations.
  632. * patches, submitting:                  Sending Patches.
  633. * plotting:                             Two-Dimensional Plotting.
  634. * precision (printf):                   Output Conversion Syntax.
  635. * printing notation:                    Printing Notation.
  636. * program, self contained:              Executable Octave Programs.
  637. * programs:                             Comments.
  638. * prompt customization:                 Customizing the Prompt.
  639. * QP:                                   Optimization.
  640. * QR factorization:                     Matrix Factorizations.
  641. * quadratic programming:                Optimization.
  642. * quitting octave <1>:                  Quitting Octave.
  643. * quitting octave:                      Running Octave.
  644. * quotient:                             Arithmetic Ops.
  645. * range expressions:                    Ranges.
  646. * relational operators:                 Comparison Ops.
  647. * reporting bugs <1>:                   Reporting Bugs.
  648. * reporting bugs:                       Bug Lists.
  649. * results, incorrect <1>:               Bug Reporting.
  650. * results, incorrect:                   Bug Criteria.
  651. * Schur decomposition:                  Matrix Factorizations.
  652. * script files:                         Functions and Scripts.
  653. * scripts:                              Executable Octave Programs.
  654. * self contained programs:              Executable Octave Programs.
  655. * short-circuit evaluation:             Short-circuit Boolean Operators.
  656. * side effect:                          Assignment Ops.
  657. * singular value decomposition:         Matrix Factorizations.
  658. * speedups:                             Coding Tips.
  659. * standards of coding style:            Tips.
  660. * startup:                              Startup Files.
  661. * startup files:                        Startup Files.
  662. * statements:                           Statements.
  663. * strings <1>:                          Strings.
  664. * strings:                              String Objects.
  665. * structure elements, looping over:     Looping Over Structure Elements.
  666. * structures <1>:                       Data Structure Objects.
  667. * structures:                           Data Structures.
  668. * submitting diffs:                     Sending Patches.
  669. * submitting patches:                   Sending Patches.
  670. * subtraction:                          Arithmetic Ops.
  671. * suggestions:                          Bug Criteria.
  672. * TAGS:                                 Using Octave Mode.
  673. * tests for equality:                   Comparison Ops.
  674. * tips:                                 Tips.
  675. * transpose:                            Arithmetic Ops.
  676. * transpose, complex-conjugate:         Arithmetic Ops.
  677. * troubleshooting:                      Trouble.
  678. * unary minus:                          Arithmetic Ops.
  679. * undefined behavior:                   Bug Criteria.
  680. * undefined function value:             Bug Criteria.
  681. * use of comments:                      Comments.
  682. * user-defined data types:              User-defined Data Types.
  683. * user-defined functions:               Functions and Scripts.
  684. * user-defined variables:               Variables.
  685. * variable descriptions:                A Sample Variable Description.
  686. * Variable-length argument lists:       Variable-length Argument Lists.
  687. * Variable-length return lists:         Variable-length Return Lists.
  688. * variables, global:                    Global Variables.
  689. * variables, user-defined:              Variables.
  690. * warranty:                             Keywords.
  691. * wrong answers <1>:                    Bug Criteria.
  692. * wrong answers:                        Bug Reporting.
  693.  
  694. 
  695. File: octave,  Node: Variable Index,  Next: Function Index,  Prev: Concept Index,  Up: Top
  696.  
  697. Variable Index
  698. **************
  699.  
  700. * Menu:
  701.  
  702. *  <1>:                                 Recursion.
  703. * :                                     Global Variables.
  704. * all_va_args:                          Variable-length Argument Lists.
  705. * ans:                                  Terminal Output.
  706. * argv:                                 Command Line Options.
  707. * automatic_replot <1>:                 Summary of Built-in Variables.
  708. * automatic_replot:                     Two-Dimensional Plotting.
  709. * auto_unload_dot_oct_files <1>:        Dynamically Linked Functions.
  710. * auto_unload_dot_oct_files:            Summary of Built-in Variables.
  711. * beep_on_error <1>:                    Error Handling.
  712. * beep_on_error:                        Summary of Built-in Variables.
  713. * completion_append_char <1>:           Summary of Built-in Variables.
  714. * completion_append_char:               Commands For Completion.
  715. * crash_dumps_octave_core <1>:          Summary of Built-in Variables.
  716. * crash_dumps_octave_core:              Simple File I/O.
  717. * default_eval_print_flag <1>:          Summary of Built-in Variables.
  718. * default_eval_print_flag:              Evaluation.
  719. * DEFAULT_LOADPATH <1>:                 Function Files.
  720. * DEFAULT_LOADPATH:                     Summary of Built-in Variables.
  721. * default_return_value <1>:             Summary of Built-in Variables.
  722. * default_return_value:                 Multiple Return Values.
  723. * default_save_format <1>:              Simple File I/O.
  724. * default_save_format:                  Summary of Built-in Variables.
  725. * define_all_return_values <1>:         Summary of Built-in Variables.
  726. * define_all_return_values:             Multiple Return Values.
  727. * do_fortran_indexing <1>:              Index Expressions.
  728. * do_fortran_indexing:                  Summary of Built-in Variables.
  729. * do_what_i_mean_not_what_i_say:        A Sample Variable Description.
  730. * e:                                    Mathematical Constants.
  731. * echo_executing_commands:              Diary and Echo Commands.
  732. * EDITOR <1>:                           Summary of Built-in Variables.
  733. * EDITOR <2>:                           Defaults from the Environment.
  734. * EDITOR:                               Commands For History.
  735. * empty_list_elements_ok <1>:           Summary of Built-in Variables.
  736. * empty_list_elements_ok:               Empty Matrices.
  737. * eps:                                  Mathematical Constants.
  738. * error_text:                           Error Handling.
  739. * EXEC_PATH <1>:                        Summary of Built-in Variables.
  740. * EXEC_PATH:                            Controlling Subprocesses.
  741. * fixed_point_format <1>:               Matrices.
  742. * fixed_point_format:                   Summary of Built-in Variables.
  743. * F_DUPFD:                              Controlling Subprocesses.
  744. * F_GETFD:                              Controlling Subprocesses.
  745. * F_GETFL:                              Controlling Subprocesses.
  746. * F_SETFD:                              Controlling Subprocesses.
  747. * F_SETFL:                              Controlling Subprocesses.
  748. * gnuplot_binary <1>:                   Summary of Built-in Variables.
  749. * gnuplot_binary:                       Three-Dimensional Plotting.
  750. * gnuplot_has_frames:                   Three-Dimensional Plotting.
  751. * gnuplot_has_multiplot:                Three-Dimensional Plotting.
  752. * history_file <1>:                     Summary of Built-in Variables.
  753. * history_file:                         Commands For History.
  754. * history_size <1>:                     Commands For History.
  755. * history_size:                         Summary of Built-in Variables.
  756. * I:                                    Mathematical Constants.
  757. * ignore_function_time_stamp <1>:       Summary of Built-in Variables.
  758. * ignore_function_time_stamp:           Function Files.
  759. * IMAGEPATH:                            Image Processing.
  760. * implicit_num_to_str_ok <1>:           String Conversions.
  761. * implicit_num_to_str_ok:               Summary of Built-in Variables.
  762. * implicit_str_to_num_ok <1>:           Summary of Built-in Variables.
  763. * implicit_str_to_num_ok:               String Conversions.
  764. * inf:                                  Mathematical Constants.
  765. * INFO_FILE <1>:                        Getting Help.
  766. * INFO_FILE:                            Summary of Built-in Variables.
  767. * INFO_PROGRAM <1>:                     Getting Help.
  768. * INFO_PROGRAM:                         Summary of Built-in Variables.
  769. * j:                                    Mathematical Constants.
  770. * LOADPATH <1>:                         Function Files.
  771. * LOADPATH:                             Summary of Built-in Variables.
  772. * max_recursion_depth:                  Summary of Built-in Variables.
  773. * nan:                                  Mathematical Constants.
  774. * nargin:                               Defining Functions.
  775. * nargout:                              Multiple Return Values.
  776. * OCTAVE_EXEC_PATH:                     Defaults from the Environment.
  777. * OCTAVE_HISTFILE:                      Defaults from the Environment.
  778. * OCTAVE_HISTSIZE:                      Defaults from the Environment.
  779. * OCTAVE_HOME:                          Summary of Built-in Variables.
  780. * OCTAVE_INFO_FILE:                     Defaults from the Environment.
  781. * OCTAVE_INFO_PROGRAM:                  Defaults from the Environment.
  782. * OCTAVE_PATH:                          Defaults from the Environment.
  783. * OCTAVE_VERSION:                       System Information.
  784. * ok_to_lose_imaginary_part:            Summary of Built-in Variables.
  785. * output_max_field_width <1>:           Matrices.
  786. * output_max_field_width:               Summary of Built-in Variables.
  787. * output_precision <1>:                 Matrices.
  788. * output_precision:                     Summary of Built-in Variables.
  789. * O_APPEND:                             Controlling Subprocesses.
  790. * O_ASYNC:                              Controlling Subprocesses.
  791. * O_NONBLOCK:                           Controlling Subprocesses.
  792. * O_RDONLY:                             Controlling Subprocesses.
  793. * O_RDWR:                               Controlling Subprocesses.
  794. * O_SYNC:                               Controlling Subprocesses.
  795. * O_WRONLY:                             Controlling Subprocesses.
  796. * PAGER <1>:                            Input and Output.
  797. * PAGER:                                Summary of Built-in Variables.
  798. * page_output_immediately:              Input and Output.
  799. * page_screen_output <1>:               Input and Output.
  800. * page_screen_output:                   Summary of Built-in Variables.
  801. * pi:                                   Mathematical Constants.
  802. * prefer_column_vectors <1>:            Summary of Built-in Variables.
  803. * prefer_column_vectors:                Index Expressions.
  804. * prefer_zero_one_indexing:             Index Expressions.
  805. * print_answer_id_name <1>:             Summary of Built-in Variables.
  806. * print_answer_id_name:                 Terminal Output.
  807. * print_empty_dimensions <1>:           Empty Matrices.
  808. * print_empty_dimensions:               Summary of Built-in Variables.
  809. * program_invocation_name:              Command Line Options.
  810. * program_name:                         Command Line Options.
  811. * propagate_empty_matrices:             Empty Matrices.
  812. * PS1 <1>:                              Customizing the Prompt.
  813. * PS1:                                  Summary of Built-in Variables.
  814. * PS2 <1>:                              Customizing the Prompt.
  815. * PS2:                                  Summary of Built-in Variables.
  816. * PS4 <1>:                              Summary of Built-in Variables.
  817. * PS4:                                  Customizing the Prompt.
  818. * realmax:                              Mathematical Constants.
  819. * realmin:                              Mathematical Constants.
  820. * resize_on_range_error <1>:            Index Expressions.
  821. * resize_on_range_error:                Summary of Built-in Variables.
  822. * return:                               Returning From a Function.
  823. * return_last_computed_value <1>:       Returning From a Function.
  824. * return_last_computed_value:           Summary of Built-in Variables.
  825. * save_precision <1>:                   Simple File I/O.
  826. * save_precision:                       Summary of Built-in Variables.
  827. * saving_history <1>:                   Summary of Built-in Variables.
  828. * saving_history:                       Commands For History.
  829. * SEEK_CUR:                             File Positioning.
  830. * SEEK_END:                             File Positioning.
  831. * SEEK_SET:                             File Positioning.
  832. * silent_functions <1>:                 Defining Functions.
  833. * silent_functions:                     Summary of Built-in Variables.
  834. * split_long_rows <1>:                  Matrices.
  835. * split_long_rows:                      Summary of Built-in Variables.
  836. * stderr:                               C-Style I/O Functions.
  837. * stdin:                                C-Style I/O Functions.
  838. * stdout:                               C-Style I/O Functions.
  839. * string_fill_char:                     Creating Strings.
  840. * struct_levels_to_print <1>:           Data Structures.
  841. * struct_levels_to_print:               Summary of Built-in Variables.
  842. * suppress_verbose_help_message <1>:    Summary of Built-in Variables.
  843. * suppress_verbose_help_message:        Getting Help.
  844. * treat_neg_dim_as_zero <1>:            Special Utility Matrices.
  845. * treat_neg_dim_as_zero:                Summary of Built-in Variables.
  846. * warn_assign_as_truth_value <1>:       Summary of Built-in Variables.
  847. * warn_assign_as_truth_value:           The if Statement.
  848. * warn_comma_in_global_decl <1>:        Summary of Built-in Variables.
  849. * warn_comma_in_global_decl:            Global Variables.
  850. * warn_divide_by_zero <1>:              Arithmetic Ops.
  851. * warn_divide_by_zero:                  Summary of Built-in Variables.
  852. * warn_function_name_clash <1>:         Summary of Built-in Variables.
  853. * warn_function_name_clash:             Function Files.
  854. * warn_missing_semicolon:               Defining Functions.
  855. * warn_reload_forces_clear <1>:         Dynamically Linked Functions.
  856. * warn_reload_forces_clear:             Summary of Built-in Variables.
  857. * warn_variable_switch_label <1>:       The switch Statement.
  858. * warn_variable_switch_label:           Summary of Built-in Variables.
  859. * whitespace_in_literal_matrix <1>:     Matrices.
  860. * whitespace_in_literal_matrix:         Summary of Built-in Variables.
  861.  
  862.