docs: simplify install instructions
authorMichael Wallner <mike@php.net>
Mon, 7 Feb 2022 13:18:35 +0000 (14:18 +0100)
committerMichael Wallner <mike@php.net>
Fri, 11 Feb 2022 10:26:30 +0000 (11:26 +0100)
README.md
docs/Makefile
docs/v0.1/ion.html

index dc46f31b665ebbae400e80fb45f31189afc5baa1..ff435ff198521c34be1c4c77f8ea3cd882ba7523 100644 (file)
--- a/README.md
+++ b/README.md
@@ -10,27 +10,6 @@ see [spdx.org](https://spdx.org/licenses/BSD-2-Clause.html).
 
 ## Installation:
 
-### PECL
-
-       pecl install ion
-
-
-### PHARext
-
-Watch out for [PECL replicates](https://replicator.pharext.org?ion)
-and pharext packages attached to [releases](./releases).
-
-### Checkout
-
-       git clone github.com:awesomized/ext-ion
-
-       cd ext-ion
-
-       /path/to/phpize
-       ./configure --with-php-config=/path/to/php-config
-       make
-       sudo make install
-
 ### Dependencies:
 #### Required:
 * PHP-8.1
@@ -42,10 +21,20 @@ and pharext packages attached to [releases](./releases).
 ### Trinity:
 ```shell
 phpize
-./configure
+./configure # --with-php-config=<path/to/php-config>
 make # -j$(nproc)
 sudo make install # INSTALL=install
 ```
+
+### PECL
+
+       pecl install ion
+
+### PHARext
+
+Watch out for [PECL replicates](https://replicator.pharext.org?ion)
+and pharext packages attached to [releases](./releases).
+
 ### Try with Docker:
 ```shell
 docker build -t php-ion
index adc1b332527be7c1ff4180e8be4f4a8885a464dc..19ab235126430f69f5630182f5a2f92b5e20621b 100644 (file)
@@ -1,6 +1,6 @@
 PHP ?= php
 COMPOSER ?= composer
-TAG := $(shell (git describe --tags --exact-match --match=v[0-9]*  2>/dev/null || echo v0.0) | cut -d. -f-2)
+TAG := $(shell (git describe --tags --match=v[0-9]*  2>/dev/null || git tag --sort=authordate | egrep ^v[0-9] | tail -n1) | cut -d. -f-2)
 
 # ---
 
index 42e3138385d4d0fd1948145c505f92e0f1c024fe..3f4341f51395de42cead2fa76c343299fc65aa5b 100644 (file)
 See the <a href="https://amzn.github.io/ion-docs/">Amazon ION specification</a>.</p><h2 id="License:">License:<a class="permalink" href="ion#License:">#</a>
 </h2><p><a href="https://github.com/awesomized/ext-ion/blob/master/LICENSE">BSD-2-Clause</a>;
 see <a href="https://spdx.org/licenses/BSD-2-Clause.html">spdx.org</a>.</p><h2 id="Installation:">Installation:<a class="permalink" href="ion#Installation:">#</a>
-</h2><h3 id="PECL">PECL<a class="permalink" href="ion#PECL">#</a>
-</h3><pre><code><span style="color: inherit" class="html">
-pecl install ion<br></span>
-</code></pre><h3 id="PHARext">PHARext<a class="permalink" href="ion#PHARext">#</a>
-</h3><p>Watch out for <a href="https://replicator.pharext.org?ion">PECL replicates</a>
-and pharext packages attached to <a href="./releases">releases</a>.</p><h3 id="Checkout">Checkout<a class="permalink" href="ion#Checkout">#</a>
-</h3><pre><code><span style="color: inherit" class="html">
-git clone github.com:awesomized/ext-ion<br><br>cd ext-ion<br><br>/path/to/phpize<br>./configure --with-php-config=/path/to/php-config<br>make<br>sudo make install<br></span>
-</code></pre><h3 id="Dependencies:">Dependencies:<a class="permalink" href="ion#Dependencies:">#</a>
+</h2><h3 id="Dependencies:">Dependencies:<a class="permalink" href="ion#Dependencies:">#</a>
 </h3><h4 id="Required:">Required:<a class="permalink" href="ion#Required:">#</a>
 </h4><ul>
 <li>PHP-8.1
@@ -288,8 +280,13 @@ git clone github.com:awesomized/ext-ion<br><br>cd ext-ion<br><br>/path/to/php
 <a href="https://github.com/amzn/ion-c">amzn/ion-c</a> (bundled as git submodule)</li>
 </ul><h3 id="Trinity:">Trinity:<a class="permalink" href="ion#Trinity:">#</a>
 </h3><pre><code><span style="color: inherit" class="html">
-phpize<br>./configure<br>make # -j$(nproc)<br>sudo make install # INSTALL=install<br></span>
-</code></pre><h3 id="Try.with.Docker:">Try with Docker:<a class="permalink" href="ion#Try.with.Docker:">#</a>
+phpize<br>./configure # --with-php-config=&lt;path/to/php-config&gt;<br>make # -j$(nproc)<br>sudo make install # INSTALL=install<br></span>
+</code></pre><h3 id="PECL">PECL<a class="permalink" href="ion#PECL">#</a>
+</h3><pre><code><span style="color: inherit" class="html">
+pecl install ion<br></span>
+</code></pre><h3 id="PHARext">PHARext<a class="permalink" href="ion#PHARext">#</a>
+</h3><p>Watch out for <a href="https://replicator.pharext.org?ion">PECL replicates</a>
+and pharext packages attached to <a href="./releases">releases</a>.</p><h3 id="Try.with.Docker:">Try with Docker:<a class="permalink" href="ion#Try.with.Docker:">#</a>
 </h3><pre><code><span style="color: inherit" class="html">
 docker build -t php-ion<br>docker run --rm php-ion -r 'echo ion\serialize(ion\Symbol\PHP::asTable());'<br></span>
 </code></pre><h2 id="Editor.Stub:">Editor Stub:<a class="permalink" href="ion#Editor.Stub:">#</a>