[avail for test] readline-4.2-2

Charles S. Wilson cwilson@ece.gatech.edu
Sun Jun 10 16:58:00 GMT 2001

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

readline-4.2-2 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.  This package also contains the OLD
"4" dll's so that older programs won't break.

Currently, the only *official* packages that depend on and are affected
by this are postgresql and python.

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)

* contains the "old" cygreadline4.dll and cyghistory4.dll to ease
the transition from the old API to the new API -- old programs will
continue to work until their porters can rebuild them to use the
new API.  New compiles will use the new dll's, not the old ones.


***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

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
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@sources.redhat.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.


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:



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 \
  install-info --dir-file=/usr/info/dir \

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:
The following do not (yet)
  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

More information about the Cygwin mailing list