Index: en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
===================================================================
--- en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
+++ en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
@@ -164,25 +164,54 @@
 	</varlistentry>
       </variablelist>
 
-      <tip>
-	<para>UCL allows for two kind of strings, either delimited
-	  by double quotes
-	  <literal>"<replaceable>foo</replaceable>"</literal>, or as a
-	  here document.  These two
-	  are equivalent:</para>
+      <example xml:id="porting-message-ucl-short-ex">
+	<title>UCL Short Strings</title>
 
+	<para>The message is delimited by double quotes
+	  <literal>"<replaceable>foo</replaceable>"</literal>,
+	  this is usually used for single line strings:</para>
+
 	<programlisting>[
 { message: "Always displayed"
 }
 ]</programlisting>
+      </example>
 
+      <example xml:id="porting-message-ucl-multiline-ex">
+	<title>UCL Multiline Strings</title>
+
+	<para>For multiline strings, it uses shell/perl like
+	  notation. The multiline terminator must start just
+	  after &lt;&lt; symbols and it must consist of capital
+	  letters only:</para>
+
 	<programlisting>[
 { message: &lt;&lt;EOM
-Always displayed
+some text
+splitted to
+lines
 EOM
 }
 ]</programlisting>
-      </tip>
+
+	<para>To finish multiline string you need to include
+	  a terminator string just after newline and followed
+	  by a newline (no spaces or other characters are
+	  allowed as well) notation. The initial and the final
+	  newlines are not inserted to the resulting string,
+	  but you can still specify newlines at the beginning
+	  and at the end of a value:</para>
+		
+	<programlisting>[
+{ message: &lt;&lt;EOM
+
+some
+text
+
+EOM
+}
+]</programlisting>
+      </example>
 
       <warning>
 	<para>To preserve the compatibility with non