diff --git a/reference/image/figures/dashedline.png b/reference/image/figures/dashedline.png
new file mode 100644
index 0000000000..e79594b798
Binary files /dev/null and b/reference/image/figures/dashedline.png differ
diff --git a/reference/image/figures/stringup.png b/reference/image/figures/stringup.png
new file mode 100644
index 0000000000..e0336819ef
Binary files /dev/null and b/reference/image/figures/stringup.png differ
diff --git a/reference/image/functions/imagedashedline.xml b/reference/image/functions/imagedashedline.xml
index 135b1c5cf4..5d73eef29c 100644
--- a/reference/image/functions/imagedashedline.xml
+++ b/reference/image/functions/imagedashedline.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry xml:id="function.imagedashedline" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>imagedashedline</refname>
@@ -77,6 +77,36 @@
    Always returns true
   </para>
  </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>imagedashedline</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Create a 100x100 image
+$im = imagecreatetruecolor(100, 100);
+$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
+
+// Draw a vertical dashed line
+imagedashedline($im, 50, 25, 50, 75, $white);
+
+// Save the image
+imagepng($im, './dashedline.png');
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <mediaobject>
+     <imageobject>
+      <imagedata fileref="figures/image.dashedline.png"/>
+     </imageobject>
+    </mediaobject>
+   </example>
+  </para>
+ </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
diff --git a/reference/image/functions/imagestringup.xml b/reference/image/functions/imagestringup.xml
index 500927eb81..fd12b9fefe 100644
--- a/reference/image/functions/imagestringup.xml
+++ b/reference/image/functions/imagestringup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry xml:id="function.imagestringup" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>imagestringup</refname>
@@ -69,6 +69,36 @@
    &return.success;
   </para>
  </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>imagestring</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// create a 100*100 image
+$im = imagecreatetruecolor(100, 100);
+
+// Write the text
+$textcolor = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
+imagestringup($im, 3, 40, 80, 'gd library', $textcolor);
+
+// Save the image
+imagepng($im, './stringup.png');
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <mediaobject>
+     <imageobject>
+      <imagedata fileref="figures/image.imagestringup.png"/>
+     </imageobject>
+    </mediaobject>
+   </example>
+  </para>
+ </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
diff --git a/reference/strings/functions/nl2br.xml b/reference/strings/functions/nl2br.xml
index 7fed5b8c8c..d4b8ff7940 100644
--- a/reference/strings/functions/nl2br.xml
+++ b/reference/strings/functions/nl2br.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.nl2br">
  <refnamediv>
   <refname>nl2br</refname>
@@ -14,8 +14,8 @@
    <methodparam><type>bool</type><parameter>is_xhtml</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Returns <parameter>string</parameter> with '&lt;br /&gt;' inserted
-   before all newlines.
+   Returns <parameter>string</parameter> with '&lt;br /&gt;' or 
+   '&lt;br&gt;' inserted before all newlines.
   </para>
  </refsect1>
 
@@ -67,6 +67,23 @@ echo nl2br("foo isn't\n bar");
 <![CDATA[
 foo isn't<br />
  bar
+]]>
+    </screen>
+   </example>
+   <example>
+    <title>Generating valid HTML markup using the <parameter>is_xhtml</parameter></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+echo nl2br("Welcome\r\nThis is my HTML document", false);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+Welcome<br>
+This is my HTML document
 ]]>
     </screen>
    </example>