# HG changeset patch # User jwe # Date 1078899019 0 # Node ID a3dd9369a1d4b93173ed22732f771fb9afe8cb57 # Parent 71dade3c16b6dda4bbb56d53d6be7f9257b44218 [project @ 2004-03-10 06:10:19 by jwe] diff -r 71dade3c16b6 -r a3dd9369a1d4 doc/faq/Octave-FAQ.texi --- a/doc/faq/Octave-FAQ.texi Wed Mar 10 05:12:07 2004 +0000 +++ b/doc/faq/Octave-FAQ.texi Wed Mar 10 06:10:19 2004 +0000 @@ -15,7 +15,7 @@ @end titlepage @ifinfo -@node Top, What is Octave?, (dir), (dir) +@node Top @top @unnumbered Preface @cindex FAQ for Octave, latest version @@ -38,7 +38,8 @@ @menu * What is Octave?:: -* Version 2.0:: +* How can I cite Octave?:: +* Version 2.0:: * Octave Features:: * Documentation:: * Getting Octave:: @@ -50,7 +51,7 @@ * Index:: @end menu -@node What is Octave?, Version 2.0, Top, Top +@node What is Octave? @chapter What is Octave? Octave is a high-level interactive language, primarily intended for @@ -87,7 +88,26 @@ under the terms of the GNU General Public License as published by the Free Software Foundation. -@node Version 2.0, Octave Features, What is Octave?, Top +@node How can I cite Octave? +@chapter How can I cite Octave? +Pointing to @url{octave.org} is good, because that gives people a +direct way to find out more. If citation of a URL is not allowed by a +publisher, or if you also want to point to a traditional reference, +then you can cite the Octave manual: + +@example +@group + @@BOOK{eaton:2002, + author = "John W. Eaton", + title = "GNU Octave Manual", + publisher = "Network Theory Limited", + year = "2002", + isbn = "0-9541617-2-6" + } +@end group +@end example + +@node Version 2.0 @chapter What's new in version 2.0 of Octave Version 2.0.10 of Octave was released February 6, 1998. Most bugs @@ -99,7 +119,7 @@ in the file NEWS, distributed in both source and binary releases of Octave. -@node Octave Features, Documentation, Version 2.0, Top +@node Octave Features @chapter What features are unique to Octave? @menu @@ -114,7 +134,7 @@ * Built-in ODE and DAE solvers:: @end menu -@node Command and variable name completion, Command history, Octave Features, Octave Features +@node Command and variable name completion @section Command and variable name completion @cindex Command completion @@ -137,7 +157,7 @@ (usually adding more characters until completion is possible) or type another TAB to cause Octave to display the list of possible completions. -@node Command history, Data structures, Command and variable name completion, Octave Features +@node Command history @section Command history @cindex Command history @@ -152,7 +172,7 @@ contents of the @file{~/.octave_hist} file in the history list so that it is easy to begin working where you left off. -@node Data structures, Short-circuit boolean operators, Command history, Octave Features +@node Data structures @section Data structures @cindex Data structures @@ -291,7 +311,7 @@ This feature should be considered experimental, but you should expect it to work. Suggestions for ways to improve it are welcome. -@node Short-circuit boolean operators, Increment and decrement operators, Data structures, Octave Features +@node Short-circuit boolean operators @section Short-circuit boolean operators @cindex Boolean operators, short-circuit @@ -304,7 +324,7 @@ language) and work differently than the element by element operators @samp{&} and @samp{|}. -@node Increment and decrement operators, Unwind-protect, Short-circuit boolean operators, Octave Features +@node Increment and decrement operators @section Increment and decrement operators @cindex Increment operators @@ -335,7 +355,7 @@ results in a parse error. This problem may be fixed in a future release of Octave. -@node Unwind-protect, Variable-length argument lists, Increment and decrement operators, Octave Features +@node Unwind-protect @section Unwind-protect @cindex Unwind-protect @@ -362,7 +382,7 @@ The @code{unwind_protect} statement is often used to reliably restore the values of global variables that need to be temporarily changed. -@node Variable-length argument lists, Variable-length return lists, Unwind-protect, Octave Features +@node Variable-length argument lists @section Variable-length argument lists @cindex Variable-length argument lists @@ -401,7 +421,7 @@ It is also possible to use the keyword @var{all_va_args} to pass all unnamed arguments to another function. -@node Variable-length return lists, Built-in ODE and DAE solvers, Variable-length argument lists, Octave Features +@node Variable-length return lists @section Variable-length return lists @cindex Variable-length return lists @@ -424,7 +444,7 @@ @end group @end example -@node Built-in ODE and DAE solvers, , Variable-length return lists, Octave Features +@node Built-in ODE and DAE solvers @section Built-in ODE and DAE solvers @cindex DASSL @@ -434,7 +454,7 @@ differential and differential-algebraic equations. These functions are built in to the interpreter. -@node Documentation, Getting Octave, Octave Features, Top +@node Documentation @chapter What documentation exists for Octave? @cindex Octave, documentation @@ -456,7 +476,7 @@ manual by converting the Texinfo source to HTML using the @code{texi2html} program. -@node Getting Octave, Installation, Documentation, Top +@node Getting Octave @chapter Obtaining Source Code @cindex Source code @@ -467,7 +487,7 @@ * latest versions:: @end menu -@node Octave for Unix, Octave for other platforms, Getting Octave, Getting Octave +@node Octave for Unix @section How do I get a copy of Octave for Unix? You can get Octave from a friend who has a copy, by anonymous FTP, or by @@ -515,7 +535,7 @@ distribution contains a more detailed record of changes made since the last release. -@node Octave for other platforms, latest versions, Octave for Unix, Getting Octave +@node Octave for other platforms @section How do I get a copy of Octave for (some other platform)? @cindex VMS support @@ -532,14 +552,14 @@ porting Octave to other systems, please contact bug-octave@@bevo.che.wisc.edu. -@node latest versions, , Octave for other platforms, Getting Octave +@node latest versions @section What is the latest version of Octave @cindex Octave, version date The latest version of Octave is 2.0.10, released February 6, 1998. -@node Installation, Common problems, Getting Octave, Top +@node Installation @chapter Installation Issues and Problems @cindex Octave, building @@ -556,7 +576,7 @@ * Other C++ compilers?:: @end menu -@node What else do I need?, Other C++ compilers?, Installation, Installation +@node What else do I need? @section What else do I need? @cindex GNU gcc @@ -581,7 +601,7 @@ use features of GNU Make that are not present in other versions of make. GNU Make is very portable and easy to install. -@node Other C++ compilers?, , What else do I need?, Installation +@node Other C++ compilers? @section Can I compile Octave with another C++ compiler? Currently, Octave can only be compiled with the GNU C++ compiler. It @@ -590,7 +610,7 @@ this. If you are interested in working to make Octave portable to other compilers, please contact bug-octave@@bevo.che.wisc.edu. -@node Common problems, Getting additional help, Installation, Top +@node Common problems @chapter Common problems This list is probably far too short. Feel free to suggest additional @@ -611,7 +631,7 @@ function files is installed this way. @end itemize -@node Getting additional help, Bug reports, Common problems, Top +@node Getting additional help @chapter Getting additional help @cindex Additional help @@ -644,7 +664,7 @@ An archive of old postings to the help-octave mailing list is maintained on ftp.che.wisc.edu in the directory @file{/pub/octave/MAILING-LISTS}. -@node Bug reports, MATLAB compatibility, Getting additional help, Top +@node Bug reports @chapter I think I have found a bug in Octave. @cindex Bug in Octave, newly found @@ -678,7 +698,7 @@ Octave manual for a list of things that should be included in every bug report. -@node MATLAB compatibility, Index, Bug reports, Top +@node MATLAB compatibility @chapter Porting programs from @sc{Matlab} to Octave @cindex @sc{Matlab} compatibility @@ -744,7 +764,7 @@ An archive of old postings to the Octave mailing lists is maintained on ftp.che.wisc.edu in the directory @file{/pub/octave/MAILING-LISTS}. -@node Index, , MATLAB compatibility, Top +@node Index @appendix Concept Index @printindex cp