home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / octa21eb.zip / octave / NEWS < prev    next >
Text File  |  1999-05-13  |  43KB  |  1,006 lines

  1. Summary of changes for version 2.1.x:
  2. ------------------------------------
  3.  
  4.   * The ++ and -- operators now work for indexed matrices, and the
  5.     following operators now work:
  6.  
  7.       +=, -=, *=, /=, \=, <<=, >>=, .*=, ./=, .\=, &=, |=
  8.  
  9.     These operators are currently implemented using a relatively
  10.     inefficient brute-force method but hey, they work.
  11.  
  12.   * The built-in variable argv is now a list of strings instead of a
  13.     string vector.
  14.  
  15.   * The value of LOADPATH set by the environment variable
  16.     OCTAVE_PATH, the -p or --path command line options, or on the
  17.     command line is no longer modified to include the default path.
  18.     Instead it is left as specified.  Its default value is now ":",
  19.     which tells Octave to search the default path, and the new
  20.     built-in variable DEFAULT_LOADPATH contains the default list of
  21.     directories to search.  
  22.  
  23.   * The function file_in_path no longer does any special processing of
  24.     its PATH argument.  To search LOADPATH for files, it is now
  25.     generally better to use the new function file_in_loadpath.
  26.  
  27.   * If fread is given a skip parameter, the skip is performed after
  28.     the read instead of before (for compatibility with Matlab).
  29.  
  30.   * The new built-in variable `crash_dumps_octave_core' controls
  31.     whether Octave writes user variables to the file `octave-core'
  32.     when it crashes or is killed by a signal.  The default value is 1
  33.     (0 if you use --traditional).
  34.  
  35.   * If LOADPATH contains a doubled colon, the default path is inserted
  36.     in its place.  This is similar to the substitution that also takes
  37.     place for leading or trailing colons in the LOADPATH.
  38.  
  39.   * Loops of the form `for i = STRING ... endfor' are now allowed.
  40.  
  41.   * It is now possible to set the iteration limit for lsode using
  42.     lsode_options ("step limit", N).
  43.  
  44.   * New functions:
  45.  
  46.       is_complex  -- tell whether a variable is complex
  47.       rehash      -- re-initialize the cache of directories in LOADPATH
  48.       graw        -- send a string to the gnuplot subprocess
  49.  
  50.   * New functions from Kurt Hornik's Octave-ci package:
  51.  
  52.     In finance (new directory):
  53.  
  54.       fv    -- future value of an investment
  55.       fvl   -- future value of an initial lump sum investment
  56.       irr   -- internal rate of return of an investment
  57.       nper  -- number of payments needed for amortizing a loan
  58.       npv   -- net present value of a series of payments
  59.       pmt   -- amount of periodic payment needed to amortize a loan
  60.       pv    -- present value of an investment
  61.       pvl   -- present value of an investment that pays off at the end
  62.       rate  -- rate of return of an investment
  63.       vol   -- volatility of financial time series data
  64.  
  65.     In linear-algebra:
  66.  
  67.       dmult -- rescale the rows of a matrix
  68.  
  69.     In signal:
  70.  
  71.       arch_fit       -- fit an ARCH regression model
  72.       arch_rnd       -- simulate an ARCH process
  73.       arch_test      -- test for conditional heteroscedascity
  74.       arma_rnd       -- simulate an ARMA process
  75.       autocor        -- compute autocorrelations
  76.       autocov        -- compute autocovariances
  77.       autoreg_matrix -- design matrix for autoregressions
  78.       bartlett       -- coefficients of the Bartlett (triangular) window
  79.       blackman       -- coefficients of the Blackman window
  80.       diffpara       -- estimate the fractional differencing parameter
  81.       durbinlevinson -- perform one step of the Durbin-Levinson algorithm
  82.       fractdiff      -- compute fractional differences
  83.       hamming        -- coefficients of the Hamming window
  84.       hanning        -- coefficients of the Hanning window
  85.       hurst          -- estimate the Hurst parameter
  86.       periodogram    -- compute the periodogram
  87.       rectangle_lw   -- rectangular lag window
  88.       rectangle_sw   -- rectangular spectral window
  89.       sinetone       -- compute a sine tone
  90.       sinewave       -- compute a sine wave
  91.       spectral_adf   -- spectral density estimation
  92.       spectral_xdf   -- spectral density estimation
  93.       spencer        -- apply Spencer's 15-point MA filter
  94.       stft           -- short-term Fourier transform
  95.       synthesis      -- recover a signal from its short-term Fourier transform
  96.       triangle_lw    -- triangular lag window
  97.       triangle_sw    -- triangular spectral window
  98.       yulewalker     -- fit AR model by Yule-Walker method
  99.  
  100.     In statistics/base (new directory):
  101.  
  102.       center     -- center by subtracting means
  103.       cloglog    -- complementary log-log function
  104.       cor        -- compute correlations
  105.       cov        -- compute covariances
  106.       cut        -- cut data into intervals
  107.       iqr        -- interquartile range
  108.       kendall    -- kendall's rank correlation tau
  109.       logit      -- logit transformation
  110.       mean       -- compute arithmetic, geometric, and harmonic mean
  111.       meansq     -- compute mean square
  112.       moment     -- compute moments
  113.       ppplot     -- perform a PP-plot (probability plot)
  114.       probit     -- probit transformation
  115.       qqplot     -- perform a QQ-plot (quantile plot)
  116.       range      -- compute range
  117.       ranks      -- compute ranks
  118.       run_count  -- count upward runs
  119.       spearman   -- spearman's rank correlation rho
  120.       statistics -- compute basic statistics
  121.       studentize -- subtract mean and divide by standard deviation
  122.       table      -- cross tabulation
  123.       values     -- extract unique elements
  124.       var        -- compute variance
  125.  
  126.     In statistics/distributions (new directory):
  127.  
  128.       beta_cdf           -- CDF of the Beta distribution
  129.       beta_inv           -- Quantile function of the Beta distribution
  130.       beta_pdf           -- PDF of the Beta distribution
  131.       beta_rnd           -- Random deviates from the Beta distribution
  132.  
  133.       binomial_cdf       -- CDF of the binomial distribution
  134.       binomial_inv       -- Quantile function of the binomial distribution
  135.       binomial_pdf       -- PDF of the binomial distribution
  136.       binomial_rnd       -- Random deviates from the binomial distribution
  137.  
  138.       cauchy_cdf         -- CDF of the Cauchy distribution
  139.       cauchy_inv         -- Quantile function of the Cauchy distribution
  140.       cauchy_pdf         -- PDF of the Cauchy distribution
  141.       cauchy_rnd         -- Random deviates from the Cauchy distribution
  142.  
  143.       chisquare_cdf      -- CDF of the chi-square distribution
  144.       chisquare_inv      -- Quantile function of the chi-square distribution
  145.       chisquare_pdf      -- PDF of the chi-sqaure distribution
  146.       chisquare_rnd      -- Random deviates from the chi-square distribution
  147.  
  148.       discrete_cdf       -- CDF of a discrete distribution
  149.       discrete_inv       -- Quantile function of a discrete distribution
  150.       discrete_pdf       -- PDF of a discrete distribution
  151.       discrete_rnd       -- Random deviates from a discrete distribution
  152.  
  153.       empirical_cdf      -- CDF of the empirical distribution
  154.       empirical_inv      -- Quantile function of the empirical distribution
  155.       empirical_pdf      -- PDF of the empirical distribution
  156.       empirical_rnd      -- Bootstrap samples from the empirical distribution
  157.  
  158.       exponential_cdf    -- CDF of the exponential distribution
  159.       exponential_inv    -- Quantile function of the exponential distribution
  160.       exponential_pdf    -- PDF of the exponential distribution
  161.       exponential_rnd    -- Random deviates from the exponential distribution
  162.  
  163.       f_cdf              -- CDF of the F distribution
  164.       f_inv              -- Quantile function of the F distribution
  165.       f_pdf              -- PDF of the F distribution
  166.       f_rnd              -- Random deviates from the F distribution
  167.  
  168.       gamma_cdf          -- CDF of the Gamma distribution
  169.       gamma_inv          -- Quantile function of the Gamma distribution
  170.       gamma_pdf          -- PDF of the Gamma distribution
  171.       gamma_rnd          -- Random deviates from the Gamma distribution
  172.  
  173.       geometric_cdf      -- CDF of the geometric distribution
  174.       geometric_inv      -- Quantile function of the geometric distribution
  175.       geometric_pdf      -- PDF of the geometric distribution
  176.       geometric_rnd      -- Random deviates from the geometric distribution
  177.  
  178.       hypergeometric_cdf -- CDF of the hypergeometric distribution
  179.       hypergeometric_inv -- Random deviates from hypergeometric distribution
  180.       hypergeometric_pdf -- PDF of the hypergeometric distribution
  181.       hypergeometric_rnd -- Random deviates from hypergeometric distribution
  182.  
  183.       kolmogorov_smirnov_cdf -- CDF of the Kolmogorov-Smirnov distribution
  184.  
  185.       laplace_cdf        -- CDF of the Laplace distribution
  186.       laplace_inv        -- Quantile function of the Laplace distribution
  187.       laplace_pdf        -- PDF of the Laplace distribution
  188.       laplace_rnd        -- Random deviates from the Laplace distribution
  189.  
  190.       logistic_cdf       -- CDF of the logistic distribution
  191.       logistic_inv       -- Quantile function of the logistic distribution
  192.       logistic_pdf       -- PDF of the logistic distribution
  193.       logistic_rnd       -- Random deviates from the logistic distribution
  194.  
  195.       lognormal_cdf      -- CDF of the log normal distribution
  196.       lognormal_inv      -- Quantile function of the log normal distribution
  197.       lognormal_pdf      -- PDF of the log normal distribution
  198.       lognormal_rnd      -- Random deviates from the log normal distribution
  199.  
  200.       normal_cdf         -- CDF of the normal distribution
  201.       normal_inv         -- Quantile function of the normal distribution
  202.       normal_pdf         -- PDF of the normal distribution
  203.       normal_rnd         -- Random deviates from the normal distribution
  204.  
  205.       pascal_cdf         -- CDF of the Pascal (negative binomial) distribution
  206.       pascal_inv         -- Quantile function of the Pascal distribution
  207.       pascal_pdf         -- PDF of the Pascal (negative binomial) distribution
  208.       pascal_rnd         -- Random deviates from the Pascal distribution
  209.  
  210.       poisson_cdf        -- CDF of the Poisson distribution
  211.       poisson_inv        -- Quantile function of the Poisson distribution
  212.       poisson_pdf        -- PDF of the Poisson distribution
  213.       poisson_rnd        -- Random deviates from the Poisson distribution
  214.  
  215.       stdnormal_cdf      -- CDF of the standard normal distribution
  216.       stdnormal_inv      -- Quantile function of standard normal distribution
  217.       stdnormal_pdf      -- PDF of the standard normal distribution
  218.       stdnormal_rnd      -- Random deviates from standard normal distribution
  219.  
  220.       t_cdf              -- CDF of the t distribution
  221.       t_inv              -- Quantile function of the t distribution
  222.       t_pdf              -- PDF of the t distribution
  223.       t_rnd              -- Random deviates from the t distribution
  224.  
  225.       uniform_cdf        -- CDF of the uniform distribution
  226.       uniform_inv        -- Quantile function of the uniform distribution
  227.       uniform_pdf        -- PDF of the uniform distribution
  228.       uniform_rnd        -- Random deviates from the uniform distribution
  229.  
  230.       weibull_cdf        -- CDF of the Weibull distribution
  231.       weibull_inv        -- Quantile function of the Weibull distribution
  232.       weibull_pdf        -- PDF of the Weibull distribution
  233.       weibull_rnd        -- Random deviates from the Weibull distribution
  234.  
  235.       wiener_rnd         -- Simulate a Wiener process
  236.  
  237.     In statistics/models (new directory):
  238.  
  239.       logistic_regression             -- ordinal logistic regression
  240.       logistic_regression_derivatives -- derivates of log-likelihood
  241.                                          in logistic regression
  242.       logistic_regression_likelihood  -- likelihood in logistic regression
  243.  
  244.     In statistics/tests (new directory):
  245.  
  246.       anova                       -- one-way analysis of variance
  247.       bartlett_test               -- bartlett test for homogeneity of variances
  248.       chisquare_test_homogeneity  -- chi-square test for homogeneity
  249.       chisquare_test_independence -- chi-square test for independence
  250.       cor_test                    -- test for zero correlation
  251.       f_test_regression           -- test linear hypotheses in linear
  252.                                      regression model
  253.       hotelling_test              -- test for mean of a multivariate normal
  254.       hotelling_test_2            -- compare means of two multivariate normals
  255.       kolmogorov_smirnov_test     -- one-sample Kolmogorov-Smirnov test
  256.       kolmogorov_smirnov_test_2   -- two-sample Kolmogorov-Smirnov test
  257.       kruskal_wallis_test         -- kruskal-Wallis test
  258.       manova                      -- one-way multivariate analysis of variance
  259.       mcnemar_test                -- mcnemar's test for symmetry
  260.       prop_test_2                 -- compare two proportions
  261.       run_test                    -- run test for independence
  262.       sign_test                   -- sign test
  263.       t_test                      -- student's one-sample t test 
  264.       t_test_2                    -- student's two-sample t test
  265.       t_test_regression           -- test one linear hypothesis in linear
  266.                                      regression model
  267.       u_test                      -- mann-Whitney U-test
  268.       var_test                    -- f test to compare two variances
  269.       welch_test                  -- welch two-sample t test
  270.       wilcoxon_test               -- wilcoxon signed-rank test
  271.       z_test                      -- test for mean of a normal sample with
  272.                                      known variance
  273.       z_test_2                    -- compare means of two normal samples with
  274.                                      known variances
  275.  
  276.   * The save command now accepts the option -append to save the
  277.     variables at the end of the file, leaving the existing contents.
  278.  
  279.   * New command-line option --no-history (also available using the
  280.     single character option -H) inhibits saving command history.
  281.  
  282.   * The mkoctfile script now accepts -DDEF options and passes them on
  283.     to the C and C++ compilers.
  284.  
  285.   * Running `make check' should work now before you run `make install', 
  286.     even if you build a copy of Octave that depends on shared versions
  287.     of the Octave libraries.
  288.  
  289.   * For matrices, x(:) now works no matter what the value of
  290.     do_fortran_indexing is.
  291.  
  292.   * New keywords __FILE__ and __LINE__ expand to the name of the file
  293.     that is being read and the current input line number, respectively.
  294.  
  295.   * Octave's expression parser is more general and consistent.  It is
  296.     now possible to access structure elements and index arbitrary
  297.     values.  For example, expressions like
  298.  
  299.       my_home_dir = getpwuid (getuid ()) . dir;
  300.  
  301.     and
  302.  
  303.       svd (x) (1:5)
  304.  
  305.     now work.
  306.  
  307.   * New built-in variable `print_rhs_assign_val' controls what is
  308.     printed when an assignment expression is evaluated.  If it is
  309.     zero, the value of the variable on the left hand side (after the
  310.     assignment) is printed.  If it is nonzero, the value of the right
  311.     hand side (i.e., the result of the expression) is printed.  The
  312.     default value of is zero, so the behavior is the same as in
  313.     previous versions of Octave.
  314.  
  315.   * tmpnam now takes two optional arguments, DIR, and PREFIX.  For
  316.     example, tmpnam ("/foo", "bar-") returns a file name like
  317.     "/foo/bar-10773baa".  If DIR is omitted or empty, the value of the
  318.     environment variable TMPDIR, or /tmp is used.  If PREFIX is 
  319.     omitted, "oct-" is used.
  320.  
  321.   * The built-in variable `PWD' has been removed.  If you need to get
  322.     the value of the current working directory, use the pwd() function
  323.     instead.
  324.  
  325.   * New operators.  Octave's parser now recognizes the following
  326.     operators:  << >> += -= *= /= .+= .-= .*= ./= &= |= <<= >>=.  So
  327.     far, there are only a few operations defined that actually use
  328.     them (this should change before 2.1 is released).
  329.  
  330.   * New built-in data types:
  331.  
  332.     logical:
  333.  
  334.       A true value is represented by 1, and false value by 0.
  335.       Comparison operations like <, <=, ==, >, >=, and != now return
  336.       logical values.  Indexing operations that use zero-one style
  337.       indexing must now use logical values.  You can use the new
  338.       function logical() to convert a numeric value to a logical
  339.       value.  This avoids the need for the built-in variable
  340.       `prefer_zero_one_indexing', so it has been removed.  Logical
  341.       values are automatically converted to numeric values where
  342.       appropriate.
  343.  
  344.     file:
  345.  
  346.       A file object represents an open Octave stream object.  The
  347.       fopen function now returns a file object instead of an integer.
  348.       File objects can be converted to integers automatically, and the
  349.       other functions that work with file ids still work with
  350.       integers, so this change should be backward compatible.
  351.  
  352.       The binary left-shift operator `<<' has been defined to work as
  353.       in C++ for file objects and built-in types.  For example,
  354.  
  355.         my_stream = fopen ("foo", "w");
  356.         my_stream << "x = " << pi << " marks the spot\n";
  357.  
  358.       writes `x = 3.1416 marks the spot' in the file foo.
  359.  
  360.       The built-in variables stdin, stdout, and stderr are now also
  361.       file objects instead of integers.
  362.  
  363.     list:
  364.  
  365.       A list is an array of Octave objects.  It can be indexed using
  366.       the normal indexing operator.  For example,
  367.  
  368.         x = list ([1,2;3,4], 1, "foo");
  369.         stdout << x(2) << "\n"
  370.         1
  371.         stdout << x;
  372.         (
  373.          [1] =
  374.         
  375.            1  2
  376.            3  4
  377.         
  378.           [2] = 1
  379.           [3] = foo
  380.         )
  381.  
  382.       There is currently no special syntax for creating lists; you
  383.       must use the list function.
  384.  
  385.   * Commas in global statements are no longer special.  They are now
  386.     treated as command separators.  This removes a conflict in the
  387.     grammar and is consistent with the way Matlab behaves.  The
  388.     variable `warn_comma_in_global_decl' has been eliminated.
  389.  
  390.   * It is now possible to declare static variables that retain their
  391.     values across function calls.  For example,
  392.  
  393.       function ncall = f () static n = 0; ncall = ++n; endfunction
  394.  
  395.     defines a function that returns the number of times that it has
  396.     been called.
  397.  
  398.   * Within user-defined functions, the new automatic variable `argn'
  399.     contains the names of the arguments that were passed to the
  400.     function.  For example,
  401.  
  402.       function f (...)
  403.         for i = 1:nargin
  404.           stdout << "argn(" << i << ") = `" << deblank (argn(i,:)) \
  405.                  << "' and its value is " << va_arg () << "\n";
  406.         endfor
  407.       endfunction
  408.       f (1+2, "foo", sin (pi/2))
  409.  
  410.     prints
  411.  
  412.       argn(1) = `1 + 2' and its value is 3
  413.       argn(2) = `"foo"' and its value is foo
  414.       argn(3) = `sin (pi)' and its value is 1
  415.  
  416.     on the standard output stream.  If nargin is zero, argn is not defined.
  417.   * Functions like quad, fsolve, and lsode can take either a function
  418.     name or a simple function body as a string.  For example,
  419.  
  420.       quad ("sqrt (x)", 0, 1)
  421.  
  422.     is equivalent to
  423.  
  424.       function y = f (x) y = sqrt (x); endfunction
  425.       quad ("f", 0, 1)
  426.  
  427.   * If the argument to eig() is symmetric, Octave uses the specialized
  428.     Lapack subroutine for symmetric matrices for a significant
  429.     increase in performance.
  430.  
  431.   * If the argument to lsode that names the user-supplied function is
  432.     a 2-element string array, the second element is taken as the name
  433.     of the Jacobian function.  The named function should have the
  434.     following form:
  435.  
  436.       JAC = f (X, T)
  437.  
  438.     where JAC is the Jacobian matrix of partial derivatives of the
  439.     right-hand-side functions that define the set of differential
  440.     equations with respect to the state vector X.
  441.  
  442.   * Global variables are now initialized to the empty matrix, for
  443.     compatibility with Matlab.
  444.  
  445.   * Explicit initialization of global variables only happens once.
  446.     For example, after the following statements are evaluated, g still
  447.     has the value 1.
  448.  
  449.       global g = 1
  450.       global g = 2
  451.  
  452.     This is useful for initializing global variables that are used to
  453.     maintain state information that is shared among several functions.
  454.  
  455.   * Structure elements completion on the command line actually works
  456.     now.
  457.  
  458.   * The new built-in variable `fixed_point_format' controls whether
  459.     Octave uses a scaled fixed-point format for displaying matrices.
  460.     The default value is 0 unless you use --traditional.
  461.  
  462.   * The function sumsq now computes sum (x .* conj (x)) for complex values.
  463.  
  464.   * The new built-in variable max_recursion_depth allows you to
  465.     prevent Octave from attempting infinite recursion.  The default
  466.     value is 256.
  467.  
  468.   * Octave now uses kpathsea 3.2.
  469.  
  470.   * New configure option, --enable-readline.
  471.  
  472.   * New configure option, --enable-static.
  473.  
  474. Summary of changes for version 2.0.7:
  475. ------------------------------------
  476.  
  477.   This is a bug-fixing release.  There are no new user-visible features.
  478.  
  479. Summary of changes for version 2.0.6:
  480. ------------------------------------
  481.  
  482.   This is primarily a bug-fixing release.  There are only a few new
  483.   user-visible features.
  484.  
  485.   * The new built-in variable default_eval_print_flag controls whether
  486.     Octave prints the results of commands executed by eval() that do
  487.     not end with semicolons.  The default is 1.
  488.  
  489.   * The new built-in constant OCTAVE_HOME specifies the top-level
  490.     directory where Octave is installed.
  491.  
  492.   * Octave no longer includes functions to work with NPSOL or QPSOL,
  493.     because they are not free software.
  494.  
  495.   * The new built-in variable called kluge_procbuf_delay specifies the
  496.     number of microseconds to delay in the parent process after
  497.     forking.  By default on gnu-win32 systems, it's set to 500000 (1/2
  498.     second).  On other systems, the default value is 0.  Delaying for
  499.     a short time in the parent after forking seems to avoid problems
  500.     in which communicating with subprocesses via pipes would sometimes
  501.     cause Octave to hang.  I doubt that the delay is really the right
  502.     solution.  If anyone has a better idea, I'd love to hear it.
  503.  
  504. Summary of changes for version 2.0.5:
  505. ------------------------------------
  506.  
  507.   * A `switch' statement is now available.  See the Statements chapter
  508.     in the manual for details.
  509.  
  510.   * Commands like ls, save, and cd may now also be used as formal
  511.     parameters for functions.
  512.  
  513.   * More tests.
  514.  
  515. Summary of changes for version 2.0.4:
  516. ------------------------------------
  517.  
  518.   * It is now possible to use commands like ls, save, and cd as simple
  519.     variable names.  They still cannot be used as formal parameters
  520.     for functions, or as the names of structure variables.  Failed
  521.     assignments leave them undefined (you can recover the orginal
  522.     function definition using clear).
  523.  
  524.   * Is is now possible to invoke commands like ls, save, and cd as
  525.     normal functions (for example, load ("foo", "x", "y", "z")).
  526.  
  527. Summary of changes for version 2.0.3:
  528. ------------------------------------
  529.  
  530.   * The manual has been completely revised and now corresponds much
  531.     more closely to the features of the current version.
  532.  
  533.   * The return value for assignment expressions is now the RHS since
  534.     that is more consistent with the way other programming languages
  535.     work.  However, Octave still prints the entire LHS value so that
  536.  
  537.       x = zeros (1, 2);
  538.       x(2) = 1
  539.  
  540.     still prints
  541.  
  542.       x =
  543.  
  544.         0  1
  545.  
  546.     but an assignment like
  547.  
  548.       z = x(2) = 1
  549.  
  550.     sets z to 1 (not [ 0, 1 ] as in previous versions of Octave).
  551.  
  552.   * It is now much easier to make binary distributions.  See the
  553.     Binary Distributions section of the manual for more details.
  554.  
  555. Summary of changes for version 2.0.2:
  556. ------------------------------------
  557.  
  558.   * Octave now stops executing commands from a script file if an error
  559.     is encountered.
  560.  
  561.   * The return, and break commands now cause Octave to quit executing
  562.     commands from script files.  When used in invalid contexts, the
  563.     break, continue, and return commands are now simply ignored
  564.     instead of producing parse errors.
  565.  
  566.   * size ("") is now [0, 0].
  567.  
  568.   * New functions:
  569.  
  570.       sleep   -- pause execution for a specified number of seconds
  571.       usleep  -- pause execution for a specified number of microseconds
  572.  
  573. Summary of changes for version 2.0:
  574. ----------------------------------
  575.  
  576.   * The set and show commands for setting and displaying gnuplot
  577.     parameters have been replaced by gset and gshow.  This change will
  578.     probably break lots of things, but it is necessary to allow for
  579.     compatibility with the Matlab graphics and GUI commands in a
  580.     future version of Octave.  (For now, the old set and show commands
  581.     do work, but they print an annoying warning message to try to get
  582.     people to switch to using gset.)
  583.  
  584.   * Octave has been mostly ported to Windows NT and Windows 95 using
  585.     the beta 17 release of the Cygnus GNU-WIN32 tools.  Not everything
  586.     works, but it is usable.  See the file README.WINDOWS for more
  587.     information.
  588.  
  589.   * Dynamic linking works on more systems using dlopen() and friends
  590.     (most modern Unix systems) or shl_load() and friends (HP/UX
  591.     systems).  A simple example is provided in examples/hello.cc.
  592.     For this feature to work, you must configure Octave with
  593.     --enable-shared.  You may also need to have a shared-library
  594.     version of libg++ and libstdc++.
  595.  
  596.   * New data types can be added to Octave by writing a C++ class.  On
  597.     systems that support dynamic linking, new data types can be added
  598.     to an already running Octave binary.  A simple example appears in
  599.     the file examples/make_int.cc.  Other examples are the standard
  600.     Octave data types defined in the files src/ov*.{h,cc} and
  601.     src/op-*.cc.
  602.  
  603.   * The configure option --enable-bounds-check turns on bounds
  604.     checking on element references for Octave's internal array and
  605.     matrix classes.  It's enabled by default.  To disable this
  606.     feature, configure Octave with --disable-bounds-check.
  607.  
  608.   * The C-style I/O functions (fopen, fprintf, etc.) have been
  609.     rewritten to be more compatible with Matlab.  The fputs function
  610.     has also been added.  Usage of the *printf functions that was
  611.     allowed in previous versions of Octave should still work.
  612.     However, there is no way to make the new versions of the *scanf
  613.     functions compatible with Matlab *and* previous versions of
  614.     Octave.  An optional argument to the *scanf functions is now
  615.     available to make them behave in a way that is compatible with
  616.     previous versions of Octave.
  617.  
  618.   * Octave can now read files that contain columns of numbers only,
  619.     with no header information.  The name of the loaded variable is
  620.     constructed from the file name.  Each line in the file must have
  621.     the same number of elements.
  622.  
  623.   * The interface to the pager has changed.  The new built-in variable
  624.     `page_output_immediately' controls when Octave sends output to the
  625.     pager.  If it is nonzero, Octave sends output to the pager as soon
  626.     as it is available.  Otherwise, Octave buffers its output and
  627.     waits until just before the prompt is printed to flush it to the
  628.     pager.
  629.  
  630.   * Expressions of the form
  631.  
  632.       A(i,j) = x
  633.  
  634.     where X is a scalar and the indices i and j define a matrix of
  635.     elements now work as you would expect rather than giving an error.
  636.     I am told that this is how Matlab 5.0 will behave when it is
  637.     released.
  638.  
  639.   * Indexing of character strings now works.
  640.  
  641.   * The echo command has been implemented.
  642.  
  643.   * The document command is now a regular function.
  644.  
  645.   * New method for handling errors:
  646.  
  647.       try
  648.         BODY
  649.       catch
  650.         CLEANUP
  651.       end_try_catch
  652.  
  653.     Where BODY and CLEANUP are both optional and may contain any
  654.     Octave expressions or commands.  The statements in CLEANUP are
  655.     only executed if an error occurs in BODY.
  656.  
  657.     No warnings or error messages are printed while BODY is
  658.     executing.  If an error does occur during the execution of BODY,
  659.     CLEANUP can access the text of the message that would have been
  660.     printed in the builtin constant __error_text__.  This is the same
  661.     as eval (TRY, CATCH) (which may now also use __error_text__) but
  662.     it is more efficient since the commands do not need to be parsed
  663.     each time the TRY and CATCH statements are evaluated.
  664.  
  665.   * Octave no longer parses the help command by grabbing everything
  666.     after the keyword `help' until a newline character is read.  To
  667.     get help for `;' or `,', now, you need to use the command
  668.     `help semicolon' or `help comma'.
  669.  
  670.   * Octave's parser now does some simple constant folding.  This means
  671.     that expressions like 3*i are now evaluated only once, when a
  672.     function is compiled, and the right hand side of expressions like
  673.     a = [1,2;3,4] are treated as true matrix constants rather than
  674.     lists of elements which must be evaluated each time they are
  675.     needed.
  676.  
  677.   * Built-in variables that can take values of "true" and "false" can
  678.     now also be set to any nonzero scalar value to indicate "true",
  679.     and 0 to indicate "false".
  680.  
  681.   * New built-in variables `history_file', `history_size', and
  682.     `saving_history'.
  683.  
  684.   * New built-in variable `string_fill_char' specifies the character
  685.     to fill with when creating arrays of strings.
  686.  
  687.   * If the new built-in variable `gnuplot_has_frames' is nonzero,
  688.     Octave assumes that your copy of gnuplot includes support for
  689.     multiple plot windows when using X11.
  690.  
  691.     If the new built-in variable `gnuplot_has_multiplot' is nonzero,
  692.     Octave assumes that your copy of gnuplot has the multiplot support
  693.     that is included in recent 3.6beta releases.
  694.  
  695.     The initial values of these variables are determined by configure,
  696.     but can be changed in your startup script or at the command line
  697.     in case configure got it wrong, or if you upgrade your gnuplot
  698.     installation.
  699.  
  700.   * The new plot function `figure' allows multiple plot windows when
  701.     using newer versions of gnuplot with X11.
  702.  
  703.   * Octave now notices when the plotter has exited unexpectedly.
  704.  
  705.   * New built-in variable `warn_missing_semicolon'.  If nonzero, Octave
  706.     will warn when statements in function definitions don't end in
  707.     semicolons.  The default value is 0.
  708.  
  709.   * Octave now attempts to continue after floating point exceptions
  710.     or out-of-memory errors.
  711.  
  712.   * If Octave crashes, it now attempts to save all user-defined
  713.     variables in a file named `octave-core' in the current directory
  714.     before exiting.
  715.  
  716.   * It is now possible to get the values of individual option settings
  717.     for the dassl, fsolve, lsode, npsol, qpsol, and quad functions
  718.     using commands like
  719.  
  720.       dassl_reltol = dassl_options ("relative tolerance");
  721.  
  722.   * The svd() function no longer computes the left and right singular
  723.     matrices unnecessarily.  This can significantly improve
  724.     performance for large matrices if you are just looking for the  
  725.     singular values.
  726.  
  727.   * The filter() function is now a built-in function.
  728.  
  729.   * New function randn() returns a pseudo-random number from a normal
  730.     distribution.  The rand() and randn() functions have separate
  731.     seeds and generators.
  732.  
  733.   * Octave's command-line arguments are now available in the built-in
  734.     variable `argv'.  The program name is also available in the
  735.     variables `program_invocation_name' and `program_name'.  If
  736.     executing a script from the command line (e.g., octave foo.m) or
  737.     using the `#! /bin/octave' hack, the program name is set to the
  738.     name of the script.
  739.  
  740.   * New built-in variable `completion_append_char' used as the
  741.     character to append to successful command-line completion
  742.     attempts.  The default is " " (a single space).
  743.  
  744.   * Octave now uses a modified copy of the readline library from
  745.     version 1.14.5 of GNU bash.
  746.  
  747.   * In prompt strings, `\H' expands to the whole host name.
  748.  
  749.   * New built-in variable `beep_on_error'.  If nonzero, Octave will try
  750.     to ring your terminal's bell before printing an error message.
  751.     The default value is 0.
  752.  
  753.   * For functions defined from files, the type command now prints the
  754.     text of the file.  You can still get the text reconstructed from
  755.     the parse tree by using the new option -t (-transformed).
  756.  
  757.   * New command-line argument --traditional sets the following
  758.     preference variables for compatibility with Matlab:
  759.  
  760.       PS1                           = ">> "
  761.       PS2                           = ""
  762.       beep_on_error                 = 1
  763.       default_save_format           = "mat-binary"
  764.       define_all_return_values      = 1
  765.       do_fortran_indexing           = 1
  766.       empty_list_elements_ok        = 1
  767.       implicit_str_to_num_ok        = 1
  768.       ok_to_lose_imaginary_part     = 1
  769.       page_screen_output            = 0
  770.       prefer_column_vectors         = 0
  771.       prefer_zero_one_indexing      = 1
  772.       print_empty_dimensions        = 0
  773.       treat_neg_dim_as_zero         = 1
  774.       warn_function_name_clash      = 0
  775.       whitespace_in_literal_matrix  = "traditional"
  776.  
  777.   * New functions:
  778.  
  779.       readdir  -- returns names of files in directory as array of strings
  780.       mkdir    -- create a directory
  781.       rmdir    -- remove a directory
  782.       rename   -- rename a file
  783.       unlink   -- delete a file
  784.       umask    -- set permission mask for file creation
  785.       stat     -- get information about a file
  786.       lstat    -- get information about a symbolic link
  787.       glob     -- perform filename globbing
  788.       fnmatch  -- match strings with filename globbing patterns
  789.       more     -- turn the pager on or off
  790.       gammaln  -- alias for lgamma
  791.  
  792.   * New audio functions from Andreas Weingessel
  793.     <Andreas.Weingessel@ci.tuwien.ac.at>.
  794.  
  795.       lin2mu     -- linear to mu-law encoding
  796.       loadaudio  -- load an audio file to a vector
  797.       mu2lin     -- mu-law to linear encoding
  798.       playaudio  -- play an audio file
  799.       record     -- record sound and store in vector
  800.       saveaudio  -- save a vector as an audio file
  801.       setaudio   -- executes mixer shell command
  802.  
  803.   * New plotting functions from Vinayak Dutt.  Ones dealing with
  804.     multiple plots on one page require features from gnuplot 3.6beta
  805.     (or later).
  806.  
  807.       bottom_title  -- put title at the bottom of the plot
  808.       mplot         -- multiplot version of plot
  809.       multiplot     -- switch multiple-plot mode on or off
  810.       oneplot       -- return to one plot per page
  811.       plot_border   -- put a border around plots
  812.       subplot       -- position multiple plots on a single page
  813.       subwindow     -- set subwindow position for next plot
  814.       top_title     -- put title at the top of the plot
  815.       zlabel        -- put a label on the z-axis
  816.  
  817.   * New string functions
  818.  
  819.       bin2dec  -- convert a string of ones and zeros to an integer
  820.       blanks   -- create a string of blanks
  821.       deblank  -- delete trailing blanks
  822.       dec2bin  -- convert an integer to a string of ones and zeros
  823.       dec2hex  -- convert an integer to a hexadecimal string
  824.       findstr  -- locate occurrences of one string in another
  825.       hex2dec  -- convert a hexadecimal string to an integer
  826.       index    -- return position of first occurrence a string in another
  827.       rindex   -- return position of last occurrence a string in another
  828.       split    -- divide one string into pieces separated by another
  829.       str2mat  -- create a string matrix from a list of strings
  830.       strrep   -- replace substrings in a string
  831.       substr   -- extract a substring
  832.  
  833.     The following functions return a matrix of ones and zeros.
  834.     Elements that are nonzero indicate that the condition was true for
  835.     the corresponding character in the string array.
  836.  
  837.       isalnum   -- letter or a digit
  838.       isalpha   -- letter
  839.       isascii   -- ascii
  840.       iscntrl   -- control character
  841.       isdigit   -- digit
  842.       isgraph   -- printable (but not space character)
  843.       islower   -- lower case
  844.       isprint   -- printable (including space character)
  845.       ispunct   -- punctuation
  846.       isspace   -- whitespace
  847.       isupper   -- upper case
  848.       isxdigit  -- hexadecimal digit
  849.  
  850.     These functions return new strings.
  851.  
  852.       tolower  -- convert to lower case
  853.       toupper  -- convert to upper case
  854.  
  855.   * New function, fgetl.  Both fgetl and fgets accept an optional
  856.     second argument that specifies a maximum number of characters to
  857.     read, and the function fgets is now compatible with Matlab.
  858.  
  859.   * Printing in hexadecimal format now works (format hex).  It is also
  860.     possible to print the internal bit representation of a value
  861.     (format bit).  Note that these formats are only implemented for
  862.     numeric values.
  863.  
  864.   * Additional structure features:
  865.  
  866.     -- Name completion now works for structures.
  867.  
  868.     -- Values and names of structure elements are now printed by
  869.        default.  The new built-in variable `struct_levels_to_print'
  870.        controls the depth of nested structures to print.  The default
  871.        value is 2.
  872.  
  873.     -- New functions:
  874.  
  875.        struct_contains (S, NAME) -- returns 1 if S is a structure with
  876.                                     element NAME; otherwise returns 0.
  877.  
  878.        struct_elements (S)       -- returns the names of all elements
  879.                                     of structure S in an array of strings. 
  880.  
  881.   * New io/subprocess functions:
  882.  
  883.       fputs    -- write a string to a file with no formatting
  884.       popen2   -- start a subprocess with 2-way communication
  885.       mkfifo   -- create a FIFO special file
  886.       popen    -- open a pipe to a subprocess
  887.       pclose   -- close a pipe from a subprocess
  888.       waitpid  -- check the status of or wait for subprocesses
  889.  
  890.   * New time functions:
  891.  
  892.       asctime    -- format time structure according to local format
  893.       ctime      -- equivalent to `asctime (localtime (TMSTRUCT))'
  894.       gmtime     -- return time structure corresponding to UTC
  895.       localtime  -- return time structure corresponding to local time zone
  896.       strftime   -- print given time structure using specified format
  897.       time       -- return current time
  898.  
  899.     The `clock' and `date' functions are now implemented in M-files
  900.     using these basic functions.
  901.  
  902.   * Access to additional Unix system calls:
  903.  
  904.       dup2     -- duplicate a file descriptor
  905.       exec     -- replace current process with a new process
  906.       fcntl    -- control open file descriptors
  907.       fork     -- create a copy of the current process
  908.       getpgrp  -- return the process group id of the current process
  909.       getpid   -- return the process id of the current process
  910.       getppid  -- return the process id of the parent process
  911.       getuid   -- return the real user id of the current process
  912.       getgid   -- return the real group id of the current process
  913.       geteuid  -- return the effective user id of the current process
  914.       getegid  -- return the effective group id of the current process
  915.       pipe     -- create an interprocess channel
  916.  
  917.   * Other new functions:
  918.  
  919.       commutation_matrix  -- compute special matrix form
  920.       duplication_matrix  -- compute special matrix form
  921.       common_size.m       -- bring arguments to a common size
  922.       completion_matches  -- perform command completion on string
  923.       tilde_expand        -- perform tilde expansion on string
  924.  
  925.       meshgrid  -- compatible with Matlab's meshgrid function
  926.       tmpnam    -- replaces octave_tmp_file_name
  927.       atexit    -- register functions to be called when Octave exits
  928.       putenv    -- define an environment variable
  929.       bincoeff  -- compute binomial coefficients
  930.       nextpow2  -- compute the next power of 2 greater than a number
  931.       detrend   -- remove a best fit polynomial from data
  932.       erfinv    -- inverse error function
  933.       shift     -- perform a circular shift on the elements of a matrix
  934.       pow2      -- compute 2 .^ x
  935.       log2      -- compute base 2 logarithms
  936.       diff      -- compute differences of matrix elements
  937.       vech      -- stack columns of a matrix below the diagonal
  938.       vec       -- stack columns of a matrix to form a vector
  939.       xor       -- compute exclusive or
  940.  
  941.   * Functions for getting info from the password database on Unix systems:
  942.  
  943.       getpwent  -- read entry from password-file stream, opening if necessary
  944.       getpwuid  -- search for password entry with matching user ID
  945.       getpwnam  -- search for password entry with matching username
  946.       setpwent  -- rewind the password-file stream
  947.       endpwent  -- close the password-file stream
  948.  
  949.   * Functions for getting info from the group database on Unix systems:
  950.  
  951.       getgrent  -- read entry from group-file stream, opening if necessary
  952.       getgrgid  -- search for group entry with matching group ID
  953.       getgrnam  -- search for group entry with matching group name
  954.       setgrent  -- rewind the pgroup-file stream
  955.       endgrent  -- close the group-file stream
  956.  
  957.   * The New function octave_config_info returns a structure containing
  958.     information about how Octave was configured and compiled.
  959.  
  960.   * New function getrusage returns a structure containing system
  961.     resource usage statistics.  The `cputime' function is now defined
  962.     in an M-file using getrusage.
  963.  
  964.   * The info reader is now a separate binary that runs as a
  965.     subprocess.  You still need the info reader distributed with
  966.     Octave though, because there are some new command-line arguments
  967.     that are not yet available in the public release of Info.
  968.  
  969.   * There is a new built-in variable, INFO_PROGRAM, which is used as
  970.     the name of the info program to run.  Its initial value is
  971.     $OCTAVE_HOME/lib/octave/VERSION/exec/ARCH/info, but that value can
  972.     be overridden by the environment variable OCTAVE_INFO_PROGRAM, or
  973.     the command line argument --info-program NAME, or by setting the
  974.     value of INFO_PROGRAM in a startup script.
  975.  
  976.   * There is a new built-in variable, EXEC_PATH, which is used as
  977.     the list of directories to search when executing subprograms.  Its
  978.     initial value is taken from the environment variable
  979.     OCTAVE_EXEC_PATH (if it exists) or PATH, but that value can be
  980.     overridden by the the command line argument --exec-path PATH, or
  981.     by setting the value of EXEC_PATH in a startup script.  If the
  982.     EXEC_PATH begins (ends) with a colon, the directories
  983.     $OCTAVE_HOME/lib/octave/VERSION/exec/ARCH and $OCTAVE_HOME/bin are
  984.     prepended (appended) to EXEC_PATH (if you don't specify a value
  985.     for EXEC_PATH explicitly, these special directories are prepended
  986.     to your PATH).
  987.  
  988.   * If it is present, Octave will now use an `ls-R' database file to
  989.     speed up recursive path searching.  Octave looks for a file called
  990.     ls-R in the directory specified by the environment variable
  991.     OCTAVE_DB_DIR.  If that is not set but the environment variable
  992.     OCTAVE_HOME is set, Octave looks in $OCTAVE_HOME/lib/octave.
  993.     Otherwise, Octave looks in the directory $datadir/octave (normally
  994.     /usr/local/lib/octave).
  995.  
  996.   * New examples directory.
  997.  
  998.   * There is a new script, mkoctfile, that can be used to create .oct
  999.     files suitable for dynamic linking.
  1000.  
  1001.   * Many more bug fixes.
  1002.  
  1003.   * ChangeLogs are now kept in each subdirectory.
  1004.  
  1005. See NEWS.1 for old news.
  1006.