Add notes directing users to newer pcre2 packages

diff --git a/debian/README.Debian b/debian/README.Debian
index ac6bde676328ecc3c2819f67dbdc205553c9a9bc..7c2dab0c0328bcc7dbd1bdf2fbf5e58a98addb92 100644 (file)
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -1,6 +1,11 @@
 libpcre for debian
 ------------------
 
+This is the older PCRE library (called "PCRE" upstream); you should
+use the pcre2 packages (called "PCRE2" upstream) for new projects, and
+aim to migrate existing projects to pcre2. Upstream is hoping to drop
+support for pcre3 in the near future.
+
 Upstream's library version is much lower than Debian's - PCRE_LIB_VERSION=0:1:0
 instead of 13:0:10 (soname libpcre.so.0 instead of libpcre.so.3)
 
@@ -9,3 +14,4 @@ with "pcreposix_". This is required so they don't clash with the ones in
 libc. Suitable #defines have been added to pcreposix.h so that the
 unprefixed names can be used.
 
+ -- Matthew Vernon <matthew@debian.org>, Thu, 28 Jul 2016 16:54:21 +0100

diff --git a/debian/control b/debian/control
index 8ce64d0c8f35c40b4bc771c4adbd5f101a54ea53..cc27478187286c0790ca01bb44716a547939049a 100644 (file)
--- a/debian/control
+++ b/debian/control
@@ -21,10 +21,13 @@ Breaks:
  liquidsoap (<< 0.9.2-3~)
 Multi-Arch: same
 Pre-Depends: multiarch-support
-Description: Perl 5 Compatible Regular Expression Library - runtime files
+Description: Old Perl 5 Compatible Regular Expression Library - runtime files
  This is a library of functions to support regular expressions whose syntax 
  and semantics are as close as possible to those of the Perl 5 language.
  .
+ New packages should use the newer pcre2 packages, and existing
+ packages should migrate to pcre2.
+ .
  This package contains the runtime libraries.
 
 Package: libpcre3-udeb
@@ -34,7 +37,7 @@ Architecture: any
 Priority: important
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Conflicts: libpcre3-dev (<= 4.3-3)
-Description: Perl 5 Compatible Regular Expression Library - runtime files (udeb)
+Description: Old Perl 5 Compatible Regular Expression Library - runtime files (udeb)
  This is a library of functions to support regular expressions whose syntax 
  and semantics are as close as possible to those of the Perl 5 language.
  .
@@ -49,7 +52,7 @@ Conflicts: libpcre3 (<< 6.4-1.1), libpcrecpp0
 Replaces: libpcre3 (<< 6.4-1.1), libpcrecpp0
 Multi-Arch: same
 Pre-Depends: multiarch-support
-Description: Perl 5 Compatible Regular Expression Library - C++ runtime files
+Description: Old Perl 5 Compatible Regular Expression Library - C++ runtime files
  This is a C++ library of functions to support regular expressions whose syntax 
  and semantics are as close as possible to those of the Perl 5 language.
  .
@@ -60,10 +63,13 @@ Section: libdevel
 Architecture: any
 Multi-Arch: same
 Depends: libc6-dev, libpcre3 (= ${binary:Version}), libpcre16-3 (= ${binary:Version}), libpcre32-3 (= ${binary:Version}), libpcrecpp0v5 (= ${binary:Version}), ${misc:Depends}
-Description: Perl 5 Compatible Regular Expression Library - development files
+Description: Old Perl 5 Compatible Regular Expression Library - development files
  This is a library of functions to support regular expressions whose syntax 
  and semantics are as close as possible to those of the Perl 5 language.
  .
+ New packages should use the newer pcre2 packages, and existing
+ packages should migrate to pcre2.
+ .
  This package contains the development files, including headers, static 
  libraries, and documentation.
 
@@ -73,7 +79,7 @@ Priority: extra
 Architecture: any
 Depends: libpcre3 (= ${binary:Version}), libpcrecpp0v5 (= ${binary:Version}),  ${misc:Depends}
 Multi-Arch: same
-Description: Perl 5 Compatible Regular Expression Library - debug symbols
+Description: Old Perl 5 Compatible Regular Expression Library - debug symbols
  This is a library of functions to support regular expressions whose syntax 
  and semantics are as close as possible to those of the Perl 5 language.
  .
@@ -98,7 +104,7 @@ Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Multi-Arch: same
 Pre-Depends: ${misc:Pre-Depends}
-Description: Perl 5 Compatible Regular Expression Library - 16 bit runtime files
+Description: Old Perl 5 Compatible Regular Expression Library - 16 bit runtime files
  This is a library of functions to support regular expressions whose syntax
  and semantics are as close as possible to those of the Perl 5 language.
  .
@@ -110,7 +116,7 @@ Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}
 Multi-Arch: same
 Pre-Depends: ${misc:Pre-Depends}
-Description: Perl 5 Compatible Regular Expression Library - 32 bit runtime files
+Description: Old Perl 5 Compatible Regular Expression Library - 32 bit runtime files
  This is a library of functions to support regular expressions whose syntax
  and semantics are as close as possible to those of the Perl 5 language.
  .