glob

Author: fulldecent

.github/workflows/publish-apidocs.yml

@@ -80,10 +80,10 @@ jobs:
 # TODO: remove the ignores below, they speed up the runs for quick evaluation while we're setting this up
 # Notice: -d xdebug.mode=off is required due to a bug/workaround
 # Issue: https://github.com/phpDocumentor/phpDocumentor/issues/3642#issuecomment-1912354577
-# TODO: have a nicer way to specify excludes
+# See ignores implicitly loaded from phpdoc.dist.xml
 # excludes from https://github.com/moodle/phpdoc/blob/929083a815c1f7e95c540173e7549810f6d4a598/scripts/generate_phpdoc.sh#L27-L48
       - name: Build with phpDocumentor
-        run: php -d xdebug.mode=off ${{ github.workspace }}/tools/phpDocumentor run -vv -d source --target docs --cache-folder phpdoc-cache --template default --title 'Moodle PHP API' --ignore source/lib/pear --ignore source/**/tests/*_test.php --ignore **/tests/fixtures --ignore source/**/vendor --ignore source/**/amd --ignore source/**/yui
+        run: php -d xdebug.mode=off ${{ github.workspace }}/tools/phpDocumentor run -d source --target docs --cache-folder phpdoc-cache --template default --title 'Moodle PHP API'
 
       - name: Count files and get disk space
         run: |

.gitignore

@@ -1,3 +1,5 @@
-build
-Doxygen.*
-logs
+/source
+/docs
+/phpdoc-cache
+/.phive
+/tools

phpdocs/doxygen-filter.php renamed to ideas how to skip other files not worth documenting-doxygen-filter.php

@@ -0,0 +1,36 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpdocumentor xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+               xsi:noNamespaceSchemaLocation="https://www.phpdoc.org/phpDocumentor.xsd"
+               configVersion="3.0">
+
+    <title>Moodle PHP API</title>
+
+    <paths>
+        <output>docs</output>
+        <cache>phpdoc-cache</cache>
+    </paths>
+
+    <template name="default" />
+
+    <version number="4.3">
+        <folder>4.3</folder>
+        <api dsn=".">
+            <source>
+                <path>source</path>
+            </source>
+            <ignore>
+                <path>lib/pear</path>
+                <path>**/tests/*_test.php</path>
+                <path>**/tests/fixtures</path>
+                <path>**/vendor</path>
+                <path>**/amd</path>
+                <path>**/yui</path>
+                <path>**/lang</path>
+            </ignore>
+            <extensions>
+                <extension>php</extension>
+            </extensions>
+        </api>
+    </version>
+
+</phpdocumentor>