Re: Release schedule for 3.4.1

[John W. Eaton]

On 25-May-2011, Rik wrote:

| I dealt with two of the items that were on the task list.  This still
| leaves the original three that you had added.

Sorry for the delay in dealing with these problems.  I have a fix for
the library version problem and I've also edited the NEWS file.
Patches for both are attached below.  I can't check them in at the
moment because I can't connect to savannah.  I'll try to look at the
other two items tomorrow.

jwe

# HG changeset patch
# User John W. Eaton <address@hidden>
# Date 1307050500 14400
# Branch stable
# Node ID c4343a0c70544e14762a9f2096a307a0dc7deb21
# Parent  c9e1a2f8d7f8fb8a3f118b74e29256e03684d9be
maint: implement proper library versioning.

* libcruft/Makefile.am (libcruft_current): New variable.
(libcruft_revision): Likewise.
(libcruft_age): Likewise.
(libcruft_version_info): Likewise.
(libcruft_la_LDFLAGS): Use -version-info option, not -release.

* liboctave/Makefile.am (liboctave_current): New variable.
(liboctave_revision): Likewise.
(liboctave_age): Likewise.
(liboctave_version_info): Likewise.
(liboctave_la_LDFLAGS): Use -version-info option, not -release.

* liboctinterp/Makefile.am (liboctinterp_current): New variable.
(liboctinterp_revision): Likewise.
(liboctinterp_age): Likewise.
(liboctinterp_version_info): Likewise.
(liboctinterp_la_LDFLAGS): Use -version-info option, not -release.

diff --git a/libcruft/Makefile.am b/libcruft/Makefile.am
--- a/libcruft/Makefile.am
+++ b/libcruft/Makefile.am
@@ -34,8 +34,18 @@
   @CRUFT_DLL_DEFS@ \
   $(AM_CPPFLAGS)
 
+# Increment these as needed and according to the rules in the libtool
+# manual:
+libcruft_current = 0
+libcruft_revision = 0
+libcruft_age = 0
+
+libcruft_version_info = 
$(libcruft_current):$(libcruft_revision):$(libcruft_age)
+
 libcruft_la_LDFLAGS = \
-  -release $(version) $(NO_UNDEFINED_LDFLAG) @XTRA_CRUFT_SH_LDFLAGS@ \
+  -version-info $(libcruft_version_info) \
+  $(NO_UNDEFINED_LDFLAG) \
+  @XTRA_CRUFT_SH_LDFLAGS@ \
   -bindir $(bindir)
 
 libcruft_la_LIBADD = \
diff --git a/liboctave/Makefile.am b/liboctave/Makefile.am
--- a/liboctave/Makefile.am
+++ b/liboctave/Makefile.am
@@ -526,7 +526,17 @@
   $(ARPACK_CPPFLAGS) \
   $(AM_CPPFLAGS)
 
-liboctave_la_LDFLAGS = -release $(version) $(NO_UNDEFINED_LDFLAG) \
+# Increment these as needed and according to the rules in the libtool
+# manual:
+liboctave_current = 0
+liboctave_revision = 0
+liboctave_age = 0
+
+liboctave_version_info = 
$(liboctave_current):$(liboctave_revision):$(liboctave_age)
+
+liboctave_la_LDFLAGS = \
+  -version-info $(liboctave_version_info) \
+  $(NO_UNDEFINED_LDFLAG) \
   -bindir $(bindir) \
   $(SPARSE_XLDFLAGS) \
   $(ARPACK_LDFLAGS) \
diff --git a/src/Makefile.am b/src/Makefile.am
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -591,7 +591,17 @@
 
 liboctinterp_la_CPPFLAGS = @OCTINTERP_DLL_DEFS@ $(AM_CPPFLAGS)
 
-liboctinterp_la_LDFLAGS = -release $(version) $(NO_UNDEFINED_LDFLAG) \
+# Increment these as needed and according to the rules in the libtool
+# manual:
+liboctinterp_current = 0
+liboctinterp_revision = 0
+liboctinterp_age = 0
+
+liboctinterp_version_info = 
$(liboctinterp_current):$(liboctinterp_revision):$(liboctinterp_age)
+
+liboctinterp_la_LDFLAGS = \
+  -version-info $(liboctinterp_version_info) \
+  $(NO_UNDEFINED_LDFLAG) \
   -bindir $(bindir)
 
 CLEANFILES = \

# HG changeset patch
# Parent c4343a0c70544e14762a9f2096a307a0dc7deb21
# User John W. Eaton <address@hidden>
# Date 1307051091 14400
maint: update NEWS.

* NEWS: Edit in preparation for 3.4.1 release.

diff --git a/NEWS b/NEWS
--- a/NEWS
+++ b/NEWS
@@ -1,36 +1,44 @@
-Summary of important user-visible changes for version 3.6:
----------------------------------------------------------
+Summary of important user-visible changes for version 3.4.1:
+-----------------------------------------------------------
 
- ** The PCRE library is now required to build Octave.
+ ** Octave 3.4.1 is primarily a bug fixing release.
 
- ** New functions added.
+ ** IMPORTANT note about binary incompatibility in this release:
 
-    iscolumn
-    issrow
- 
- ** Deprecated functions.
+    The original goal was to ensure binary compatibility for all 3.4.x
+    releases but this is impossible for the 3.4.1 release due to a bug
+    in the way shared libraries were built in Octave 3.4.0.  Because of
+    this bug, .oct files built for Octave 3.4.0 must be recompiled
+    before they will work with Octave 3.4.1.
 
-    The following functions were deprecated in Octave 3.2 and have been
-    removed from Octave 3.6.
-                                           
-      create_set          spcholinv    splu   
-      dmult               spcumprod    spmax
-      iscommand           spcumsum     spmin
-      israwcommand        spdet        spprod
-      lchol               spdiag       spqr
-      loadimage           spfind       spsum
-      mark_as_command     sphcat       spsumsq
-      mark_as_rawcommand  spinv        spvcat 
-      spatan2             spkron       str2mat
-      spchol              splchol      unmark_command
-      spchol2inv          split        unmark_rawcommand
+    Given that there would be binary incompatibilities with shared
+    libraries going from Octave 3.4.0 to 3.4.1, we also made the
+    following incompatible changes in this release:
 
-    The following functions have been deprecated in Octave 3.6 and will
-    be removed from Octave 3.10 (or whatever version is the second major
-    release after 3.6):
+      * The Perl Compatible Regular Expression (PCRE) library is now
+        required to build Octave.
 
-      is_duplicate_entry
-      
+    Any future Octave 3.4.x release versions should remain binary
+    compatible with Octave 3.4.1 as we are now using proper library
+    versioning as recommended by the libtool manual.
+
+ ** The following functions have been deprecated in Octave 3.4.1 and will
+    be removed from Octave 3.8 (or whatever version is the second major
+    release after 3.4):
+
+      cquad  is_duplicate_entry  perror  strerror
+
+ ** The following functions are new in 3.4.1:
+
+      colstyle  iscolumn  isrow
+
+ ** The get_forge_pkg function is now private.
+
+ ** The rectangle_lw, rectangle_sw, triangle_lw, and triangle_sw
+    functions are now private.
+
+ ** The logistic_regression_derivatives and logistic_regression_likelihood
+    functions are now private.
 
 Summary of important user-visible changes for version 3.4:
 ---------------------------------------------------------