Use phpDocumentor2 instead of ApiGen

Author: horgh

dev-bin/release.sh

@@ -76,21 +76,21 @@ if [ -n "$(git status --porcelain)" ]; then
     exit 1
 fi
 
-# We no longer have apigen as a dependency in Composer as it pulls in old
-# versions of other libraries, breaking PHP 7.2.
-#
-# Note that the Phar is no longer being updated. We will likely need to go
-# back to a Composer dep or use another generator at some point in the
-# future.
-wget -O apigen.phar "http://apigen.org/apigen.phar"
-
-php apigen.phar generate \
-    -s ../src \
-    -s ../../MaxMind-DB-Reader-php/src \
-    -d "doc/$tag" \
+# Using Composer is possible, but they don't recommend it.
+wget -O phpDocumentor.phar https://github.com/phpDocumentor/phpDocumentor2/releases/download/v2.9.0/phpDocumentor.phar
+
+# Use cache dir in /tmp as otherwise cache files get into the output directory.
+cachedir="/tmp/phpdoc-$$-$RANDOM"
+rm -rf "$cachedir"
+
+php phpDocumentor.phar \
+    -d src,../MaxMind-DB-Reader-php/src \
+    --visibility public \
+    --cache-folder "$cachedir" \
     --title "GeoIP2 PHP API $tag" \
-    --php
+    -t "doc/$tag"
 
+rm -rf "$cachedir"
 
 page=index.md
 cat <<EOF > $page