diff --git a/contributors.ent b/contributors.ent deleted file mode 100644 index efa9ec9ce992..000000000000 --- a/contributors.ent +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - diff --git a/docbookcs.xml b/docbookcs.xml index a5f428f2483d..7c874f321686 100644 --- a/docbookcs.xml +++ b/docbookcs.xml @@ -21,7 +21,6 @@ - contributors.ent extensions.ent language-defs.ent language-snippets.ent diff --git a/entities/entities-remove.ent b/entities/entities-remove.ent new file mode 100644 index 000000000000..254047bc4f2d --- /dev/null +++ b/entities/entities-remove.ent @@ -0,0 +1,44 @@ + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/entities/entities.ent b/entities/entities.ent new file mode 100644 index 000000000000..f38152e10545 --- /dev/null +++ b/entities/entities.ent @@ -0,0 +1,35 @@ + + + + + + + + Extension List/Categorization + This appendix categorizes more than 150 extensions documented + in the PHP Manual by several criteria. + + +Alphabetical +Alphabetical + + diff --git a/language-snippets.ent b/language-snippets.ent index fbac1d5b12cb..2558eae27747 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -4,8 +4,6 @@ -4.2.0The random -number generator is seeded automatically.'> This feature has been @@ -92,9 +90,6 @@ do not support some characters in filenames, namely <|>*?":'> -Instead of a function name, an -array containing an object reference and a method name can also be -supplied.'> Callbacks registered with functions such as call_user_func and call_user_func_array will not be @@ -254,10 +249,6 @@ xmlns="http://docbook.org/ns/docbook">This feature has been DEPRECATED as of PHP 5.3.0. Relying on this feature is highly discouraged.'> -This feature has been -DEPRECATED as of PHP 5.3.0 and REMOVED -as of PHP 5.4.0.'> This function has been @@ -300,10 +291,6 @@ xmlns="http://docbook.org/ns/docbook">This function has been REMOVED as of PHP 7.2.0. Relying on this function is highly discouraged.'> -This feature has been -DEPRECATED as of PHP 7.2.0. Relying on this feature -is highly discouraged.'> This feature has been @@ -340,10 +327,6 @@ xmlns="http://docbook.org/ns/docbook">This feature has been DEPRECATED as of PHP 7.4.0. Relying on this feature is highly discouraged.'> -This function has been -DEPRECATED as of PHP 7.4.0. Relying on this function -is highly discouraged.'> This function has been @@ -447,8 +430,6 @@ xmlns="http://docbook.org/ns/docbook">This function was xmlns="http://docbook.org/ns/docbook">This function was DEPRECATED in PHP 5.3.0, and REMOVED as of PHP 7.0.0.'> -This alias was -DEPRECATED in PHP 5.3.0, and REMOVED as of PHP 7.0.0.'> This feature was @@ -636,9 +617,7 @@ is highly discouraged. Output of the above example in PHP 5:'> -Output of the above example in PHP 5.3:'> -Output of the above example in PHP 5.4:'> Output of the above example in PHP 5.5:'> @@ -1647,9 +1626,6 @@ It is strongly recommended to avoid timezone abbreviations. Every call to a date/time function will generate a E_WARNING if the time zone is not valid. See also date_default_timezone_set'> -5.1.0 -Now issues the E_STRICT and E_NOTICE -time zone errors.'> timestamp @@ -2177,8 +2153,6 @@ or named arguments. This extension has no configuration directives defined in &php.ini;.'> -This extension has no resource types defined.'> -This extension has no constants defined.'> No external libraries are needed to build this extension.'> There is no installation needed to use these functions; they are part of the PHP core.'> diff --git a/reference/entities.md b/reference/entities.md new file mode 100644 index 000000000000..23d34cbeb72e --- /dev/null +++ b/reference/entities.md @@ -0,0 +1,52 @@ +# Per extension entities + +For textual entities, related to specific extensions, new or migrated +from `language-snippets.ent`, please use the following conventions. + +* Use an `ext.` prefix for all entity names; +* Use model file below, for new entities files; +* Place the entities in file named `doc-en/reference/$extension/entities.ent`; +* Keep the entities sorted by name, one empty line separating each entity. + +If the entity is "big" or otherwise difficult to edit in a file +with many others, it is possible to create a individual entity per file, +saved as `doc-en/entities/name.$extension.$entname.xml`, whereas the +content can be any valid [well-balanced +region](https://www.w3.org/TR/xml-fragment/#defn-well-balanced). +DTD entity names are also valid here, but XML declarations are not. + +XML namespaces are to be placed in the root `` element, and +avoided in any `` child. + +To rename existing entities to use the `ext.` prefix, is possible to +create temporary aliases, with the following format: +```xml +&new.name; +``` + +Temporary aliases are better placed in +`doc-en/entities/entities-remove.ent`, to avoid duplicated work in +translations, but are acceptable here too. + +### Example file + +```xml + + + + + + +  Text. +  + + + +``` \ No newline at end of file