packager: allow overrideing package info from cli
[pharext/pharext] / README.md
index 583f22b1b0ac04ddc60fe67a744acc77d0a85ff5..dda399f7d145e6f0b09d016b56a595fab960d820 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,74 +1,79 @@
 # pharext
 
-Distribute your PHP extension as self-installable phar executable
+[![Join the chat at https://gitter.im/pharext/pharext](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/pharext/pharext?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+Distribute your PHP extension as self-installable phar executable. See https://pharext.org
 
 ## About
 
 You don't need this package to install any `*.ext.phar` extension packages,
 just run them with php:
 
-       $ ./pecl_http-2.4.0dev.ext.phar
+       $ ./pecl_http-2.4.2.ext.phar
 
 For a compressed phar, or if the execute permission bit got lost somehow:
 
-       $ php pecl_http-2.4.0dev.ext.phar.gz
+       $ php pecl_http-2.4.2.ext.phar.gz
 
 Command help:
 
-       $ ./pecl_http-2.4.0dev.ext.phar -h
+       $ ./pecl_http-2.4.2.ext.phar -h
 
 Yields:
 
-       pharext v2.0.0 (c) Michael Wallner <mike@php.net>
+       pharext v3.0.0 (c) Michael Wallner <mike@php.net>
 
        Usage:
 
-         $ ./pecl_http-2.4.0dev.ext.phar [-hvqs] [-p|-n|-c|-i <arg>]
-
-               -h|--help                                  Display help
-               -v|--verbose                               More output
-               -q|--quiet                                 Less output
-               -p|--prefix <arg>                          PHP installation prefix if phpize is not in $PATH, e.g. /opt/php7
-               -n|--common-name <arg>                     PHP common program name, e.g. php5 or zts-php [php]
-               -c|--configure <arg>                       Additional extension configure flags, e.g. -c --with-flag
-               -s|--sudo [<arg>]                          Installation might need increased privileges [sudo -S %s]
-               -i|--ini <arg>                             Activate in this php.ini instead of loaded default php.ini
-               --enable-propro [<arg>]                    Whether to enable property proxy support [yes]
-               --enable-raphf [<arg>]                     Whether to enable raphf support [yes]
-               --with-http-zlib-dir [<arg>]               Where to find zlib [/usr]
-               --with-http-libcurl-dir [<arg>]            Where to find libcurl [/usr]
-               --with-http-libevent-dir [<arg>]           Where to find libevent [/usr]
+       $ ./pecl_http-2.4.2.ext.phar [-hvqs] [-p|-n|-c|-i <arg>]
+
+         -h|--help                                  Display help
+         -v|--verbose                               More output
+         -q|--quiet                                 Less output
+         -p|--prefix <arg>                          PHP installation prefix if phpize is not in $PATH, e.g. /opt/php7
+         -n|--common-name <arg>                     PHP common program name, e.g. php5 or zts-php [php]
+         -c|--configure <arg>                       Additional extension configure flags, e.g. -c --with-flag
+         -s|--sudo [<arg>]                          Installation might need increased privileges [sudo -S %s]
+         -i|--ini <arg>                             Activate in this php.ini instead of loaded default php.ini
+         --signature                                Show package signature
+         --license                                  Show package license
+         --name                                     Show package name
+         --date                                     Show package release date
+         --release                                  Show package release version
+         --version                                  Show pharext version
+         --enable-propro [<arg>]                    Whether to enable property proxy support [yes]
+         --enable-raphf [<arg>]                     Whether to enable raphf support [yes]
+         --with-http-zlib-dir [<arg>]               Where to find zlib [/usr]
+         --with-http-libcurl-dir [<arg>]            Where to find libcurl [/usr]
+         --with-http-libevent-dir [<arg>]           Where to find libevent [/usr]
+
 
 If your installation destination needs escalated permissions, have a look at [the `--sudo` option](https://github.com/m6w6/pharext/wiki/Usage-of-*.ext.phar-packages#privileges):
 
-       $ ./pecl_http-2.4.0dev.ext.phar --ini /etc/php/conf.d/pecl.ini --sudo
-       Installing propro-1.0.1.ext.phar ... 
-       Running phpize ... OK
-       Running configure ... OK
-       Running make ... OK
-       Running install ... OK
-       Running INI owner transfer ... OK
-       Running INI permission transfer ... OK
-       Running INI activation ... OK
-       Cleaning up /tmp/propro-1.0.1.ext.phar.54fdbc828e3ef ...
-       Installing raphf-1.0.5.ext.phar ... 
-       Running phpize ... OK
-       Running configure ... OK
-       Running make ... OK
-       Running install ... OK
-       Running INI owner transfer ... OK
-       Running INI permission transfer ... OK
-       Running INI activation ... OK
-       Cleaning up /tmp/raphf-1.0.5.ext.phar.54fdbc828e5e0 ...
-       Installing pecl_http-2.4.0dev.ext.phar ... 
-       Running phpize ... OK
-       Running configure ... OK
-       Running make ... OK
-       Running install ... OK
-       Running INI owner transfer ... OK
-       Running INI permission transfer ... OK
-       Running INI activation ... OK
-       Cleaning up /tmp/pecl_http-2.4.0dev.ext.phar.54fdbc828e1fb ...
+       Installing propro-1.0.1.ext.phar ...
+       Running phpize ...
+       Running configure ...
+       Running make ...
+       Running make install ...
+       Running INI activation ...
+       Extension already activated ...
+       Successfully installed propro-1.0.1.ext.phar!
+       Installing raphf-1.0.5.ext.phar ...
+       Running phpize ...
+       Running configure ...
+       Running make ...
+       Running make install ...
+       Running INI activation ...
+       Extension already activated ...
+       Successfully installed raphf-1.0.5.ext.phar!
+       Installing pecl_http-2.4.2.ext.phar ...
+       Running phpize ...
+       Running configure ...
+       Running make ...
+       Running make install ...
+       Running INI activation ...
+       Extension already activated ...
+       Successfully installed pecl_http-2.4.2.ext.phar!
 
 
 ### Prerequisites
@@ -81,9 +86,9 @@ A network connection is not needed.
 
 ## Extension maintainers
 
-Download the pharext binary of the [latest release](https://github.com/m6w6/pharext/releases/latest).
+Download the pharext binary of the [latest release](https://github.com/pharext/pharext/releases/latest).
 
-Be aware that you need the public key to run official `pharext` releases.
+Be aware that you need the [public key](https://github.com/pharext/pharext/wiki/Public-key) to run official `pharext` releases.
 
        -----BEGIN PUBLIC KEY-----
        MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA5x9bwisjDBDV/bwDiju2
@@ -97,5 +102,5 @@ Be aware that you need the public key to run official `pharext` releases.
 
 Place it as `pharext.pubkey` in the same directory where the `pharext` binary is located. IF you cloned the repository or installed `pharext` through composer, it is already at the right location.
 
-Please have a look at the [wiki](https://github.com/m6w6/pharext/wiki), to learn [how to use](https://github.com/m6w6/pharext/wiki/Usage-of-the-pharext-packager) the pharext installer to package self-installing PHP extensions.
+Please have a look at the [wiki](https://github.com/pharext/pharext/wiki), to learn [how to use](https://github.com/pharext/pharext/wiki/Usage-of-the-pharext-packager) the pharext installer to package self-installing PHP extensions.