ci test: add sniffer for docbook (Do not merge!)

.github/workflows/docbook-cs.yml

@@ -0,0 +1,94 @@
+# https://docs.github.com/en/actions
+
+name: "DocBook Lint"
+
+on:
+  push:
+    branches:
+      - "master"
+  pull_request:
+    branches:
+      - "master"
+
+permissions:
+  contents: "read"
+
+concurrency:
+  group: "${{ github.workflow }}-${{ github.ref }}"
+  cancel-in-progress: true
+
+jobs:
+  docbook-cs:
+    name: "DocBook Style Check"
+    runs-on: "ubuntu-latest"
+
+    strategy:
+      matrix:
+        language:
+          - "en"
+
+    steps:
+      - name: "Checkout php/doc-${{ matrix.language }}"
+        uses: "actions/checkout@v6"
+        with:
+          ref: "${{ github.event.pull_request.head.sha }}"
+          path: "${{ matrix.language }}"
+          fetch-depth: 50
+
+      - name: "Checkout php/doc-base"
+        uses: "actions/checkout@v6"
+        with:
+          path: "doc-base"
+          repository: "php/doc-base"
+
+      - name: "Fetch base branch with merge-base"
+        working-directory: "${{ matrix.language }}"
+        run: |
+          git fetch origin ${{ github.base_ref }} --depth=50
+          # Deepen until we find the merge-base (handles long-lived PRs)
+          for i in 1 2 3 4 5; do
+            if git merge-base origin/${{ github.base_ref }} HEAD >/dev/null 2>&1; then
+              break
+            fi
+            git fetch --deepen=100 origin ${{ github.base_ref }}
+          done
+
+      - name: "Setup PHP"
+        uses: "shivammathur/setup-php@v2"
+        with:
+          php-version: "8.5"
+          extensions: "dom, libxml, simplexml"
+          tools: composer:v2, cs2pr:^1.8
+
+      - name: "Build documentation"
+        run: |
+          php doc-base/configure.php \
+            --disable-libxml-check \
+            --enable-xml-details \
+            --redirect-stderr-to-stdout \
+            --with-lang=${{ matrix.language }}
+
+      - name: "Install docbook-cs"
+        working-directory: "${{ matrix.language }}"
+        run: composer require jordikroon/docbook-cs:^1.1
+
+      - name: "Run docbook-cs with diff"
+        working-directory: "${{ matrix.language }}"
+        run: |
+          set -o pipefail
+          git diff origin/${{ github.base_ref }}...HEAD | vendor/bin/docbook-cs \
+            --report=checkstyle \
+            --diff \
+            --no-colors > docbook-report.xml || true
+
+      - name: "Upload report"
+        if: ${{ ! cancelled() }}
+        uses: "actions/upload-artifact@v7"
+        with:
+          name: "docbook-report"
+          path: "${{ matrix.language }}/docbook-report.xml"
+
+      - name: "Annotate PR with violations"
+        if: ${{ ! cancelled() }}
+        working-directory: "${{ matrix.language }}"
+        run: cs2pr docbook-report.xml --colorize --prepend-filename

docbookcs.xml

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<docbookcs xmlns="https://jordikroon.github.io/docbook-cs/config"
+           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+           xsi:schemaLocation="https://jordikroon.github.io/docbook-cs/config
+                               https://jordikroon.github.io/docbook-cs/config.xsd">
+
+ <project>
+  <directory alias="doc-en">en</directory>
+  <directory>doc-base</directory>
+ </project>
+
+ <sniffs>
+  <sniff class="DocbookCS\Sniff\SimparaSniff" />
+  <sniff class="DocbookCS\Sniff\ExceptionNameSniff" />
+  <sniff class="DocbookCS\Sniff\AttributeOrderSniff" />
+  <sniff class="DocbookCS\Sniff\WhitespaceSniff" />
+ </sniffs>
+
+ <paths>
+  <path>.</path>
+ </paths>
+
+ <entities>
+  <file>contributors.ent</file>
+  <file>extensions.ent</file>
+  <file>language-defs.ent</file>
+  <file>language-snippets.ent</file>
+  <directory>../doc-base/entities/</directory>
+  <file>../doc-base/temp/file-entities.ent</file>
+  <directory>../doc-base/temp/file-entities</directory>
+ </entities>
+
+ <exclude>
+  <pattern>*/wkhtmltox/bits/*</pattern>
+  <pattern>output/*</pattern>
+ </exclude>
+
+</docbookcs>

faq/com.xml

@@ -1,24 +1,23 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
- <chapter xml:id="faq.com" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <chapter xmlns="http://docbook.org/ns/docbook" xml:id="faq.com" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>PHP and COM</title>
   <titleabbrev>PHP and COM</titleabbrev>
 
    <para>
-    PHP can be used to access COM and DCOM objects on Win32 platforms.
+    This should be simpara
    </para>
 
   <qandaset>
    <qandaentry xml:id="faq.com.q1">
     <question>
      <para>
-      I have built a DLL to calculate something. Is there any way to run this DLL under PHP?
+      This also should be simpara
      </para>
     </question>
     <answer>
      <para>
-      If this is a simple DLL there is no way yet to run it from PHP. If the DLL contains a COM
-      server you may be able to access it if it implements the IDispatch interface.
+      Also this should not be a <classname>ValueError</classname>.
      </para>
     </answer>
    </qandaentry>

faq/databases.xml

@@ -4,18 +4,16 @@
   <title>Database issues</title>
   <titleabbrev>Database issues</titleabbrev>
 
   <para>
-   This section holds common questions about relation between
-   PHP and databases. Yes, PHP can access virtually any
-   database available today.
+   This file has been changed.
   </para>
 
   <qandaset>
    <qandaentry xml:id="faq.databases.mssql">
     <question>
-     <para>
-      I heard it's possible to access Microsoft SQL Server from PHP. How?
-     </para>
+     <simpara>
+      This also, but it's correct
+     </simpara>
     </question>
     <answer>
      <para>

faq/installation.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
- <chapter xml:id="faq.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <chapter xmlns="http://docbook.org/ns/docbook" xml:id="faq.installation" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Installation</title>
   <titleabbrev>Installation</titleabbrev>
 

install/pecl.xml

@@ -3,7 +3,7 @@
 
 <chapter xml:id="install.pecl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Installation of PECL extensions</title>
-
+ 
  <sect1 xml:id="install.pecl.intro">
   <title>Introduction to PECL Installations</title>
   &pecl.moving.to.pie;
@@ -12,7 +12,7 @@
    <link xlink:href="&url.php.pear;">PEAR</link>
    packaging system.
    This section of the manual is intended to demonstrate how to obtain and
-   install PECL extensions.
+   install PECL extensions. 
   </simpara>
   <simpara>
    These instructions assume <literal>/path/to/php/src/dir/</literal> is the