annotate README.devel @ 7948:af10baa63915 ss-3-1-50

3.1.50 snapshot
author John W. Eaton <jwe@octave.org>
date Fri, 18 Jul 2008 17:42:48 -0400
parents 5eb3db6e4042
children 66fdc831c580
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5041
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
1 This directory contains development snapshots 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
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
4 looking at ftp://ftp.che.wisc.edu/pub/octave.
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
5
5041
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
6 Development snapshots 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
5041
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
8 the development snapshots and they may even be made when Octave is in
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
9 an inconsistent state. It is possible that you will encounter a very
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
10 obvious bug, such as failure to compile on *any* machine. It is
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
11 likely that such bugs will be fixed by the next development snapshot,
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
5041
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
13 more than one snapshot.
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
14
5041
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
15 Please DO report other bugs in the development snapshots as soon as you
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
16 find them by sending a message to maintainers@octave.org.
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
17
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
18 If you have a fix for a bug, or an enhancement to submit, send your
5041
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
19 patch to maintainers@octave.org. Here are some simple
3031
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
20 guidelines for submitting patches:
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
21
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
22 o Use "context diffs" for patches. A typical command for
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
23 generating context diffs is "diff -rc octave-old octave-new".
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
24
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
25 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
26 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
27 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
28 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
29 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
30 desirable.
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
31
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
32 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
33 existing Octave ChangeLog for examples of what a ChangeLog entry
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
34 should look like.
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
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
37 Thanks,
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
38
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
39 John W. Eaton
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
40 jwe@bevo.che.wisc.edu
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
41 University of Wisconsin-Madison
7088
5eb3db6e4042 [project @ 2007-10-31 20:35:10 by jwe]
jwe
parents: 5041
diff changeset
42 Department of Chemical & Biological Engineering
3032
564e3c213cff [project @ 1997-06-05 07:35:11 by jwe]
jwe
parents: 3031
diff changeset
43
7088
5eb3db6e4042 [project @ 2007-10-31 20:35:10 by jwe]
jwe
parents: 5041
diff changeset
44 Last updated: Wed, 31 Oct 2007 16:33:55 EDT