From c54fab8bf92de6ac5a5c1ad3f3fc0347233764b2 Mon Sep 17 00:00:00 2001
From: lacatoire <ext-lacatoire@cenef.fr>
Date: Wed, 5 Aug 2026 13:07:50 +0200
Subject: [PATCH 1/2] Add the main manual links as XML entities, document the
 local build

Cross-references whose target stays in the main manual cannot use a linkend
here, so they go through entities resolving to php.net links, declared as XML
entities under entities/.

The README gains a Creating this setup section for the build outside Docker.
---
 README.md                | 16 ++++++++++++++++
 entities/main-manual.ent | 29 +++++++++++++++++++++++++++++
 2 files changed, 45 insertions(+)
 create mode 100644 entities/main-manual.ent

diff --git a/README.md b/README.md
index 7733dc0..65105f0 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,22 @@ were not carried over from the main manual.
 For general guidance on the documentation format, refer to the
 [contribution guidelines](https://doc.php.net/guide/contributing.md).
 
+## Creating this setup
+
+This manual builds on its own, independently of the main manual. The checkout has
+to be named `extensions`, as that is the directory `configure.php` is pointed at:
+
+```bash
+git clone https://github.com/php/doc-extensions extensions
+git clone https://github.com/php/doc-base
+php doc-base/configure.php --disable-libxml-check --with-base-lang=extensions
+```
+
+For general information related to creating this setup, see the
+[contribution guidelines](https://github.com/php/doc-base/blob/master/docs/contributing.md)
+or [this page](https://doc.php.net/tutorial/local-setup.php) on the documentation
+website.
+
 ## Building With make and Docker
 
 - Install Docker (https://docs.docker.com/get-docker/)
diff --git a/entities/main-manual.ent b/entities/main-manual.ent
new file mode 100644
index 0000000..3e5a796
--- /dev/null
+++ b/entities/main-manual.ent
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+
+Links into the main PHP manual on php.net, for cross-references whose
+targets live in the main manual rather than in this extension manual.
+
+-->
+<entities xmlns       = "http://docbook.org/ns/docbook"
+          xmlns:xlink = "http://www.w3.org/1999/xlink"
+          translate   = "yes">
+
+<entity name="link.install.pecl"><link
+ xlink:href="https://www.php.net/manual/en/install.pecl.php">Installation of
+ PECL extensions</link></entity>
+
+<entity name="link.install.windows.building"><link
+ xlink:href="https://www.php.net/manual/en/install.windows.building.php">building
+ on Windows</link></entity>
+
+<entity name="link.book.libxml"><link
+ xlink:href="https://www.php.net/manual/en/book.libxml.php">libxml</link></entity>
+
+<entity name="link.ref.mcrypt"><link
+ xlink:href="https://www.php.net/manual/en/ref.mcrypt.php">mcrypt</link></entity>
+
+<entity name="link.ref.mhash"><link
+ xlink:href="https://www.php.net/manual/en/ref.mhash.php">mhash</link></entity>
+
+</entities>

From 62747ac4be3ce91aa6661566ea9bc4a7c1cd1401 Mon Sep 17 00:00:00 2001
From: lacatoire <ext-lacatoire@cenef.fr>
Date: Wed, 5 Aug 2026 14:20:10 +0200
Subject: [PATCH 2/2] Add the main manual links as XML entities, document the
 local build

Cross-references whose target stays in the main manual cannot use a linkend
here, so they go through entities resolving to php.net links.

The file follows the format introduced in php/doc-en#5722, and the links are
composed from a url.php.manual.en entity rather than repeating the base URL.

The README gains a Creating this setup section for the build outside Docker.
---
 entities/entities.url.ent | 34 ++++++++++++++++++++++++++++++++++
 entities/main-manual.ent  | 29 -----------------------------
 2 files changed, 34 insertions(+), 29 deletions(-)
 create mode 100644 entities/entities.url.ent
 delete mode 100644 entities/main-manual.ent

diff --git a/entities/entities.url.ent b/entities/entities.url.ent
new file mode 100644
index 0000000..3364311
--- /dev/null
+++ b/entities/entities.url.ent
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="utf-8"?>
+<?do-not-translate?>
+<!--
+
+URLs, other addresses and external references.
+
+Cross-references whose target lives in the main manual go through the link
+entities below, as a linkend has no target in this manual.
+
+-->
+<entities xmlns       = "http://docbook.org/ns/docbook"
+          xmlns:xlink = "http://www.w3.org/1999/xlink"
+          translate   = "yes">
+
+<entity name="url.php.manual.en">https://www.php.net/manual/en/</entity>
+
+<entity name="link.book.libxml"><link
+ xlink:href="&url.php.manual.en;book.libxml.php">libxml</link></entity>
+
+<entity name="link.install.pecl"><link
+ xlink:href="&url.php.manual.en;install.pecl.php">Installation of PECL
+ extensions</link></entity>
+
+<entity name="link.install.windows.building"><link
+ xlink:href="&url.php.manual.en;install.windows.building.php">building
+ on Windows</link></entity>
+
+<entity name="link.ref.mcrypt"><link
+ xlink:href="&url.php.manual.en;ref.mcrypt.php">mcrypt</link></entity>
+
+<entity name="link.ref.mhash"><link
+ xlink:href="&url.php.manual.en;ref.mhash.php">mhash</link></entity>
+
+</entities>
diff --git a/entities/main-manual.ent b/entities/main-manual.ent
deleted file mode 100644
index 3e5a796..0000000
--- a/entities/main-manual.ent
+++ /dev/null
@@ -1,29 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!--
-
-Links into the main PHP manual on php.net, for cross-references whose
-targets live in the main manual rather than in this extension manual.
-
--->
-<entities xmlns       = "http://docbook.org/ns/docbook"
-          xmlns:xlink = "http://www.w3.org/1999/xlink"
-          translate   = "yes">
-
-<entity name="link.install.pecl"><link
- xlink:href="https://www.php.net/manual/en/install.pecl.php">Installation of
- PECL extensions</link></entity>
-
-<entity name="link.install.windows.building"><link
- xlink:href="https://www.php.net/manual/en/install.windows.building.php">building
- on Windows</link></entity>
-
-<entity name="link.book.libxml"><link
- xlink:href="https://www.php.net/manual/en/book.libxml.php">libxml</link></entity>
-
-<entity name="link.ref.mcrypt"><link
- xlink:href="https://www.php.net/manual/en/ref.mcrypt.php">mcrypt</link></entity>
-
-<entity name="link.ref.mhash"><link
- xlink:href="https://www.php.net/manual/en/ref.mhash.php">mhash</link></entity>
-
-</entities>