From a40103f3461a9dfe54d3dab70d58072e9710dd4e Mon Sep 17 00:00:00 2001
From: didou <didou@localhost>
Date: Tue, 20 Apr 2004 11:27:15 +0000
Subject: [PATCH] added the language-snippets.ent file and started using
 entities for notes under en/programmers/api-functions

---
 docs/en/language-snippets.ent                         | 11 +++++++++++
 .../programmers/api-functions/api-append-by-ref.xml   | 10 +---------
 docs/en/programmers/api-functions/api-append.xml      | 10 +---------
 docs/manual.xml.in                                    |  2 ++
 4 files changed, 15 insertions(+), 18 deletions(-)
 create mode 100644 docs/en/language-snippets.ent

diff --git a/docs/en/language-snippets.ent b/docs/en/language-snippets.ent
new file mode 100644
index 00000000..00877885
--- /dev/null
+++ b/docs/en/language-snippets.ent
@@ -0,0 +1,11 @@
+<!-- $Revision$ -->
+
+<!ENTITY note.parameter.merge '<note>
+ <title>Technical Note</title>
+ <para>
+  The <parameter>merge</parameter> parameter respects array keys, so if
+  you merge two numerically indexed arrays, they may overwrite each other
+  or result in non-sequential keys. This is unlike the array_merge() function
+  of PHP which wipes out numerical keys and renumbers them.
+ </para>
+</note>'>
diff --git a/docs/en/programmers/api-functions/api-append-by-ref.xml b/docs/en/programmers/api-functions/api-append-by-ref.xml
index b2caa1fb..b86e17e3 100644
--- a/docs/en/programmers/api-functions/api-append-by-ref.xml
+++ b/docs/en/programmers/api-functions/api-append-by-ref.xml
@@ -22,15 +22,7 @@
    explanation. If you pass the optional third parameter of true,
    the value will be merged with the current array instead of appended.
   </para>
-  <note>
-   <title>Technical Note</title>
-   <para>
-    The <parameter>merge</parameter> parameter respects array keys, so if 
-    you merge two numerically indexed arrays, they may overwrite each other 
-    or result in non-sequential keys. This is unlike the array_merge() function 
-    of PHP which wipes out numerical keys and renumbers them.
-   </para>
-  </note>
+  &note.parameter.merge;
   <example>
    <title>append_by_ref</title>
    <programlisting role="php">
diff --git a/docs/en/programmers/api-functions/api-append.xml b/docs/en/programmers/api-functions/api-append.xml
index eb0d0bda..6426d6c6 100644
--- a/docs/en/programmers/api-functions/api-append.xml
+++ b/docs/en/programmers/api-functions/api-append.xml
@@ -25,15 +25,7 @@
    parameter of true, the value will be merged with the current array
    instead of appended.
   </para>
-  <note>
-   <title>Technical Note</title>
-   <para>
-    The merge parameter respects array keys, so if you merge two
-    numerically indexed arrays, they may overwrite each other or result in
-    non-sequential keys. This is unlike the array_merge() function of PHP
-    which wipes out numerical keys and renumbers them.
-   </para>
-  </note>
+  &note.parameter.merge;
   <example>
    <title>append</title>
    <programlisting role="php">
diff --git a/docs/manual.xml.in b/docs/manual.xml.in
index bc7e47ef..6194fba1 100644
--- a/docs/manual.xml.in
+++ b/docs/manual.xml.in
@@ -6,8 +6,10 @@
 
 <!-- Add translated specific definitions and snippets -->
 <!ENTITY % language-defs     SYSTEM "@LANG@/language-defs.ent">
+<!ENTITY % language-snippets SYSTEM "@LANG@/language-snippets.ent">
 
 %language-defs;
+%language-snippets;
 
 <!-- Fallback to English definitions and snippets (in case of missing translation) -->
 <!ENTITY % language-defs.default     SYSTEM "en/language-defs.ent">