Mailing-List: contact cygwin-help AT sourceware DOT cygnus DOT com; run by ezmlm
Sender: cygwin-owner AT sources DOT redhat DOT com
Message-ID: <3A2AD679.C129B4A7@ece.gatech.edu>
Date: Sun, 03 Dec 2000 18:25:45 -0500
From: "Charles S. Wilson" <cwilson AT ece DOT gatech DOT edu>
MIME-Version: 1.0
To: cygwin AT sources DOT redhat DOT com
Subject: [avail for test] readline-4.1-1
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit

I've just uploaded readline-4.1-1 to sourceware.  Readline is a library
that provides user-input functions complete with history functions and
line-editing capabilities.  

I've had readline-4.0 on cygutils.netpedia.net for quite some time; this
version is based on a newer release (4.1 instead of 4.0) and follows the
packaging standard for official packages, unlike the cygutils one.  USE
A MIRROR -- the ones listed in the INSTALLATION section have been
verified up-to-date with readline.  readline is marked as a 'test'
release, so you may have to specifically select it in setup to install
(see INSTALLATION below). 

readline-4.1-1 depends on ncurses-5.2-2, which is also a test release at
present, although I expect ncurses-5.2-2 will become non-test very soon. 

INSTALLATION:

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://ftp.freesoftware.com/pub/sourceware/cygwin/ (US)
ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/mirrors/cygnus/
(Germany)
ftp://ftp.ntua.gr/pub/pc/cygwin/ (Greece)

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
readline package line until "Test" shows up.  You may need to click on
the "Full/Part" button in the upper right corner of the the setup screen
to get readline to show up in the list.

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-2 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.dll (**)
  - stripped dll    /usr/bin/cyghistory4.dll  (**)
  - cygwin-specific docs in /usr/doc/Cygwin/readline-4.1.README
  - generic docs in /usr/doc/readline-4.1/*

(**) versioned dlls are the default; only extremely stable libraries
(like zlib) have unversioned dlls.

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.1.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 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?
Send a message to cygwin-unsubscribe AT sourceware DOT cygnus DOT com