Deprecate old qaxml tools (#228)

Author: alfsb

scripts/translation/README.md

@@ -142,56 +142,3 @@ php doc-base/scripts/translation/qaxml-tags.php --content=filename
 php doc-base/scripts/translation/qaxml-tags.php --content=literal
 php doc-base/scripts/translation/qaxml-tags.php --content=varname
 ```
-
----
-
-## Old tools (below)
-
-Document below is the previous version of these tools. These tools are
-deprecated, and scheduled for remotion very soon.
-
-
-These old tools needed to be separated configured, before use:
-```
-php doc-base/scripts/translation/configure.php $LANG_DIR
-```
-
-## qarvt.php
-
-`qarvt.a.php` checks if all translated files have revtags in the
-expected format.
-
-## qaxml.a.php
-
-`qaxml.a.php` checks if all updated translated files have
-the same tag-attribute-value triplets. Tag's attributes are extensively
-utilized in manual for linking and XIncluding. Translated files with
-missing or mistyped attributes may cause build failing or missing
-parts, not copied by XIncludes.
-
-## qaxml.e.php
-
-`qaxml.e.php` checks if all updated translated files have
-the same external entities as the original files. Unbalanced entities
-may indicate mistyped or wrongly translated parts.
-
-## qaxml.p.php
-
-`qaxml.p.php` checks if all updated translated files have
-the same processing instructions as the original files. Unbalanced PIs
-may cause compilation errors, as they are utilized in the manual build
-process.
-
-## qaxml.t.php
-
-`qaxml.t.php` checks if all updated translated files have
-the same tags as the original files. Different number of tags between
-source texts and target translations may cause compilation errors.
-
-Usage: `php qaxml.t.php [--detail] [tag[,tag]]`
-
-`[tag[,tag]]` is a comma separated tag list to check their
-contents, as some tag contents are expected *not* be translated.
-
-`--detail` will also print line definitions of each mismatched tag,
-to facilitate bitsecting.

scripts/translation/qaxml.a.php

@@ -17,6 +17,10 @@
  *  +----------------------------------------------------------------------+
  */
 
+echo "This tool is obsolete and will be REMOVED soon.\n";
+echo "See https://github.com/php/doc-base/blob/master/scripts/translation/README.md\n";
+echo "for alternatives.\n\n".
+
 require_once __DIR__ . '/lib/all.php';
 
 $qalist = QaFileInfo::cacheLoad();

scripts/translation/qaxml.e.php

@@ -17,6 +17,10 @@
  *  +----------------------------------------------------------------------+
  */
 
+echo "This tool is obsolete and will be REMOVED soon.\n";
+echo "See https://github.com/php/doc-base/blob/master/scripts/translation/README.md\n";
+echo "for alternatives.\n\n".
+
 require_once __DIR__ . '/lib/all.php';
 
 $qalist = QaFileInfo::cacheLoad();

scripts/translation/qaxml.p.php

@@ -17,6 +17,10 @@
  *  +----------------------------------------------------------------------+
  */
 
+echo "This tool is obsolete and will be REMOVED soon.\n";
+echo "See https://github.com/php/doc-base/blob/master/scripts/translation/README.md\n";
+echo "for alternatives.\n\n".
+
 require_once __DIR__ . '/lib/all.php';
 
 $qalist = QaFileInfo::cacheLoad();

scripts/translation/qaxml.t.php

@@ -17,6 +17,10 @@
  *  +----------------------------------------------------------------------+
  */
 
+echo "This tool is obsolete and will be REMOVED soon.\n";
+echo "See https://github.com/php/doc-base/blob/master/scripts/translation/README.md\n";
+echo "for alternatives.\n\n".
+
 require_once __DIR__ . '/lib/all.php';
 
 $tags = [];

scripts/translation/qaxml.w.php

@@ -17,6 +17,10 @@
  *  +----------------------------------------------------------------------+
  */
 
+echo "This tool is obsolete and will be REMOVED soon.\n";
+echo "See https://github.com/php/doc-base/blob/master/scripts/translation/README.md\n";
+echo "for alternatives.\n\n".
+
 require_once __DIR__ . '/lib/all.php';
 
 $qalist = QaFileInfo::cacheLoad();
@@ -41,7 +45,7 @@ function whitespaceCheckFile( string $filename )
 
     $xml = XmlUtil::loadFile( $filename );
     $tags = XmlUtil::listNodeType( $xml , XML_ELEMENT_NODE );
-    
+
     foreach( $tags as $node )
     {
         switch ( $node->nodeName )
@@ -64,4 +68,3 @@ function whitespaceCheckFile( string $filename )
 
     $output->print();
 }
-