migrate acronyms from global.ent

Author: jordikroon

entities/entities.acronyms.ent

@@ -5,9 +5,15 @@
 This is a translatable XML Entity file.
 See doc-base/scripts/text-entities.php for details.
 
-Each acronym of the manual is defined here as an entity named
-acronym.expansion.<term>, where <term> is the exact text used
-inside <acronym> tags.
+Everything about acronyms resides in this file, as two kinds of
+entities:
+
+- Acronym definitions, entities named after the acronym itself
+  (for example &php;), which render the term wrapped in an
+  <acronym> tag;
+- Acronym expansions, entities named acronym.expansion.<term>,
+  where <term> is the exact text used inside <acronym> tags,
+  holding the expanded meaning of the term.
 
 Besides being collected by text-entities.php like any other
 entity file, this file is also read directly, as a plain XML
@@ -20,19 +26,67 @@ document, by automated tools:
 
 Because of these direct uses, some extra restrictions apply:
 
-- Entity contents must be plain text: no child XML elements and
-  no references to other entities;
-- Only acronym.expansion.* entities belong in this file; entities
-  with other names are ignored by the tools above.
+- The contents of acronym.expansion.* entities must be plain
+  text: no child XML elements;
+- No entity in this file may contain references to other
+  entities;
+- Entities that are not acronym definitions or expansions do not
+  belong in this file, and are ignored by the tools above.
 
-All acronyms should be listed in alphabetical order.
+Both groups should be listed in alphabetical order.
 
 -->
 
 <entities xmlns       = "http://docbook.org/ns/docbook"
           xmlns:xlink = "http://www.w3.org/1999/xlink"
           translate   = "yes">
 
+<!-- Acronym definitions -->
+
+<entity name="api"><acronym>API</acronym></entity>
+<entity name="ascii"><acronym>ASCII</acronym></entity>
+<entity name="ca"><acronym>CA</acronym></entity>
+<entity name="cgi"><acronym>CGI</acronym></entity>
+<entity name="cli"><acronym>CLI</acronym></entity>
+<entity name="cli.sapi"><acronym>CLI</acronym> <acronym>SAPI</acronym></entity>
+<entity name="curl"><acronym>cURL</acronym></entity>
+<entity name="der"><acronym>DER</acronym></entity>
+<entity name="dns"><acronym>DNS</acronym></entity>
+<entity name="dom"><acronym>DOM</acronym></entity>
+<entity name="fpm"><acronym>FPM</acronym></entity>
+<entity name="ftp"><acronym>FTP</acronym></entity>
+<entity name="ftps"><acronym>FTPS</acronym></entity>
+<entity name="hmac"><acronym>HMAC</acronym></entity>
+<entity name="hsts"><acronym>HSTS</acronym></entity>
+<entity name="html"><acronym>HTML</acronym></entity>
+<entity name="http"><acronym>HTTP</acronym></entity>
+<entity name="https"><acronym>HTTPS</acronym></entity>
+<entity name="ip"><acronym>IP</acronym></entity>
+<entity name="ipv4"><acronym>IPv4</acronym></entity>
+<entity name="ipv6"><acronym>IPv6</acronym></entity>
+<entity name="json"><acronym>JSON</acronym></entity>
+<entity name="ldap"><acronym>LDAP</acronym></entity>
+<entity name="pdo"><acronym>PDO</acronym></entity>
+<entity name="pem"><acronym>PEM</acronym></entity>
+<entity name="phar"><acronym>Phar</acronym></entity>
+<entity name="php"><acronym>PHP</acronym></entity>
+<entity name="pop3"><acronym>POP3</acronym></entity>
+<entity name="rtsp"><acronym>RTSP</acronym></entity>
+<entity name="sapi"><acronym>SAPI</acronym></entity>
+<entity name="sftp"><acronym>SFTP</acronym></entity>
+<entity name="smtp"><acronym>SMTP</acronym></entity>
+<entity name="spl"><acronym>SPL</acronym></entity>
+<entity name="ssh"><acronym>SSH</acronym></entity>
+<entity name="ssl"><acronym>SSL</acronym></entity>
+<entity name="tcp"><acronym>TCP</acronym></entity>
+<entity name="tls"><acronym>TLS</acronym></entity>
+<entity name="udp"><acronym>UDP</acronym></entity>
+<entity name="uri"><acronym>URI</acronym></entity>
+<entity name="url"><acronym>URL</acronym></entity>
+<entity name="xml"><acronym>XML</acronym></entity>
+
+<!-- Acronym expansions -->
+
 <entity name="acronym.expansion.AKA">Also Known As</entity>
 <entity name="acronym.expansion.API">Application Programming Interface</entity>
 <entity name="acronym.expansion.ASCII">American Standard Code for Information Interchange</entity>