Master to 4.2.8

[usit-rt.git] / docs / hacking.pod

diff --git a/docs/hacking.pod b/docs/hacking.pod
index a3280c95c74ae666e18842c8837b2955859c326c..23ce51e3a619db835fabec1f58fed928f56228aa 100644 (file)
--- a/docs/hacking.pod
+++ b/docs/hacking.pod
@@ -153,8 +153,14 @@ C<#loc_left_pair> is used for declaring that the I<key> of a
 particular C<< key => value >> pair is translatable. This is of
 very limited usefulness.
 
-C<#loc_right_pair> does NOT exist. C<#loc> works in such cases since
-its parser does not extend beyond the string at the end of a line.
+C<#loc_right_pair> does NOT exist. C<#loc> works in such cases since its
+parser does not extend beyond the string at the end of a line.  However,
+if the string is I<not> at the end of the line, C<#loc{word}> declares
+that the value associated with the key I<word> (earlier on the same
+line) is to be loc'd.  This is useful for inline hashes:
+
+    # Note the string "baz" is to be loc'd
+    foo => { bar => "baz", troz => "zort" },  # loc{bar}
 
 =head1 Development tips