annotate README.devel @ 10843:229675bb7647 ss-3-3-52

version is now 3.3.52
author John W. Eaton <jwe@octave.org>
date Sun, 01 Aug 2010 11:49:45 -0400
parents f7d8b2bd7b57
children bce5b7c1a20a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
10495
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
1 This directory contains development releases of Octave.
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
2
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
3 If you want a stable, well-tested version of Octave, you should be
10495
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
4 looking at ftp://ftp.gnu.org/gnu/octave.
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
5
10495
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
6 Development releases are provided for people who want to help test,
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
7 debug, and improve Octave. Very little testing is done before making
10495
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
8 the development releases and they may even be made when Octave is in
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
9 an inconsistent state. It is possible that you will encounter a
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
10 very obvious bug, such as failure to compile on *any* machine. It is
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
11 likely that such bugs will be fixed by the next development release,
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
12 so it really isn't necessary to report them unless they persist over
10495
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
13 more than one release.
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
14
10495
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
15 Please DO report other bugs in the development releases as soon as you
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
16 find them by sending a message to octave-maintainers@octave.org (but
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
17 first read the bug reporting guidelines provided at
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
18 http://www.gnu.org/software/octave/bugs.html).
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
19
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
20 If you have a fix for a bug, or an enhancement to submit, send your
10495
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
21 patch to octave-maintainers@octave.org. Here are some simple
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
22 guidelines for submitting patches:
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
23
10495
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
24 o Use "context diffs" for patches. A typical command for generating
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
25 context diffs is "diff -rc octave-old octave-new". If you are
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
26 using the Mercurial sources a patch generated with "hg export" is
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
27 preferred.
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
28
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
29 o Use the "minimalist approach" for patches. That is, each patch
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
30 should address only one particular bug, new feature, etc. Do not
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
31 save up many unrelated changes and submit them all in one big
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
32 patch, since in general, the larger the patch the more difficult
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
33 it is for me to decide if the patch is either correct or
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
34 desirable.
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
35
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
36 o Submit a sample ChangeLog entry with your patch. See the
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
37 existing Octave ChangeLog for examples of what a ChangeLog entry
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
38 should look like.
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
39
10495
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
40 If you would like to be on the very sharpest part of the bleeding
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
41 edge, you can now use Mercurial to access Octave's current development
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
42 sources. Instructions for checking out a copy are available on the
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
43 web at http://www.gnu.org/software/octave/download.html.
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
44
10495
f7d8b2bd7b57 README.ftp and README.devel updates
John W. Eaton <jwe@octave.org>
parents: 9322
diff changeset
45 Last updated: Wed, 07 Apr 2010 15:14:50 EDT