Manual infra-estructure

[alfsb]

Planned changes, big and small, that affect manual infrastructure and languages.

Recheck

• Single source revcheck (Revcheck library and QA tools for translation synchronization  #111 Single source revcheck code/data #174 Remove backported revcheck compatibility #176 Rewrite and document git log parsing #180)
• Sequential [skip-revcheck] (Avoid marking files as outdated on multiple [skip-revcheck] #178)
• Accidental [skip-revcheck] (Only checks for [skip-revcheck] at start of commit messages #181)

Configure

• List of active languages on `doc-base (New tool local language repositories #186)
• Nested/recursive XIncludes (Recursive XInclude support and some automatix fixups for translations #194)
• XInclude failures less fatal on translations (Document and complement XInclude failures as warnings on translations #196)
• XInclude by xml:id (XInclude by xml:id  #198)
• XML Entities (XML Entities, individual and grouped #183)
• Split language-snippets.ent
• Convert all other .ent files to normal XML
• Loads and saves an manual.xml with recover = true, if first loading failed
• Integrate qaxml.php as XML post validation

Idempotent build

• Create doc-base/temp and .gitkeep it (Idempotent build: doc-base/temp #200)
• Rewrite file-entities.ent.in to use temp/ (Idempotent build: file-entities.php #201)
• Change configure.php to be a little more idempotent (Idempotent build: configure.php #202)
• Change manual.xml.in into stable manual.xml (Idempotent build: manual.xml.in  #210)
• Move .manual.xml to temp/ (coordinated)
• Move all remaining .gitignore entries to temp/ (coordinated)

Performance/tools

• Extricate qaxml tools from lib revcheck
• Test and modify qaxml tools to be used in more languages
• Move generation of sources.xml outside and after validation on configure.php
• Move generation of version.xml outside and after validation on configure.php
• R&D alternative for file entities/inclusions (may affect XInclude)

Clean up / TODOs

• Trim local repository status on configure.php (Show non default branch in git status #205)
• Remove $mixin from doc-base/scripts/file-entities.php (Windows related changes, ahead/behind only current branch #207)
• Remove BACKPORT from doc-base/scripts/file-entities.php
• Rewrote $mixin as an check/error on all OS

---

Not discussed, just a list of dreams and/or pet peeves

• Make <?phpdoc more general
• Remove all mentions of <xi:fallback>, XML and code
• Remove all manually edited <!ENTITY> files
• Mentoring translations about XInclude failures and qaxml alerts