Revision: 338
http://vcs.pcre.org/viewvc?view=rev&revision=338
Author: ph10
Date: 2008-04-13 15:58:34 +0100 (Sun, 13 Apr 2008)
Log Message:
-----------
Update docs to point out that sometimes -lncurses will be needed with
libreadline.
Modified Paths:
--------------
code/trunk/README
code/trunk/doc/pcrebuild.3
Modified: code/trunk/README
===================================================================
--- code/trunk/README 2008-04-13 14:21:06 UTC (rev 337)
+++ code/trunk/README 2008-04-13 14:58:34 UTC (rev 338)
@@ -275,6 +275,15 @@
the readline() function. This provides line-editing and history facilities.
Note that libreadline is GPL-licenced, so if you distribute a binary of
pcretest linked in this way, there may be licensing issues.
+
+ Setting this option causes the -lreadline option to be added to the pcretest
+ build. In many operating environments with a sytem-installed readline
+ library this is sufficient. However, in some environments (e.g. if an
+ unmodified distribution version of readline is in use), it may be necessary
+ to specify something like LIBS="-lncurses" as well. This is because, to quote
+ the readline INSTALL, "Readline uses the termcap functions, but does not link
+ with the termcap or curses library itself, allowing applications which link
+ with readline the to choose an appropriate library."
The "configure" script builds the following files for the basic C library:
@@ -740,4 +749,4 @@
Philip Hazel
Email local part: ph10
Email domain: cam.ac.uk
-Last updated: 25 January 2008
+Last updated: 13 April 2008
Modified: code/trunk/doc/pcrebuild.3
===================================================================
--- code/trunk/doc/pcrebuild.3 2008-04-13 14:21:06 UTC (rev 337)
+++ code/trunk/doc/pcrebuild.3 2008-04-13 14:58:34 UTC (rev 338)
@@ -282,6 +282,24 @@
using the \fBreadline()\fP function. This provides line-editing and history
facilities. Note that \fBlibreadline\fP is GPL-licenced, so if you distribute a
binary of \fBpcretest\fP linked in this way, there may be licensing issues.
+.P
+Setting this option causes the \fB-lreadline\fP option to be added to the
+\fBpcretest\fP build. In many operating environments with a sytem-installed
+\fBlibreadline\fP this is sufficient. However, in some environments (e.g.
+if an unmodified distribution version of readline is in use), some extra
+configuration may be necessary. The INSTALL file for \fBlibreadline\fP says
+this:
+.sp
+ "Readline uses the termcap functions, but does not link with the
+ termcap or curses library itself, allowing applications which link
+ with readline the to choose an appropriate library."
+.sp
+If your environment has not been set up so that an appropriate library is
+automatically included, you may need to add something like
+.sp
+ LIBS="-ncurses"
+.sp
+immediately before the \fBconfigure\fP command.
.
.
.SH "SEE ALSO"
@@ -304,6 +322,6 @@
.rs
.sp
.nf
-Last updated: 18 December 2007
-Copyright (c) 1997-2007 University of Cambridge.
+Last updated: 13 April 2008
+Copyright (c) 1997-2008 University of Cambridge.
.fi
