[DOC-CVS] [doc-en] master: Third-party manual, doc-en side (#5682)

Author: alfsb (alfsb)
Committer: GitHub (web-flow)
Pusher: alfsb
Date: 2026-07-30T19:07:42-03:00

Commit: https://github.com/php/doc-en/commit/32184e34712aa9a56e21f0eab6b2f414757accc8
Raw diff: https://github.com/php/doc-en/commit/32184e34712aa9a56e21f0eab6b2f414757accc8.diff

Third-party manual, doc-en side (#5682)

* Minimal changes to move manual.xml into doc-en.
* Move DOCTYPE configuration into local temp/.
* Finaly, mark manual.xml as do-not-translate.

Changed paths:
  A  manual.xml
  M  .gitignore


Diff:

diff --git a/.gitignore b/.gitignore
index 15671bf14950..2da7b7f512c1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 entities.*.xml
 output
 .docker/built
+temp/
diff --git a/manual.xml b/manual.xml
new file mode 100644
index 000000000000..e111ed75f1e6
--- /dev/null
+++ b/manual.xml
@@ -0,0 +1,484 @@
+<?xml version="1.0" encoding="utf-8"?>
+<?do-not-translate?>
+<!DOCTYPE PHPDOC [
+
+<!ENTITY % configure SYSTEM "./temp/conf.dtd">
+%configure;
+
+%text-entities;
+
+%translation-defs;
+%translation-snippets;
+%translation-extensions;
+
+%language-defs;
+%language-snippets;
+%language-extensions;
+
+%base-entities;
+%file-entities;
+
+]>
+
+<set xmlns="http://docbook.org/ns/docbook" version="5.2" xml:id="index" xml:lang="&LANG;" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>&PHPManual;</title>
+ &bookinfo;
+
+ <book xml:id="manual" annotations="chunk:false">
+  <title>&PHPManual;</title>
+  &preface;
+ </book>
+
+ <book xml:id="getting-started">
+  <title>&GettingStarted;</title>
+  &chapters.intro;
+  &chapters.tutorial;
+ </book>
+
+ <book xml:id="install">
+  <title>&InstallAndConfigure;</title>
+  &install.intro;
+  &install.unix.index;
+  &install.macos.index;
+  &install.windows.index;
+  &install.cloud.index;
+  &install.fpm.index;
+  &install.pecl;
+  &install.composer;
+  &install.pie;
+  &install.ini;
+ </book>
+
+ <book xml:id="langref">
+  <title>&LanguageReference;</title>
+  &language.basic-syntax;
+  &language.types;
+  &language.variables;
+  &language.constants;
+  &language.expressions;
+  &language.operators;
+  &language.control-structures;
+  &language.functions;
+  &language.oop5;
+  &language.namespaces;
+  &language.enumerations;
+  &language.errors;
+  &language.exceptions;
+  &language.fibers;
+  &language.generators;
+  &language.attributes;
+  &language.references;
+  &language.predefined.variables;
+  &language.predefined.exceptions;
+  &language.predefined.interfaces;
+  &language.predefined.attributes;
+  &language.context;
+  &language.wrappers;
+ </book>
+
+ <book xml:id="security">
+  <title>&Security;</title>
+  &security.intro;
+  &security.general;
+  &security.cgi-bin;
+  &security.apache;
+  &security.sessions;
+  &security.filesystem;
+  &security.database;
+  &security.errors;
+  &security.variables;
+  &security.hiding;
+  &security.current;
+ </book>
+
+ <book xml:id="features">
+  <title>&Features;</title>
+  &features.http-auth;
+  &features.cookies;
+  &features.sessions;
+  &features.file-upload;
+  &features.remote-files;
+  &features.connection-handling;
+  &features.persistent-connections;
+  &features.commandline;
+  &features.gc;
+  &features.dtrace;
+ </book>
+
+ <set xml:id="funcref">
+  <title>&FunctionReference;</title>
+  <info xmlns="http://docbook.org/ns/docbook" xml:id="funcrefinfo">
+   <abstract>
+    <para>
+     <tip>
+      <simpara>
+       &Seealso; <xref linkend="extensions" />.
+      </simpara>
+     </tip>
+    </para>
+   </abstract>
+  </info>
+
+  <set xml:id="refs.basic.php">
+   <title>&AffectingPHPsBehaviour;</title>
+   &reference.apcu.book;
+   &reference.componere.book;
+   &reference.errorfunc.book;
+   &reference.ffi.book;
+   &reference.opcache.book;
+   &reference.operator.book;
+   &reference.outcontrol.book;
+   &reference.info.book;
+   &reference.phpdbg.book;
+   &reference.runkit7.book;
+   &reference.uopz.book;
+   &reference.wincache.book;
+   &reference.xhprof.book;
+   &reference.yac.book;
+  </set>
+
+  <set xml:id="refs.utilspec.audio">
+   <title>&AudioFormatsManipulation;</title>
+   &reference.openal.book;
+  </set>
+
+  <set xml:id="refs.remote.auth">
+   <title>&AuthenticationServices;</title>
+   &reference.radius.book;
+  </set>
+
+  <set xml:id="refs.utilspec.cmdline">
+   <title>&CommandLineSpecificExtensions;</title>
+   &reference.readline.book;
+  </set>
+
+  <set xml:id="refs.compression">
+   <title>&CompressionExtensions;</title>
+   &reference.bzip2.book;
+   &reference.lzf.book;
+   &reference.phar.book;
+   &reference.rar.book;
+   &reference.zip.book;
+   &reference.zlib.book;
+  </set>
+
+  <set xml:id="refs.crypto">
+   <title>&CryptographyExtensions;</title>
+   &reference.hash.book;
+   &reference.mcrypt.book;
+   &reference.mhash.book;
+   &reference.openssl.book;
+   &reference.password.book;
+   &reference.rnp.book;
+   &reference.sodium.book;
+   &reference.xpass.book;
+  </set>
+
+  <set xml:id="refs.database">
+   <title>&DatabaseExtensions;</title>
+
+   <set xml:id="refs.database.abstract">
+    <title>&AbstractionLayers;</title>
+    &reference.dba.book;
+    &reference.uodbc.book;
+    &reference.pdo.book;
+   </set>
+
+   <set xml:id="refs.database.vendors">
+    <title>&VendorSpecificDatabaseExtensions;</title>
+    &reference.cubrid.book;
+    &reference.dbase.book;
+    &reference.ibase.book;
+    &reference.ibm-db2.book;
+    &reference.mongodb.book;
+    &reference.mysqlinfo.set;
+    &reference.oci8.book;
+    &reference.pgsql.book;
+    &reference.sqlite3.book;
+    &reference.sqlsrv.book;
+   </set>
+  </set>
+
+  <set xml:id="refs.calendar">
+   <title>&CalendarandEventRelatedExtensions;</title>
+   &reference.calendar.book;
+   &reference.datetime.book;
+   &reference.hrtime.book;
+  </set>
+
+  <set xml:id="refs.fileprocess.file">
+   <title>&FileSystemRelatedExtensions;</title>
+   &reference.dio.book;
+   &reference.dir.book;
+   &reference.fileinfo.book;
+   &reference.filesystem.book;
+   &reference.inotify.book;
+   &reference.xattr.book;
+   &reference.xdiff.book;
+  </set>
+
+  <set xml:id="refs.international">
+   <title>&HumanLanguageandCharacterEncodingSupport;</title>
+   &reference.enchant.book;
+   &reference.gender.book;
+   &reference.gettext.book;
+   &reference.iconv.book;
+   &reference.intl.book;
+   &reference.mbstring.book;
+   &reference.pspell.book;
+   &reference.recode.book;
+  </set>
+
+  <set xml:id="refs.utilspec.image">
+   <title>&ImageProcessingandGeneration;</title>
+   &reference.exif.book;
+   &reference.image.book;
+   &reference.gmagick.book;
+   &reference.imagick.book;
+  </set>
+
+  <set xml:id="refs.remote.mail">
+   <title>&MailRelatedExtensions;</title>
+   &reference.imap.book;
+   &reference.mail.book;
+   &reference.mailparse.book;
+  </set>
+
+  <set xml:id="refs.math">
+   <title>&MathematicalExtensions;</title>
+   &reference.bc.book;
+   &reference.gmp.book;
+   &reference.math.book;
+   &reference.stats.book;
+   &reference.trader.book;
+  </set>
+
+  <set xml:id="refs.utilspec.nontext">
+   <title>&NonTextMIMEOutput;</title>
+   &reference.fdf.book;
+   &reference.gnupg.book;
+   &reference.wkhtmltox.book;
+   &reference.ps.book;
+   &reference.rpminfo.book;
+   &reference.xlswriter.book;
+  </set>
+
+  <set xml:id="refs.fileprocess.process">
+   <title>&ProcessControlExtensions;</title>
+   &reference.eio.book;
+   &reference.ev.book;
+   &reference.expect.book;
+   &reference.pcntl.book;
+   &reference.posix.book;
+   &reference.exec.book;
+   &reference.parallel.book;
+   &reference.pthreads.book;
+   &reference.sem.book;
+   &reference.shmop.book;
+   &reference.sync.book;
+  </set>
+
+  <set xml:id="refs.basic.other">
+   <title>&OtherBasicExtensions;</title>
+   &reference.geoip.book;
+   &reference.fann.book;
+   &reference.igbinary.book;
+   &reference.json.book;
+   &reference.simdjson.book;
+   &reference.lua.book;
+   &reference.luasandbox.book;
+   &reference.misc.book;
+   &reference.random.book;
+   &reference.seaslog.book;
+   &reference.spl.book;
+   &reference.stream.book;
+   &reference.swoole.book;
+   &reference.tidy.book;
+   &reference.tokenizer.book;
+   &reference.uri.book;
+   &reference.url.book;
+   &reference.v8js.book;
+   &reference.yaml.book;
+   &reference.yaf.book;
+   &reference.yaconf.book;
+   &reference.taint.book;
+   &reference.ds.book;
+   &reference.var-representation.book;
+  </set>
+
+  <set xml:id="refs.remote.other">
+   <title>&OtherServices;</title>
+   &reference.curl.book;
+   &reference.event.book;
+   &reference.ftp.book;
+   &reference.gearman.book;
+   &reference.ldap.book;
+   &reference.memcache.book;
+   &reference.memcached.book;
+   &reference.mqseries.book;
+   &reference.network.book;
+   &reference.rrd.book;
+   &reference.scoutapm.book;
+   &reference.snmp.book;
+   &reference.sockets.book;
+   &reference.ssh2.book;
+   &reference.stomp.book;
+   &reference.svm.book;
+   &reference.svn.book;
+   &reference.tcpwrap.book;
+   &reference.varnish.book;
+   &reference.yaz.book;
+   &reference.zmq.book;
+   &reference.zookeeper.book;
+  </set>
+
+  <set xml:id="refs.search">
+   <title>&SearchEngineExtensions;</title>
+   &reference.solr.book;
+  </set>
+
+  <set xml:id="refs.utilspec.server">
+   <title>&ServerSpecificExtensions;</title>
+   &reference.apache.book;
+   &reference.litespeed.book;
+   &reference.fpm.book;
+  </set>
+
+  <set xml:id="refs.basic.session">
+   <title>&SessionExtensions;</title>
+   &reference.session.book;
+  </set>
+
+  <set xml:id="refs.basic.text">
+   <title>&TextProcessing;</title>
+   &reference.cmark.book;
+   &reference.parle.book;
+   &reference.pcre.book;
+   &reference.ssdeep.book;
+   &reference.strings.book;
+  </set>
+
+  <set xml:id="refs.basic.vartype">
+   <title>&VariableandTypeRelatedExtensions;</title>
+   &reference.array.book;
+   &reference.classobj.book;
+   &reference.ctype.book;
+   &reference.filter.book;
+   &reference.funchand.book;
+   &reference.quickhash.book;
+   &reference.reflection.book;
+   &reference.var.book;
+  </set>
+
+  <set xml:id="refs.webservice">
+   <title>&WebServices;</title>
+   &reference.oauth.book;
+   &reference.soap.book;
+   &reference.yar.book;
+   &reference.xmlrpc.book;
+  </set>
+
+  <set xml:id="refs.utilspec.windows">
+   <title>&WindowsOnlyExtensions;</title>
+   &reference.com.book;
+   &reference.win32service.book;
+  </set>
+
+  <set xml:id="refs.xml">
+   <title>&XMLManipulation;</title>
+   &reference.dom.book;
+   &reference.libxml.book;
+   &reference.simplexml.book;
+   &reference.wddx.book;
+   &reference.xmldiff.book;
+   &reference.xml.book;
+   &reference.xmlreader.book;
+   &reference.xmlwriter.book;
+   &reference.xsl.book;
+  </set>
+
+  <set xml:id="refs.ui">
+   <title>&UIExtensions;</title>
+   &reference.ui.book;
+  </set>
+ </set>
+
+ <book xml:id="faq">
+  <title>&FAQ;</title>
+  <titleabbrev>&FAQabbrev;</titleabbrev>
+  &faq.general;
+  &faq.mailinglist;
+  &faq.obtaining;
+  &faq.databases;
+  &faq.installation;
+  &faq.build;
+  &faq.using;
+  &faq.passwords;
+  &faq.html;
+  &faq.com;
+  &faq.misc;
+ </book>
+
+ <book xml:id="appendices">
+  <title>&Appendices;</title>
+  &appendices.history;
+  &appendices.examples;
+  &appendices.migration85;
+  &appendices.migration84;
+  &appendices.migration83;
+  &appendices.migration82;
+  &appendices.migration81;
+  &appendices.migration80;
+  &appendices.migration74;
+  &appendices.migration73;
+  &appendices.migration72;
+  &appendices.migration71;
+  &appendices.migration70;
+  &appendices.migration56;
+  &appendices.debugger;
+  &appendices.configure.index;
+  &appendices.ini;
+  &appendices.extensions;
+  &appendices.aliases;
+  &appendices.reserved;
+  &appendices.resources;
+  &appendices.filters;
+  &appendices.transports;
+  &appendices.comparisons;
+  &appendices.tokens;
+  &appendices.userlandnaming;
+  &appendices.about;
+  &appendices.license;
+  &global.function-index;
+  <appendix xmlns="http://docbook.org/ns/docbook" xml:id="doc.changelog">
+   <title>&ChangelogListingTitle;</title>
+    <para>&ChangelogListingBundledDescription;</para>
+    <?phpdoc changelog-config-since="5.0.0" ?>
+    <?phpdoc generate-changelog-for-membership="core bundled bundledexternal" ?>
+   </appendix>
+ </book>
+
+ &manual.chmonly;
+
+</set>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->