annotate README.devel @ 5301:9302581b820d ss-2-9-2

[project @ 2005-04-22 17:08:07 by jwe]
author jwe
date Fri, 22 Apr 2005 17:09:11 +0000
parents b2ce28713791
children 5eb3db6e4042
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
be1b26b99caa [project @ 1997-06-05 07:34:53 by jwe]
jwe
parents:
diff changeset
42 Department of Chemical Engineering
3032
564e3c213cff [project @ 1997-06-05 07:35:11 by jwe]
jwe
parents: 3031
diff changeset
43
5041
b2ce28713791 [project @ 2004-10-01 18:12:10 by jwe]
jwe
parents: 3032
diff changeset
44 Fri Oct 1 13:04:00 2004