Mailing-List: contact cygwin-help AT sourceware DOT cygnus DOT com; run by ezmlm
List-Subscribe: <mailto:cygwin-subscribe AT sources DOT redhat DOT com>
List-Archive: <http://sources.redhat.com/ml/cygwin/>
List-Post: <mailto:cygwin AT sources DOT redhat DOT com>
List-Help: <mailto:cygwin-help AT sources DOT redhat DOT com>, <http://sources.redhat.com/ml/#faqs>
Sender: cygwin-owner AT sources DOT redhat DOT com
Delivered-To: mailing list cygwin AT sources DOT redhat DOT com
Message-ID: <3B19D318.C71AAD1C@ece.gatech.edu>
Date: Sun, 03 Jun 2001 02:03:04 -0400
From: "Charles S. Wilson" <cwilson AT ece DOT gatech DOT edu>
X-Mailer: Mozilla 4.77 [en] (WinNT; U)
X-Accept-Language: en
MIME-Version: 1.0
To: cygwin AT sources DOT redhat DOT com
Subject: [avail for test] readline-4.2-1
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

I've just uploaded readline-4.2-1 as a test release.  Readline is a
library that provides user-input functions complete with history
functions and line-editing capabilities.  

readline-4.2-1 depends on ncurses-5.2-5.

WARNING: Chet Ramey, the maintainer of the GNU readline package, has
changed the readline API between version 4.1 and 4.2.  Some functions
and variables were added, but more problematic, other functions and
variables were removed.  (see the file "CYGWIN-PATCHES/ChangeLog" in the
source dist for more info) Most of these changes were due to function
renaming so that the function names followed a more sensible scheme. 
However, this breaks backwards compatibility.

Therefore, the DLL version in this package is "4.2" instead of "4". 
That way, binaries that depend on the old dll (like postgresql) can
coexist with the new package.

HOWEVER!!! Setup will *uninstall* the old dll when upgrading readline. 
To preserve the old readline DLL, do this **BEFORE** updating your
readline package:
  cd /usr/bin
  cp cygreadline4.dll cygreadline4.dll.bak
  cp cyghistory4.dll cyghistory4.dll.bak
>>>>> RUN setup.exe, update readline <<<<<<<
  mv cygreadline4.dll.bak cygreadline4.dll
  mv cyghistory4.dll.bak cyghistory4.dll
>>>>> Now, you have both the "4" dll's and the "4.2" dll's <<<<

Currently, the only *official* package that depends on and is affected
by this is postgresql (psql.exe).  Eventually, I hope the postgresql
maintainer (Jason???) will recompile that package to use the new
cygreadline4.2.dll --- AFTER this package has gone through a certain
amount of peer review --- but until then, you'll need to preserve your
old cygreadline4.dll.

CHANGES FROM readline-4.1-2

* API changes in the base package from GNU

* readline now honors the "ALL_STATIC" flag for static linking, in
addition to the "READLINE_STATIC" flag. (See below)

INSTALLATION:

***AFTER*** preserving cygreadline4.dll and cyghistory4.dll as
instructed above:

To update your installation, click on the "Install Cygwin now" link on
the http://sources.redhat.com/cygwin web page.  This downloads setup.exe
to your system.

Run setup and answer all of the questions.  PLEASE, PLEASE, PLEASE
choose a mirror site for your download.  The 'sources.redhat.com' site
is badly overloaded.  The mirrors below have the latest version of this
package:

ftp://mirrors.rcn.net/pub/sourceware/cygwin/ (US)
ftp://linux.sarang.net/mirror/development/compiler/cygwin/ (Korea)
ftp://ftp.mirror.ac.uk/sites/sourceware.cygnus.com/pub/cygwin (UK)

The setup.exe program will figure out what needs to be updated on your
system and should install the less package automatically. To install
this Test version of readline you'll have to tell setup.exe to
specifically 
install it by clicking on the arrows to the left of the ncurses package 
line until "Test" shows up.


If you have questions or comments, please send them to the Cygwin
mailing list at:  cygwin AT sources DOT redhat DOT com .  I would appreciate if you
would use this mailing list rather than emailing me directly. This
includes ideas and comments about the setup utility or Cygwin general.

If you want to make a point or ask a question the Cygwin mailing list is
the appropriate place.

              *** CYGWIN-ANNOUNCE UNSUBSCRIBE INFO ***

If you want to unsubscribe to the cygwin-announce mailing list, look at
the "List-Unsubscribe: " tag in the email header of this message. Send
email to the address specified there.  It will be in the format:

cygwin-announce-unsubscribe-you=yourdomain DOT com AT sources DOT redhat DOT com

NOTES:

o Building the package from source requires gcc-2.95.2-5 and
binutils-20001029-2 or later

o depends on ncurses-5.2-5 or later.

o The package includes several test and conversion utilities which are
useful for evaluating readline.  Both dynamically-linked and
statically-linked versions are installed.

o Abides by the cygwin package system standard:
  - import-lib      /usr/lib/libreadline.dll.a
  - import-lib      /usr/lib/libhistory.dll.a
  - static-lib      /usr/lib/libreadline.a
  - static-lib      /usr/lib/libhistory.a
  - stripped dll    /usr/bin/cygreadline4.2.dll
  - stripped dll    /usr/bin/cyghistory4.2.dll
  - cygwin-specific docs in /usr/doc/Cygwin/readline-4.2.README
  - generic docs in /usr/doc/readline-4.2/*

o A cygwin-specific README and PATCH are stored in the source archive,
under <top>/CYGWIN-PATCHES/* (although that patch has already been
applied to the archive itself). The cygwin-specific README is also
installed by the binary distribution as described above.

o After installing, please read /usr/doc/Cygwin/readline-4.2.README

o Should run the following commands after installing 
  install-info --dir-file=/usr/info/dir \
     --info-file=/usr/info/readline.info
  install-info --dir-file=/usr/info/dir \
     --info-file=/usr/info/history.info

o If you are building a package that depends on readline (or solely on
history), and you wish to link *statically*, define -DREADLINE_STATIC
(and -DNCURSES_STATIC because of dependency issues) to get the 'correct'
#define's in readline.h (or history.h) when compiling the .o files in
your package. Also, use 'gcc -static' when linking your package.

o You can also use -DALL_STATIC as a synonym for both -DREADLINE_STATIC
and -DNCURSES_STATIC.  Eventually, many of the cygwin packages on
sources.redhat.com that provide both dll's and static libs will honor
the ALL_STATIC flag.  That way, you won't have to type "-DZLIB_STATIC
-DPNG_STATIC -DJPEG_STATIC -DTIFF_STATIC ....".  Currently, only the
following packages honor the ALL_STATIC flag:
  ncurses
  readline
  zlib
  libpng
  xpm-nox
The following do not (yet)
  jpeg
  tiff
  jbig
  gdbm
  gettext (libintl, cygintl)
  
o No special -Ddefine options or link options are needed when building a
package that depends on readline (or history) and you want to link
dynamically (recommended). 

--Chuck Wilson

--
Want to unsubscribe from this list?
Check out: http://cygwin.com/ml/#unsubscribe-simple