release push

[Martin Grabmueller]

Hello mailing-lispers,

I had another look at TODO to get some work done (yes, you're guessing
right, I'd like to see the release...)

A few points:

  - Make sure that the deprecation mechanism explained in INSTALL and
    README is completed and works.

I had a look, and the descriptions look complete.  The deprecation
mechanism has worked for me until now.  So I would simply mark this
point as done.  Objections?

  - Make sure NEWS, INSTALL, AUTHORS and THANKS and the docs are up to date

NEWS looks good (although I can of course not say if something is
missing), INSTALL is fine too (but see below), AUTHORS and THANKS look
good too.  And as far as the docs are concerned: We already have
decided we rather release than make everything perfect.  Objections?

  - Fact-check INSTALL. (rlb: INSTALL looks pretty good to me, but can
    someone make sure that in the "Using Guile without installing it"
    section, we don't need to mention setting LTDL_LIBRARY_PATH or
    LD_LIBRARY_PATH.)

In the attached diff I have added a note about setting
LTDL_LIBRARY_PATH when using the SRFI modules.  If there are no
objections, I'll commit it.

  - Make sure the downloading addresses and filenames in README are
    current.  (But don't bump the version number yet.  We do that below.)

Done.  Looks pretty good.  In addition, I have corrected some
descriptions, information and file lists (see the diff.)

  - Reformat the names in THANKS.

What does that mean?

Best regards,
  'martin

===File ~/cvs/guile-core-stable-1.5/diff====================
Index: INSTALL
===================================================================
RCS file: /cvs/guile/guile-core/INSTALL,v
retrieving revision 1.33.2.2
diff -c -r1.33.2.2 INSTALL
*** INSTALL     2001/07/19 20:56:55     1.33.2.2
--- INSTALL     2001/07/24 17:22:02
***************
*** 210,215 ****
--- 210,226 ----
  
    setenv GUILE_LOAD_PATH /home/jimb/guile-snap
  
+ You will additionally need to set your `LTDL_LIBRARY_PATH' environment
+ variable to the directory in which the compiled SRFI support modules
+ are created if you want to use the modules for SRFI-4, SRFI-13 or
+ SRFI-14 support.  Similar to the example above, this will be,
+ 
+   export LTDL_LIBRARY_PATH=/home/jimb/guile-snap/srfi/.libs
+ 
+ or if you're using CSH or one of its variants:
+ 
+   setenv LTDL_LIBRARY_PATH /home/jimb/guile-snap/srfi/.libs
+ 
  
  Installing SLIB ===========================================================
  
Index: README
===================================================================
RCS file: /cvs/guile/guile-core/README,v
retrieving revision 1.87
diff -c -r1.87 README
*** README      2001/06/28 17:30:12     1.87
--- README      2001/07/24 17:22:06
***************
*** 1,41 ****
! !!! This is not a Guile release; it is a source tree retrieved via
! anonymous CVS or as a nightly snapshot at some random time after the
! Guile 1.4 release.  If this were a Guile release, you would not see
! this message. !!!  [fixme: zonk on release]
! 
! This is a 1.5 development version of Guile, Project GNU's extension
! language library.  Guile is an interpreter for Scheme, packaged as a
! library that you can link into your applications to give them their
! own scripting language.  Guile will eventually support other languages
! as well, giving users of Guile-based applications a choice of
! languages.
  
  Guile versions with an odd middle number, i.e. 1.5.* are unstable
  development versions.  Even middle numbers indicate stable versions.
  This has been the case since the 1.3.* series.
  
! The next stable release will be version 1.6.0.
  
  Please send bug reports to address@hidden
  
  Guile Documentation ==================================================
  
! The doc directory contains a few articles on specific topics and some
! examples, including data-rep.texi which describes the internal
! representation of data types in Guile.  The example-smob directory
! contains example source code for the "Defining New Types (Smobs)" chapter.
! 
! The incomplete Guile reference manual is available at
! 
!   ftp://ftp.red-bean.com/pub/guile/snapshots/guile-doc-snap.tar.gz
! 
! Neil Jerram is working on the new reference manual, which will be
! distributed with guile-core.  The new manual will be synchronized with
! the docstrings in the sources.  Until then, please be aware that the
! docstrings are likely to be more up-to-date than the old reference
! manual (use `(help)' or see libguile/guile-procedures.txt which is
! generated by the build process).
  
  The Guile WWW page is at
  
    http://www.gnu.org/software/guile/guile.html
--- 1,33 ----
! This is version 1.6 of Guile, Project GNU's extension language
! library.  Guile is an interpreter for Scheme, packaged as a library
! that you can link into your applications to give them their own
! scripting language.  Guile will eventually support other languages as
! well, giving users of Guile-based applications a choice of languages.
  
  Guile versions with an odd middle number, i.e. 1.5.* are unstable
  development versions.  Even middle numbers indicate stable versions.
  This has been the case since the 1.3.* series.
  
! The next stable release will be version 1.8.0.
  
  Please send bug reports to address@hidden
  
  Guile Documentation ==================================================
  
! The doc directory contains the Guile Reference Manual, the Guile
! Tutorial, the GOOPS Manual and the Revised^5 Report on Scheme.  The
! example-smob directory contains example source code for the "Defining
! New Types (Smobs)" chapter.
! 
! Additionally, help on specific procedures can be obtained directly
! from the Guile prompt.  Type `(help)' to see usage information for the
! online documentation system.
  
+ The examples directory contains some example scripts, programs and
+ modules which demonstrate various ways in which Guile can be used.
+ 
+ See the file NEWS to see what is new in this release of Guile.
+ 
  The Guile WWW page is at
  
    http://www.gnu.org/software/guile/guile.html
***************
*** 151,157 ****
  
   guile --- a stand-alone interpreter for Guile.  With no arguments, this
        is a simple interactive Scheme interpreter.  It can also be used
!       as an interpreter for script files; see the NEWS file for details.
   guile-config --- a Guile script which provides the information necessary
        to link your programs against the Guile library.
   guile-snarf --- a script to parse declarations in your C code for
--- 143,150 ----
  
   guile --- a stand-alone interpreter for Guile.  With no arguments, this
        is a simple interactive Scheme interpreter.  It can also be used
!       as an interpreter for script files; see the Guile Reference
!       Manual for details.
   guile-config --- a Guile script which provides the information necessary
        to link your programs against the Guile library.
   guile-snarf --- a script to parse declarations in your C code for
***************
*** 181,193 ****
  
  Support files, in ${prefix}/share/guile/<version>:
  
!  ice-9/* --- run-time support for Guile: the module system,
!       read-eval-print loop, some R4RS code and other infrastructure.
!  oop/* --- the Guile Object-Oriented Programming System (GOOPS)
!  scripts/* --- executable modules, i.e., scheme programs that can be both
!       called as an executable from the shell, and loaded and used as a
!       module from scheme code.  See scripts/README for more info.
!  srfi/* --- SRFI support modules.  See srfi/README for more info.
  
  Automake macros, in ${prefix}/share/aclocal:
  
--- 174,188 ----
  
  Support files, in ${prefix}/share/guile/<version>:
  
!  ice-9/*   --- run-time support for Guile: the module system,
!              read-eval-print loop, some R5RS code and other
!              infrastructure.
!  oop/*     --- the Guile Object-Oriented Programming System (GOOPS)
!  scripts/* --- executable modules, i.e., scheme programs that can be 
!              both called as an executable from the shell, and loaded
!                and used as a module from scheme code.  See
!                scripts/README for more info.
!  srfi/*    --- SRFI support modules.  See srfi/README for more info.
  
  Automake macros, in ${prefix}/share/aclocal:
  
***************
*** 195,202 ****
  
  Documentation in Info format, in ${prefix}/info:
  
!  data-rep.info --- an essay on how to write C code that works with
!       Guile Scheme values.
  
  The Guile source tree is laid out as follows:
  
--- 190,201 ----
  
  Documentation in Info format, in ${prefix}/info:
  
!  guile.info     --- The Guile Reference Manual
!  guile-tut.info --- The Guile Tutorial
!  goops.info     --- Reference Manual and Tutorial for GOOPS, Guile's 
!                   Object-Oriented Programming System
!  r5rs.info      --- The Revised^5 Report on Scheme, the official Scheme
!                   language definition.
  
  The Guile source tree is laid out as follows:
  
***************
*** 206,221 ****
  ice-9:  Guile's module system, initialization code, and other infrastructure.
  guile-config:
        Source for the guile-config script.
- qt:   A cooperative threads package from the University of Washington,
-       which Guile can use.  If you configure Guile with the
-         --with-threads flag, you will need to link against the -lqt
-         library, found in this directory.  Qt is under a separate
-         copyright; see `qt/README' for more details.
  guile-readline:
          The glue code for using GNU readline with Guile.  This
          will be build when configure can find a recent enough readline
          library on your system.
  doc:  Documentation (see above).
  
  Anonymous CVS Access and FTP snapshots ===============================
  
--- 205,233 ----
  ice-9:  Guile's module system, initialization code, and other infrastructure.
  guile-config:
        Source for the guile-config script.
  guile-readline:
          The glue code for using GNU readline with Guile.  This
          will be build when configure can find a recent enough readline
          library on your system.
  doc:  Documentation (see above).
+ examples:
+         A collection of ready-to-build example scripts, programs and
+       modules, which are meant to demonstrate how Guile can be
+       used for different needs.  See examples/README for more info.
+ libltdl:
+         A library for generic access to shared libraries from libtool.
+ oop:    GOOPS source code.
+ qt:   A cooperative threads package from the University of Washington,
+       which Guile can use.  If you configure Guile with the
+         --with-threads flag, you will need to link against the -lqt
+         library, found in this directory.  Qt is under a separate
+         copyright; see `qt/README' for more details.
+ scripts:
+         Some useful scripts, packages as `executable scripts'.  See
+       scripts/README for details.
+ srfi:   A lot of SRFI support modules.  See srfi/README for more info.
+ test-suite:
+         Guile's regression test suite.
  
  Anonymous CVS Access and FTP snapshots ===============================
  
============================================================