ci: analyse and show overfull hbox(es)

and upload a second artifact containing pdf and all aux files

Signed-off-by: Yukai Chou <[email protected]>

.github/workflows/doc.yml

@@ -29,11 +29,33 @@ jobs:
       run: |
         l3build doc -q
 
-    - uses: actions/upload-artifact@v4
+    - name: Analyse manual log and create annotation(s)
+      run: |
+        # setting a notice message:
+        #  https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions?tool=bash#setting-a-notice-message
+        # trick to create multiline annotation:
+        #  use url-encoded newline %0A
+        #  https://github.com/actions/toolkit/issues/193#issuecomment-605394935
+        OVERFULL_HBOX=$(
+          grep -r '^Overfull \\hbox' build/doc/pgfmanual.log |
+          awk 'BEGIN {RS=""}{gsub(/\n/,"%0A",$0); print $0}'
+        )
+        echo "::notice file=build/doc/pgfmanual.log,title=Overfull hbox(es)::$OVERFULL_HBOX"
+
+    - name: Upload manual
+      uses: actions/upload-artifact@v4
       with:
         name: pgfmanual
         path: build/doc/pgfmanual.pdf
 
+    - name: Upload manual with aux files
+      uses: actions/upload-artifact@v4
+      with:
+        name: pgfmanual-with-aux
+        path: |
+          build/doc/pgfmanual.*
+          !build/doc/pgfmanual.tex
+
     - name: Deploy tlcontrib
       env:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}