Index: head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
===================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
+++ head/en_US.ISO8859-1/books/porters-handbook/pkg-files/chapter.xml
@@ -164,39 +164,52 @@
-
- UCL allows for two kind of strings, either delimited
- by double quotes
- "foo", or as a
- here document. These two
- are equivalent:
+
+ To preserve the compatibility with non
+ UCL pkg-message
+ files, the first line of a UCL
+ pkg-message MUST
+ be a single
+ [
, and the last line
+ MUST be a single
+ ]
.
+
+
+ UCL Short Strings
+
+ The message is delimited by double quotes
+ ", this is used for simple single line
+ strings:
+
[
-{ message: "Always displayed"
+{
+ message: "Simple message"
}
]
+
+
+ UCL Multiline Strings
+
+ Multiline strings use the standard here document
+ notation. The multiline delimiter must
+ start just after << symbols without
+ any whitespace and it must consist of
+ capital letters only. To finish a multiline string, add the
+ delimiter string on a line of its own without any
+ whitespace. The message from can be written
+ as:
+
[
-{ message: <<EOM
-Always displayed
+{
+ message: <<EOM
+Simple message
EOM
}
]
-
- The here document delimiter (EOM
- here) must be uppercase.
-
-
-
- To preserve the compatibility with non
- UCL pkg-message
- files, the first line of a UCL
- pkg-message MUST
- be a single
- [
, and the last line
- MUST be a single
- ]
.
-
+
Always Display a Message