Skip to content

Commit 9a5b92a

Browse files
jimwinsjimwins
authored
Clarify extension status (#3803)
* Gmagick has never had a non-beta release * mqseries has never had a stable release * Warn that recode extension is unmaintained * rnp has never had a stable release. * stats extension is unmaintained * svn extension was already marked experimental in text * Windows DLLs are available now for xdiff * svm has never had a stable release * Mark zmq experimental/unmaintained, and actually connect install section * Fix reference to installation section for zmq that moved * parle has never had a stable release * Mark ui as experimental, clean up intro slightly * Add text warning that Imagick is still considered experimental * Fix Status/State mix-up, and regenerate appendices/extensions.xml
1 parent 2f92a27 commit 9a5b92a

File tree

17 files changed

+53
-39
lines changed

17 files changed

+53
-39
lines changed

‎appendices/extensions.xml

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -417,6 +417,8 @@
417417
<itemizedlist>
418418
<listitem><para><xref linkend="book.imap"/></para></listitem>
419419
<listitem><para><xref linkend="book.mysql"/></para></listitem>
420+
<listitem><para><xref linkend="book.recode"/></para></listitem>
421+
<listitem><para><xref linkend="book.stats"/></para></listitem>
420422
<listitem><para><xref linkend="book.wddx"/></para></listitem>
421423
<listitem><para><xref linkend="book.xmlrpc"/></para></listitem>
422424
</itemizedlist>
@@ -426,7 +428,15 @@
426428
&extcat.state.experimental;
427429

428430
<itemizedlist>
431+
<listitem><para><xref linkend="book.gmagick"/></para></listitem>
429432
<listitem><para><xref linkend="book.imagick"/></para></listitem>
433+
<listitem><para><xref linkend="book.mqseries"/></para></listitem>
434+
<listitem><para><xref linkend="book.parle"/></para></listitem>
435+
<listitem><para><xref linkend="book.rnp"/></para></listitem>
436+
<listitem><para><xref linkend="book.svm"/></para></listitem>
437+
<listitem><para><xref linkend="book.svn"/></para></listitem>
438+
<listitem><para><xref linkend="book.ui"/></para></listitem>
439+
<listitem><para><xref linkend="book.zmq"/></para></listitem>
430440
</itemizedlist>
431441
</section>
432442
</section>

‎language-snippets.ent

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2071,6 +2071,10 @@ for this <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> extension
20712071
<!ENTITY pecl.moved-ver 'This extension has been moved to the &link.pecl;
20722072
repository and is no longer bundled with PHP as of PHP '>
20732073

2074+
<!ENTITY warn.pecl.unmaintained '<warning xmlns="http://docbook.org/ns/docbook">
2075+
<simpara>This extension is <emphasis>unmaintained</emphasis>.</simpara>
2076+
</warning>'>
2077+
20742078
<!-- PGSQL entities -->
20752079

20762080
<!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">An <classname>PgSql\Connection</classname> instance.</para>'>

‎reference/gmagick/book.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3+
<!-- State: experimental -->
34

45
<book xml:id="book.gmagick" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<?phpdoc extension-membership="pecl" ?>
@@ -9,6 +10,7 @@
910
<preface xml:id="intro.gmagick">
1011
&reftitle.intro;
1112
<para>
13+
&warn.experimental;
1214
Gmagick is a php extension to create, modify and obtain meta information of images using the GraphicsMagick API.
1315
</para>
1416
<para>

‎reference/imagick/book.xml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@
1111
<preface xml:id="intro.imagick">
1212
&reftitle.intro;
1313
<para>
14+
&warn.experimental;
1415
Imagick is a native php extension to create and modify images using the
1516
ImageMagick API.
1617
</para>

‎reference/mqseries/book.xml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3+
<!-- State: experimental -->
34

45
<book xml:id="book.mqseries" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<?phpdoc extension-membership="pecl" ?>
@@ -8,10 +9,11 @@
89
<!-- {{{ preface -->
910
<preface xml:id="intro.mqseries">
1011
&reftitle.intro;
11-
<simpara>
12+
<para>
13+
&warn.experimental;
1214
This extension aims to provide an interface for communicating with IBMs
1315
WebSphere MQ series Queue managers.
14-
</simpara>
16+
</para>
1517
<simpara>
1618
The interface mimics the C-API client interface of WebSphere MQ Series as
1719
close as possible. Using the same naming conventions and possibilities of the

‎reference/parle/book.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3+
<!-- State: experimental -->
34

45
<book xml:id="book.parle" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<?phpdoc extension-membership="pecl" ?>
@@ -9,6 +10,7 @@
910
<preface xml:id="intro.parle">
1011
&reftitle.intro;
1112
<para>
13+
&warn.experimental;
1214
The parle extension provides general purpose lexing and parsing facilities. The implementation is based on <link xlink:href="http://www.benhanson.net/">Ben Hanson</link>'s libraries and requires a <link xlink:href="http://en.cppreference.com/w/cpp/compiler_support">C++14</link> capable compiler. The lexer is based on the regex matching, the parser is LALR(1). Lexers and parsers are generated on the fly and can be used immediately after they've been finalized. Parle deals with parsing and lexing, the appropriate data structures representation and processing are the implementer's task. Serialization and code generation are not supported by the extension, yet.
1315
</para>
1416
<para>

‎reference/recode/book.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3+
<!-- State: deprecated -->
34

45
<book xml:id="book.recode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<?phpdoc extension-membership="pecl" ?>
@@ -10,6 +11,7 @@
1011
<preface xml:id="intro.recode">
1112
&reftitle.intro;
1213
<para>
14+
&warn.pecl.unmaintained;
1315
This module contains an interface to the GNU Recode library. The GNU
1416
Recode library converts files between various coded character sets and
1517
surface encodings. When this cannot be achieved exactly, it may get rid

‎reference/rnp/book.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- State: experimental -->
23
<book xml:id="book.rnp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
34
<?phpdoc extension-membership="pecl" ?>
45
<title>Rnp</title>
@@ -7,6 +8,7 @@
78
<preface xml:id="intro.rnp">
89
&reftitle.intro;
910
<para>
11+
&warn.experimental;
1012
This module allows you to use <link
1113
xlink:href="&url.rnp;">RNP</link> library.
1214
RNP is a high performance C++ OpenPGP

‎reference/stats/book.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3+
<!-- State: deprecated -->
34

45
<book xml:id="book.stats" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<?phpdoc extension-membership="pecl" ?>
@@ -9,6 +10,7 @@
910
<preface xml:id="intro.stats">
1011
&reftitle.intro;
1112
<para>
13+
&warn.pecl.unmaintained;
1214
This is the statistics extension. It contains few dozens of functions
1315
useful for statistical computations. It is a wrapper around 2 scientific
1416
libraries, namely DCDFLIB (Library of C routines for Cumulative

‎reference/stats/setup.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@
2020
&pecl.moved;
2121
</para>
2222
<para>
23-
&pecl.info;
23+
&pecl.info.dead;
2424
<link xlink:href="&url.pecl.package;stats">&url.pecl.package;stats</link>.
2525
</para>
2626
<para>

‎reference/svm/book.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3+
<!-- State: experimental -->
34

45
<book xml:id="book.svm" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<?phpdoc extension-membership="pecl" ?>
@@ -9,6 +10,7 @@
910
<preface xml:id="intro.svm">
1011
&reftitle.intro;
1112
<para>
13+
&warn.experimental;
1214
LibSVM is an efficient solver for SVM classification and regression problems.
1315
The svm extension wraps this in a PHP interface for easy use in PHP scripts.
1416
</para>

‎reference/svn/book.xml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3+
<!-- State: experimental -->
34

45
<book xml:id="book.svn" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<?phpdoc extension-membership="pecl" ?>

‎reference/ui/book.xml

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3+
<!-- State: experimental -->
34

45
<book xml:id="book.ui" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<?phpdoc extension-membership="pecl" ?>
@@ -9,7 +10,10 @@
910
<preface xml:id="intro.ui">
1011
&reftitle.intro;
1112
<para>
12-
This extension wraps libui to provide an OO API for the cross platform development of native look-and-feel user interfaces .
13+
&warn.experimental;
14+
This extension wraps <link xlink:href="&url.ui.libui;">libui</link>
15+
to provide an object-oriented API for the cross platform development
16+
of native look-and-feel user interfaces.
1317
</para>
1418
</preface>
1519

‎reference/xdiff/configure.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
<link xlink:href="&url.pecl.package;xdiff">&url.pecl.package;xdiff</link>.
88
</para>
99
<para>
10-
&pecl.windows.download;
10+
&pecl.windows.download.avail;
1111
</para>
1212
</section>
1313

‎reference/zmq/book.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3+
<!-- State: experimental -->
34

45
<book xml:id="book.zmq" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
56
<?phpdoc extension-membership="pecl" ?>
@@ -9,6 +10,7 @@
910
<preface xml:id="intro.zmq">
1011
&reftitle.intro;
1112
<para>
13+
&warn.experimental;
1214
"ØMQ is a software library that lets you quickly design and implement a fast message-based application." --0MQ Website
1315
</para>
1416
<para>

‎reference/zmq/configure.xml

Lines changed: 0 additions & 33 deletions
This file was deleted.

‎reference/zmq/setup.xml

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,18 @@
99
<para>
1010
ZMQ extension requires 0MQ version 2.0.7 or higher. 0MQ can be acquired from <link xlink:href="&url.zeromq;area:download">&url.zeromq;area:download</link>.
1111
</para>
12-
&reference.zmq.configure;
12+
</section>
13+
14+
<section xml:id="zmq.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
15+
&reftitle.install;
16+
17+
<para>
18+
&pecl.info.dead;
19+
<link xlink:href="&url.pecl.package;zmq">&url.pecl.package;zmq</link>
20+
</para>
21+
<para>
22+
&pecl.windows.download.avail;
23+
</para>
1324
</section>
1425
</chapter>
1526

0 commit comments

Comments
 (0)