Replace all @ placeholders

Author: André L F S Bacci

configure.php

@@ -27,6 +27,17 @@
 
 echo "configure.php on PHP " . phpversion() . "\n\n";
 
+// init_argv()
+// init_checks()
+// init_clean()
+// xml_configure()
+// xml_parse()
+// xml_xinclude()
+// xml_validate()
+// phd_sources()
+// phd_version()
+// php_history()
+
 const RNG_SCHEMA_DIR = __DIR__ . DIRECTORY_SEPARATOR . 'docbook' . DIRECTORY_SEPARATOR . 'docbook-v5.2-os' . DIRECTORY_SEPARATOR . 'rng' . DIRECTORY_SEPARATOR;
 const RNG_SCHEMA_FILE = RNG_SCHEMA_DIR . 'docbook.rng';
 const RNG_SCHEMA_XINCLUDE_FILE = RNG_SCHEMA_DIR . 'docbookxi.rng';
@@ -81,6 +92,29 @@ function usage() // {{{
 HELPCHUNK;
 } // }}}
 
+function realpain( string $path , bool $touch = false , bool $mkdir = false ) : string
+{
+    // pain is real
+
+    // care for external XML tools (realpath() everywhere)
+    // care for Windows builds (foward slashes everywhere)
+    // avoid `cd` and chdir() like the plague
+
+    $path = str_replace( "\\" , '/' , $path );
+
+    if ( $mkdir && ! file_exists( $path ) )
+        mkdir( $path , recursive: true );
+
+    if ( $touch && ! file_exists( $path ) )
+        touch( $path );
+
+    $res = realpath( $path );
+    if ( is_string( $res ) )
+        $path = $res;
+
+    return $path;
+}
+
 function errbox($msg) {
     $len = strlen($msg)+4;
     $line = "+" . str_repeat("-", $len) . "+";
@@ -654,6 +688,36 @@ function getFileModificationHistory(): array {
 echo "\n" , trim( $output ) . "\n\n";
 
 
+xml_configure();
+function xml_configure()
+{
+    global $ac;
+    $lang = $ac["LANG"];
+    $base = basename( __DIR__ );
+    $conf = [];
+
+    $conf[] = "<!ENTITY LANG '$lang'>";
+
+    if ( $lang == 'en' )
+    {
+        realpain( __DIR__ . "/temp/empty" , mkdir: true );
+        realpain( __DIR__ . "/temp/empty/language-defs.ent" , touch: true );
+        realpain( __DIR__ . "/temp/empty/language-snippets.ent" , touch: true );
+        realpain( __DIR__ . "/temp/empty/extensions.ent" , touch: true );
+        $conf[] = "<!ENTITY % LANGDIR '$base/empty'>";
+    }
+    else
+        $conf[] = "<!ENTITY % LANGDIR '$lang'>";
+
+    if ( $ac['CHMENABLED'] == 'yes' )
+        $conf[] = "<!ENTITY manual.chmonly SYSTEM './chm/manual.chm.xml'>";
+    else
+        $conf[] = "<!ENTITY manual.chmonly ''>";
+
+    file_put_contents( __DIR__ . "/temp/manual.conf" , implode( "\n" , $conf ) );
+}
+
+
 if ($ac['SEGFAULT_ERROR'] === 'yes') {
     libxml_use_internal_errors(true);
 }

manual.xml

@@ -1,39 +1,36 @@
-<?xml version='1.0' encoding='@ENCODING@' ?>
+<?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE PHPDOC [
-<!-- Add translated specific definitions and snippets -->
-@TRANSLATION_ONLY_INCL_BEGIN@
-<!ENTITY % language-defs     SYSTEM "../@LANGDIR@/language-defs.ent">
-<!ENTITY % language-snippets SYSTEM "../@LANGDIR@/language-snippets.ent">
-<!ENTITY % extensions        SYSTEM "../@LANGDIR@/extensions.ent">
-
-%language-defs;
-%extensions;
-%language-snippets;
-@TRANSLATION_ONLY_INCL_END@
-
-<!-- Fallback to English definitions and snippets (in case of missing translation) -->
-<!ENTITY % language-defs.default     SYSTEM "../@EN_DIR@/language-defs.ent">
-<!ENTITY % language-snippets.default SYSTEM "../@EN_DIR@/language-snippets.ent">
-<!ENTITY % extensions.default        SYSTEM "../@EN_DIR@/extensions.ent">
 
+<!-- Parameter entities used to configure manual.xml -->
+<!ENTITY % configure         SYSTEM "./temp/manual.conf">
+%configure;
+
+<!-- Translation layer, if any -->
+<!ENTITY % translation-defs          SYSTEM "../%LANGDIR;/language-defs.ent">
+<!ENTITY % translation-snippets      SYSTEM "../%LANGDIR;/language-snippets.ent">
+<!ENTITY % translation-extensions    SYSTEM "../%LANGDIR;/extensions.ent">
+%translation-defs;
+%translation-snippets;
+%translation-extensions;
+
+<!-- English manual (also works as fallback layer for incomplete translations) -->
+<!ENTITY % language-defs.default     SYSTEM "../en/language-defs.ent">
+<!ENTITY % language-snippets.default SYSTEM "../en/language-snippets.ent">
+<!ENTITY % extensions.default        SYSTEM "../en/extensions.ent">
 %language-defs.default;
 %extensions.default;
 %language-snippets.default;
 
-<!-- All global entities for the XML files -->
-<!ENTITY % global.entities  SYSTEM "./entities/global.ent">
-
-<!-- These are language independent -->
-<!ENTITY % frontpage.entities SYSTEM "../@EN_DIR@/contributors.ent">
+<!-- Language independent entities, and language dependent file entities -->
+<!ENTITY % global.entities    SYSTEM "./entities/global.ent">
+<!ENTITY % frontpage.entities SYSTEM "../en/contributors.ent">
 <!ENTITY % file.entities      SYSTEM "./temp/file-entities.ent">
-
-<!-- Include all external DTD parts defined previously -->
 %global.entities;
 %file.entities;
 %frontpage.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">
+<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;
 
@@ -464,15 +461,7 @@
    </appendix>
  </book>
 
- @CHMONLY_INCL_BEGIN@
- <book xml:id="chmonly">
-  <title>&CHMEdition;</title>
-  &chmonly.aboutchm;
-  &chmonly.usingchm;
-  &chmonly.search;
-  &chmonly.integration;
- </book>
- @CHMONLY_INCL_END@
+ &manual.chmonly;
 
 </set>