Mercurial > hg > octave-lyh
changeset 12478:b4138a75eecc
Uniformise "Matlab" typesetting in FAQ.
author | Jordi Gutiérrez Hermoso <jordigh@gmail.com> |
---|---|
date | Fri, 25 Feb 2011 12:28:14 -0600 |
parents | d1466d956d17 |
children | c741c1f2789e |
files | doc/ChangeLog doc/faq/OctaveFAQ.texi |
diffstat | 2 files changed, 28 insertions(+), 23 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2011-02-25 Jordi GutiƩrrez Hermoso <jordigh@gmail.com> + + * faq/OctaveFAQ.texi: Uniformise all mentions of Matlab to be + typeset in the @sc{Matlab} style. + 2010-02-19 Rik <octave@nomad.inbox5.com> * interpreter/install.txi: Remove reference to POSIX regex library.
--- a/doc/faq/OctaveFAQ.texi +++ b/doc/faq/OctaveFAQ.texi @@ -64,7 +64,7 @@ * Installation:: * Common problems:: * How do I ...?:: -* MATLAB compatibility:: +* @sc{Matlab} compatibility:: * Index:: @end menu @@ -194,7 +194,7 @@ considered a derivative work of Octave and therefore must be released under terms that are compatible with the GPL. -Code written using Octave's implementation of the Matlab MEX +Code written using Octave's implementation of the @sc{Matlab} MEX interface may be released under the terms of whatever license you choose, provided that the following conditions are met: @@ -204,7 +204,7 @@ other words, the MEX file must use the MEX interface only, and not also call on other Octave internals. It should be possible in principle to use the MEX file with other programs that implement the MEX interface -(e.g., Matlab). +(e.g., @sc{Matlab}). @item The MEX file should not be distributed together with Octave in such a @@ -227,7 +227,7 @@ No. The original reason for implementing the MEX interface for Octave was to allow Octave to run free software that uses MEX files (the particular goal was to run SundialsTB in Octave). The intent was to -liberate that software from Matlab and increase the amount of free +liberate that software from @sc{Matlab} and increase the amount of free software available to Octave users, not to enable people to write proprietary code for Octave. For the good of the community, we strongly encourage users of Octave to release the code they write for Octave @@ -280,7 +280,7 @@ @item 64-bit compilation support -@item gzipped files and stream and consequently support of matlab v7 files +@item gzipped files and stream and consequently support of @sc{Matlab} v7 files @item better support for both msvc and mingw @@ -346,7 +346,7 @@ * Built-in ODE and DAE solvers:: @end menu -This section refers to Matlab R2008b and Octave 2.1.51. +This section refers to @sc{Matlab} R2008b and Octave 2.1.51. @node Functions defined on the command-line @section Functions defined on the command-line @@ -382,7 +382,7 @@ The double quote, @samp{"}, may be used to delimit strings, in addition to the single quote @samp{'}. See the previous example. Also, double-quoted strings include backslash interpretation (like C++, C, and Perl) while -single quoted are uninterpreted (like Matlab and Perl). +single quoted are uninterpreted (like @sc{Matlab} and Perl). @node Line continuation by backslash @section Line continuation by backslash @@ -395,7 +395,7 @@ You may close @code{function}, @code{for}, @code{while}, @code{if}, @dots{} blocks with @code{endfunction}, @code{endfor}, @code{endwhile}, -@dots{} keywords in addition to using @code{end}. As with Matlab, the +@dots{} keywords in addition to using @code{end}. As with @sc{Matlab}, the @code{end} (or @code{endfunction}) keyword that marks the end of a function defined in a @file{.m} file is optional. @@ -485,7 +485,7 @@ The @code{unwind_protect} statement is often used to reliably restore the values of global variables that need to be temporarily changed. -Matlab can be made to do something similar with their @code{OnCleanUp} +@sc{Matlab} can be made to do something similar with their @code{OnCleanUp} function that was introduced in 2008a. @node Built-in ODE and DAE solvers @@ -769,7 +769,7 @@ @end group @end example -@node MATLAB compatibility +@node @sc{Matlab} compatibility @chapter Porting programs from @sc{Matlab} to Octave @cindex @sc{Matlab} compatibility @@ -794,8 +794,8 @@ description of this difference (with code illustrating the difference, if possible) to @email{bug@@octave.org}. -Furthermore, Octave adds a few syntactical extensions to Matlab that -might cause some issues when exchanging files between Matlab and Octave +Furthermore, Octave adds a few syntactical extensions to @sc{Matlab} that +might cause some issues when exchanging files between @sc{Matlab} and Octave users. As both Octave and @sc{Matlab} are under constant development the information in this section is subject to change at anytime. @@ -845,7 +845,7 @@ sub-functions. The authors of Octave consider the nested function scoping rules of -Matlab to be more problems than they are worth as they introduce +@sc{Matlab} to be more problems than they are worth as they introduce diffiult to find bugs as inadvertantly modifying a variable in a nested function that is also used in the parent is particularly easy. @@ -909,7 +909,7 @@ bindings from Octave to Tcl/Tk, Vtk and zenity included in the Octave Forge project (@url{http://octave.sourceforge.net}) for example that can be used for a GUI, but these are not @sc{Matlab} -compatible. Work on a matlab compatible GUI is in an alpha stage in the +compatible. Work on a @sc{Matlab} compatible GUI is in an alpha stage in the JHandles package (@url{http://octave.sourceforge.net/jhandles/index.html}). This might be an issue if you intend to exchange Octave code with @sc{Matlab} users. @@ -923,7 +923,7 @@ @url{http://www.scicraft.org/} @item Mex-Files -Octave includes an API to the matlab MEX interface. However, as MEX is +Octave includes an API to the @sc{Matlab} MEX interface. However, as MEX is an API to the internals of @sc{Matlab} and the internals of Octave differ from @sc{Matlab}, there is necessarily a manipulation of the data to convert from a MEX interface to the Octave equivalent. This is @@ -943,7 +943,7 @@ There are some differences in the mat v5 file format accepted by Octave. @sc{Matlab} recently introduced the "-V7.3" save option which is an HDF5 format which is particularly useful for 64-bit platforms where -the standard matlab format can not correctly save variables.. Octave +the standard @sc{Matlab} format can not correctly save variables.. Octave accepts HDF5 files, but is not yet compatible with the "-v7.3" versions produced by @sc{Matlab}. @@ -967,7 +967,7 @@ donated by those interested in them through the Octave Forge website (@url{http://octave.sourceforge.net}). These might be lacking in certain functionality relative to the @sc{Matlab} toolboxes, and might not -exactly duplicate the matlab functionality or interface. +exactly duplicate the @sc{Matlab} functionality or interface. @item Short-circuit & and | operators The @code{&} and @code{|} operators in @sc{Matlab} short-circuit when @@ -1059,16 +1059,16 @@ @item Solvers for singular, under- and over-determined matrices -Matlab's solvers as used by the operators mldivide (\) and mrdivide (/), +@sc{Matlab}'s solvers as used by the operators mldivide (\) and mrdivide (/), use a different approach than Octave's in the case of singular, under-, -or over-determined matrices. In the case of a singular matrix, Matlab +or over-determined matrices. In the case of a singular matrix, @sc{Matlab} returns the result given by the LU decomposition, even though the underlying solver has flagged the result as erroneous. Octave has made the choice of falling back to a minimum norm solution of matrices that have been flagged as singular which arguably is a better result for these cases. In the case of under- or over-determined matrices, Octave continues to -use a minimum norm solution, whereas Matlab uses an approach that is +use a minimum norm solution, whereas @sc{Matlab} uses an approach that is equivalent to @example @@ -1100,7 +1100,7 @@ @end example @noindent -while Octave's minimum-norm values are around 3e-2, Matlab's results +while Octave's minimum-norm values are around 3e-2, @sc{Matlab}'s results are 50-times larger. For another issue, try this code: @example @@ -1119,7 +1119,7 @@ @end example @noindent -It shows that unlike in Octave, mldivide in Matlab is not invariant +It shows that unlike in Octave, mldivide in @sc{Matlab} is not invariant with respect to column permutations. If there are multiple columns of the same norm, permuting columns of the matrix gets you different result than permuting the solution vector. This will surprise many @@ -1129,7 +1129,7 @@ complex expression, where there is no room to react to warnings or flags, it should prefer intelligence (robustness) to speed, and so the Octave developers are firmly of the opinion that Octave's approach for singular, under- and -over-determined matrices is a better choice that Matlab's +over-determined matrices is a better choice that @sc{Matlab}'s @item Octave extensions The extensions in Octave over @sc{Matlab} syntax are