Page MenuHomeFreeBSD
Files F163304505

D20666.id58714.diff
No OneTemporary
Actions

D20666.id58714.diff
View Options

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

File Metadata

Mime Type
text/plain
Expires
Wed, Jul 22, 9:43 PM (6 h, 33 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
35356108
Default Alt Text
D20666.id58714.diff (1 KB)

Event Timeline