prepare for v1.0
[m6w6/ext-pq] / README.md
index e251e3792518a45366814c795b70075fa923a8ce..a62b85d44667e044a1127b8ced97667fa191f773 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,36 +1,38 @@
-pecl/pq
-=======
+# pecl/pq
 
-[![Build Status](https://travis-ci.org/php/pecl-database-pq.svg?branch=master)](https://travis-ci.org/php/pecl-database-pq)
+[![Build Status](https://travis-ci.org/m6w6/ext-pq.svg?branch=v1.0.x)](https://travis-ci.org/m6w6/ext-pq)
 
-About
------
+## About:
 
 This is a modern binding to the mature [libpq](http://www.postgresql.org/docs/current/static/libpq.html), the official PostgreSQL C-client library.
 
-Highlights:
+### Highlights:
 
-- Nearly 100% support for asynchronous usage.
-- Extended type support by pg_type.
-- Fetching simple multi-dimensional array maps.
-- Working [Gateway implementation](https://github.com/m6w6/pq-gateway).
+* Nearly 100% support for [asynchronous usage](https://mdref.m6w6.name/pq/Connection/: Asynchronous Usage).
+* Extended [type support by pg_type](https://mdref.m6w6.name/pq/Types/: Overview).
+* Fetching simple [multi-dimensional array maps](https://mdref.m6w6.name/pq/Result/map).
+* Working [Gateway implementation](https://github.com/m6w6/pq-gateway).
 
-Installation
-------------
+## Installation:
 
-This extension is hosted at [PECL](http://pecl.php.net/) and can be installed with [PEAR](http://pear.php.net/)'s `pecl` command:
+This extension is hosted at [PECL](http://pecl.php.net) and can be installed with [PEAR](http://pear.php.net)'s pecl command:
 
-    # pecl install pq
+       # pecl install pq
 
-Dependencies
-------------
+Also, watch out for self-installing [pharext](https://github.com/m6w6/pharext) packages attached to [releases](https://github.com/m6w6/ext-pq/releases).
+
+## Dependencies:
 
 This extension unconditionally depends on the pre-loaded presence of the following PHP extensions:
 
 - [raphf](http://pecl.php.net/package/raphf)
 - [spl](http://php.net/spl)
 
-Documentation
--------------
+It optionally depends on the following extensions:
+
+* [json](http://php.net/json)
+
+
+## Documentation:
 
-Documentation is available [here](http://devel-m6w6.rhcloud.com/mdref/pq).
+Documentation is available at https://mdref.m6w6.name/pq