From 93426f93ac5354d1687a4f8e59fa97f6627b7c93 Mon Sep 17 00:00:00 2001
From: messju <messju@localhost>
Date: Sun, 8 May 2005 19:47:01 +0000
Subject: [PATCH] applied manual updates from Peter Morgan. he added loads of
 useful crosslinks between related functions and fixed some minors.

---
 docs/en/designers/language-basic-syntax.xml   |  2 +-
 .../language-syntax-functions.xml             |  8 ++++----
 .../language-function-config-load.xml         |  5 +++++
 .../language-function-ldelim.xml              |  1 +
 .../language-function-literal.xml             |  1 +
 docs/en/designers/language-modifiers.xml      |  2 +-
 .../language-modifier-capitalize.xml          |  1 +
 .../language-modifier-count-characters.xml    |  5 +++++
 .../language-modifier-count-paragraphs.xml    |  5 +++++
 .../language-modifier-count-sentences.xml     |  5 +++++
 .../language-modifier-count-words.xml         |  6 ++++++
 .../language-modifier-date-format.xml         |  5 +++--
 .../language-modifier-lower.xml               |  9 +++++++--
 .../language-modifier-upper.xml               |  9 +++++++--
 .../language-variables-smarty.xml             |  2 +-
 .../programmers/api-functions/api-display.xml |  5 +++++
 .../programmers/api-functions/api-fetch.xml   |  5 +++++
 .../api-functions/api-register-object.xml     |  4 ++++
 .../api-functions/api-unregister-object.xml   |  1 +
 .../variable-error-reporting.xml              | 20 ++++++++++---------
 .../api-variables/variable-left-delimiter.xml | 18 ++++++++++-------
 .../variable-right-delimiter.xml              | 18 ++++++++++-------
 docs/entities/global.ent                      |  3 +++
 23 files changed, 104 insertions(+), 36 deletions(-)

diff --git a/docs/en/designers/language-basic-syntax.xml b/docs/en/designers/language-basic-syntax.xml
index 5321b7bd..e0d2e40b 100644
--- a/docs/en/designers/language-basic-syntax.xml
+++ b/docs/en/designers/language-basic-syntax.xml
@@ -5,7 +5,7 @@
  <para>
   All Smarty template tags are enclosed within delimiters. By
   default, these delimiters are <literal>{</literal> and
-  <literal>}</literal>, but they can be changed.
+  <literal>}</literal>, but they can be <link linkend="variable.left.delimiter">changed</link>.
  </para>
  <para>
   For these examples, we will assume that you are using the default
diff --git a/docs/en/designers/language-basic-syntax/language-syntax-functions.xml b/docs/en/designers/language-basic-syntax/language-syntax-functions.xml
index d2bd0b59..08fcd155 100644
--- a/docs/en/designers/language-basic-syntax/language-syntax-functions.xml
+++ b/docs/en/designers/language-basic-syntax/language-syntax-functions.xml
@@ -30,11 +30,11 @@
  <para>
   Both built-in functions and custom functions have the same syntax in
   the templates. Built-in functions are the inner workings of Smarty,
-  such as <command>if</command>, <command>section</command> and
-  <command>strip</command>. They cannot be modified. Custom functions are
+  such as <link linkend="language.function.if"><command>if</command></link>, <link linkend="language.function.section"><command>section</command></link> and
+  <link linkend="language.function.strip"><command>strip</command></link>. They cannot be modified. Custom functions are
   additional functions implemented via plugins. They can be modified to
-  your liking, or you can add new ones. <command>html_options</command> and
-  <command>html_select_date</command> are examples of custom functions.
+  your liking, or you can add new ones. <link linkend="language.function.html.options"><command>html_options</command></link> and
+  <link linkend="language.function.html.select.date"><command>html_select_date</command></link> are examples of custom functions.
  </para>
 </sect1>
 <!-- Keep this comment at the end of the file
diff --git a/docs/en/designers/language-builtin-functions/language-function-config-load.xml b/docs/en/designers/language-builtin-functions/language-function-config-load.xml
index 6262ec1d..b31b42d9 100644
--- a/docs/en/designers/language-builtin-functions/language-function-config-load.xml
+++ b/docs/en/designers/language-builtin-functions/language-function-config-load.xml
@@ -124,6 +124,11 @@
 ]]>
   </programlisting>
  </example>
+
+ <para>
+  See also <link linkend="config.files">Config Files</link> and
+  <link linkend="language.function.config.load">Config Load</link>.
+ </para>
 </sect1>
 
 <!-- Keep this comment at the end of the file
diff --git a/docs/en/designers/language-builtin-functions/language-function-ldelim.xml b/docs/en/designers/language-builtin-functions/language-function-ldelim.xml
index b4e47b7e..e9fe1e75 100644
--- a/docs/en/designers/language-builtin-functions/language-function-ldelim.xml
+++ b/docs/en/designers/language-builtin-functions/language-function-ldelim.xml
@@ -28,6 +28,7 @@
 ]]>
    </screen>
   </example>
+  <para>See also <link linkend="language.escaping">Escaping Smarty Parsing</link> </para>
  </sect1>
 
 <!-- Keep this comment at the end of the file
diff --git a/docs/en/designers/language-builtin-functions/language-function-literal.xml b/docs/en/designers/language-builtin-functions/language-function-literal.xml
index 0226e115..8a054067 100644
--- a/docs/en/designers/language-builtin-functions/language-function-literal.xml
+++ b/docs/en/designers/language-builtin-functions/language-function-literal.xml
@@ -35,6 +35,7 @@
 ]]>
    </programlisting>
   </example>
+  <para>See also <link linkend="language.escaping">Escaping Smarty Parsing</link> </para>
  </sect1>
 
 <!-- Keep this comment at the end of the file
diff --git a/docs/en/designers/language-modifiers.xml b/docs/en/designers/language-modifiers.xml
index ba1fe1f4..8a265aaa 100644
--- a/docs/en/designers/language-modifiers.xml
+++ b/docs/en/designers/language-modifiers.xml
@@ -62,9 +62,9 @@
   $security_settings['MODIFIER_FUNCS']</link>-array.
  </para>
 
+ &designers.language-modifiers.language-modifier-cat;
  &designers.language-modifiers.language-modifier-capitalize;
  &designers.language-modifiers.language-modifier-count-characters;
- &designers.language-modifiers.language-modifier-cat;
  &designers.language-modifiers.language-modifier-count-paragraphs;
  &designers.language-modifiers.language-modifier-count-sentences;
  &designers.language-modifiers.language-modifier-count-words;
diff --git a/docs/en/designers/language-modifiers/language-modifier-capitalize.xml b/docs/en/designers/language-modifiers/language-modifier-capitalize.xml
index b12fbea8..0d223999 100644
--- a/docs/en/designers/language-modifiers/language-modifier-capitalize.xml
+++ b/docs/en/designers/language-modifiers/language-modifier-capitalize.xml
@@ -67,6 +67,7 @@ Next X-Men Film, X3, Delayed.
 ]]>
    </screen>
   </example>
+   <para>See also <link linkend="language.modifier.lower">lower</link> <link linkend="language.modifier.upper">upper</link> </para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/en/designers/language-modifiers/language-modifier-count-characters.xml b/docs/en/designers/language-modifiers/language-modifier-count-characters.xml
index 3505a751..21205731 100644
--- a/docs/en/designers/language-modifiers/language-modifier-count-characters.xml
+++ b/docs/en/designers/language-modifiers/language-modifier-count-characters.xml
@@ -67,6 +67,11 @@ Cold Wave Linked to Temperatures.
 ]]>
    </screen>
   </example>
+   <para>See also <link linkend="language.modifier.count.paragraphs">count_paragraphs</link> 
+   			<link linkend="language.modifier.count.sentences">count_sentences</link>
+			<link linkend="language.modifier.count.words">count_words</link>
+			
+			</para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/en/designers/language-modifiers/language-modifier-count-paragraphs.xml b/docs/en/designers/language-modifiers/language-modifier-count-paragraphs.xml
index d4ed93a0..0ca6235c 100644
--- a/docs/en/designers/language-modifiers/language-modifier-count-paragraphs.xml
+++ b/docs/en/designers/language-modifiers/language-modifier-count-paragraphs.xml
@@ -38,6 +38,11 @@ Man is Fatally Slain. Death Causes Loneliness, Feeling of Isolation.
 ]]>
    </screen>
   </example>
+     <para>See also <link linkend="language.modifier.count.characters">count_characters</link> 
+   			<link linkend="language.modifier.count.sentences">count_sentences</link>
+			<link linkend="language.modifier.count.words">count_words</link>
+			
+			</para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/en/designers/language-modifiers/language-modifier-count-sentences.xml b/docs/en/designers/language-modifiers/language-modifier-count-sentences.xml
index 7de46f5c..f86692b0 100644
--- a/docs/en/designers/language-modifiers/language-modifier-count-sentences.xml
+++ b/docs/en/designers/language-modifiers/language-modifier-count-sentences.xml
@@ -37,6 +37,11 @@ Two Soviet Ships Collide - One Dies. Enraged Cow Injures Farmer with Axe.
 ]]>
    </screen>
   </example>
+       <para>See also <link linkend="language.modifier.count.characters">count_characters</link> 
+   			<link linkend="language.modifier.count.paragraphs">count_paragraphs</link>
+			<link linkend="language.modifier.count.words">count_words</link>
+			
+			</para>
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/en/designers/language-modifiers/language-modifier-count-words.xml b/docs/en/designers/language-modifiers/language-modifier-count-words.xml
index deea7a9e..1610ff30 100644
--- a/docs/en/designers/language-modifiers/language-modifier-count-words.xml
+++ b/docs/en/designers/language-modifiers/language-modifier-count-words.xml
@@ -37,6 +37,12 @@ Dealers Will Hear Car Talk at Noon.
 ]]>
    </screen>
   </example>
+         <para>See also <link linkend="language.modifier.count.characters">count_characters</link> 
+   			<link linkend="language.modifier.count.paragraphs">count_paragraphs</link>
+			<link linkend="language.modifier.count.sentences">count_sentences</link>
+			
+			</para>
+			
 </sect1>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/docs/en/designers/language-modifiers/language-modifier-date-format.xml b/docs/en/designers/language-modifiers/language-modifier-date-format.xml
index cb2a00cb..eed6af9b 100644
--- a/docs/en/designers/language-modifiers/language-modifier-date-format.xml
+++ b/docs/en/designers/language-modifiers/language-modifier-date-format.xml
@@ -203,8 +203,9 @@ Monday, February 5, 2001
    <note>
     <title>Programmers note</title>
     <para>
-     date_format is essentially a wrapper to PHP's strftime()
-     function. You may have more or less conversion specifiers available depending
+     date_format is essentially a wrapper to PHP's
+     <ulink url="&url.php-manual;strftime">strftime()</ulink> function.
+     You may have more or less conversion specifiers available depending
      on your system's strftime() function where PHP was compiled. Check your
      system's manpage for a full list of valid specifiers.
     </para>
diff --git a/docs/en/designers/language-modifiers/language-modifier-lower.xml b/docs/en/designers/language-modifiers/language-modifier-lower.xml
index 2d0b9183..c1226b3a 100644
--- a/docs/en/designers/language-modifiers/language-modifier-lower.xml
+++ b/docs/en/designers/language-modifiers/language-modifier-lower.xml
@@ -37,7 +37,12 @@ two convicts evade noose, jury hung.
 ]]>
    </screen>
   </example>
-</sect1>
+  <para>
+   See also <link linkend="language.modifier.upper">upper</link> and
+   <link linkend="language.modifier.capitalize">Capitalize</link>.
+  </para>
+ </sect1>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -57,4 +62,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
diff --git a/docs/en/designers/language-modifiers/language-modifier-upper.xml b/docs/en/designers/language-modifiers/language-modifier-upper.xml
index adfc9fbe..cf126aa4 100644
--- a/docs/en/designers/language-modifiers/language-modifier-upper.xml
+++ b/docs/en/designers/language-modifiers/language-modifier-upper.xml
@@ -37,7 +37,12 @@ IF STRIKE ISN'T SETTLED QUICKLY IT MAY LAST A WHILE.
 ]]>
    </screen>
   </example>
-</sect1>
+  <para>
+   See also <link linkend="language.modifier.lower">lower</link> and
+   <link linkend="language.modifier.capitalize">capitalize</link>.
+  </para>
+ </sect1>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -57,4 +62,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
diff --git a/docs/en/designers/language-variables/language-variables-smarty.xml b/docs/en/designers/language-variables/language-variables-smarty.xml
index 6ede2ff1..e46f32d9 100644
--- a/docs/en/designers/language-variables/language-variables-smarty.xml
+++ b/docs/en/designers/language-variables/language-variables-smarty.xml
@@ -86,7 +86,7 @@
 		<sect2 id="language.variables.smarty.capture">
 			<title>{$smarty.capture}</title>
 			<para>
-		 	The output captured via {capture}..{/capture} construct can be
+		 	The output captured via 	<link linkend="language.function.capture">{capture}..{/capture}</link> construct can be
 		 	accessed using {$smarty} variable. See section on
 		 	<link linkend="language.function.capture">capture</link> for an example.
 			</para>
diff --git a/docs/en/programmers/api-functions/api-display.xml b/docs/en/programmers/api-functions/api-display.xml
index 8cf31836..f69977fe 100644
--- a/docs/en/programmers/api-functions/api-display.xml
+++ b/docs/en/programmers/api-functions/api-display.xml
@@ -78,8 +78,13 @@ $smarty->display("db:header.tpl");
 ]]>
    </programlisting>
   </example>
+  <para>
+   See also <link linkend="api.fetch">fetch()</link> and
+   <link linkend="api.template.exists">template_exists</link>.
+  </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/docs/en/programmers/api-functions/api-fetch.xml b/docs/en/programmers/api-functions/api-fetch.xml
index 494f5583..d2664ba4 100644
--- a/docs/en/programmers/api-functions/api-fetch.xml
+++ b/docs/en/programmers/api-functions/api-fetch.xml
@@ -61,8 +61,13 @@ echo $output;
     </programlisting>
    </example>
   </para>
+  <para>
+   See also <link linkend="api.display">display()</link> and
+   <link linkend="api.template.exists">template_exists</link>.
+  </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/docs/en/programmers/api-functions/api-register-object.xml b/docs/en/programmers/api-functions/api-register-object.xml
index 7992df4a..64c48922 100644
--- a/docs/en/programmers/api-functions/api-register-object.xml
+++ b/docs/en/programmers/api-functions/api-register-object.xml
@@ -20,8 +20,12 @@
    <link linkend="advanced.features.objects">object section</link>
    of the manual for examples.
   </para>
+  <para>
+   See Also <link linkend="api.unregister.object">unregister_object</link>.
+  </para>
  </refsect1>
 </refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/docs/en/programmers/api-functions/api-unregister-object.xml b/docs/en/programmers/api-functions/api-unregister-object.xml
index 613b0ecf..631ec929 100644
--- a/docs/en/programmers/api-functions/api-unregister-object.xml
+++ b/docs/en/programmers/api-functions/api-unregister-object.xml
@@ -14,6 +14,7 @@
   <para>
    Use this to unregister an object.
   </para>
+ <para>See also <link linkend="api.register.object">register_object</link> <link linkend="advanced.features.objects">object section</link></para>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
diff --git a/docs/en/programmers/api-variables/variable-error-reporting.xml b/docs/en/programmers/api-variables/variable-error-reporting.xml
index 4d99d854..3d71c69f 100644
--- a/docs/en/programmers/api-variables/variable-error-reporting.xml
+++ b/docs/en/programmers/api-variables/variable-error-reporting.xml
@@ -1,14 +1,16 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-     <sect1 id="variable.error.reporting">
-      <title>$error_reporting</title>
-      <para>
-           When this value is set to a non-null-value it's value is
-           used as php's error_reporting-level inside of display() and
-           fetch(). When debugging is enabled this value is ignored
-           and the error-level is left untouched.
-      </para>
+<sect1 id="variable.error.reporting">
+ <title>$error_reporting</title>
+ <para>
+  When this value is set to a non-null-value it's value is used as php's
+  error_reporting-level inside of <link linkend="api.display">display()</link>
+  and <link linkend="api.fetch">fetch()</link>. When <link
+   linkend="chapter.debugging.console">debugging</link> is enabled this value
+  is ignored and the error-level is left untouched.
+ </para>
 </sect1>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -28,4 +30,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
diff --git a/docs/en/programmers/api-variables/variable-left-delimiter.xml b/docs/en/programmers/api-variables/variable-left-delimiter.xml
index 3e2399ba..8ba44a39 100644
--- a/docs/en/programmers/api-variables/variable-left-delimiter.xml
+++ b/docs/en/programmers/api-variables/variable-left-delimiter.xml
@@ -1,12 +1,16 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-     <sect1 id="variable.left.delimiter">
-      <title>$left_delimiter</title>
-      <para>
-       This is the left delimiter used by the template language.
-       Default is "{".			
-      </para>
+<sect1 id="variable.left.delimiter">
+ <title>$left_delimiter</title>
+ <para>
+  This is the left delimiter used by the template language.
+  Default is "{".			
+ </para>
+ <para>
+  See also <link linkend="variable.right.delimiter">$right_delimiter</link>.
+ </para>
 </sect1>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -26,4 +30,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
diff --git a/docs/en/programmers/api-variables/variable-right-delimiter.xml b/docs/en/programmers/api-variables/variable-right-delimiter.xml
index 95316641..33adda66 100644
--- a/docs/en/programmers/api-variables/variable-right-delimiter.xml
+++ b/docs/en/programmers/api-variables/variable-right-delimiter.xml
@@ -1,12 +1,16 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!-- $Revision$ -->
-     <sect1 id="variable.right.delimiter">
-      <title>$right_delimiter</title>
-      <para>
-       This is the right delimiter used by the template language.
-       Default is "}".			
-      </para>
+<sect1 id="variable.right.delimiter">
+ <title>$right_delimiter</title>
+ <para>
+  This is the right delimiter used by the template language.
+  Default is "}".			
+ </para>
+ <para>
+  See also <link linkend="variable.left.delimiter">$left_delimiter</link>.
+ </para>
 </sect1>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -26,4 +30,4 @@ End:
 vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
--->
\ No newline at end of file
+-->
diff --git a/docs/entities/global.ent b/docs/entities/global.ent
index fdc8bc65..bb16918e 100644
--- a/docs/entities/global.ent
+++ b/docs/entities/global.ent
@@ -10,6 +10,9 @@
 <!ENTITY url.php-accelerator 'http://www.php-accelerator.co.uk'>
 <!ENTITY url.zend            'http://www.zend.com/'>
 
+<!-- to use like <ulink url="&url.php-manual;some_function"> -->
+<!ENTITY url.php-manual      'http://php.net/'>
+
 <!-- The three special language constants -->
 <!ENTITY true  '<constant>TRUE</constant>'>
 <!ENTITY false '<constant>FALSE</constant>'>