[gtksourceview] lang-reference: better document once-only

[Sébastien Wilmet <swilmet src gnome org>]

commit 61b6cef807ec5402f32a16c4265fcefe973a326c
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Fri Mar 6 12:02:36 2015 +0100

    lang-reference: better document once-only
    
    https://bugzilla.gnome.org/show_bug.cgi?id=744993

 docs/reference/lang-reference.xml |   10 +++++++---
 1 files changed, 7 insertions(+), 3 deletions(-)
---
diff --git a/docs/reference/lang-reference.xml b/docs/reference/lang-reference.xml
index b922b95..9d0a2fb 100644
--- a/docs/reference/lang-reference.xml
+++ b/docs/reference/lang-reference.xml
@@ -1,4 +1,4 @@
-<refentry id="lang-reference" revision="23 November 2013">
+<refentry id="lang-reference" revision="6 March 2015">
 <refmeta>
 <refentrytitle>Language Definition v2.0 Reference</refentrytitle>
 </refmeta>
@@ -615,7 +615,9 @@ on the first line of buffer. If not specified it defaults to <code>false</code>.
 <term><code>once-only</code> (optional)</term>
 <listitem><para>
 A boolean value telling the engine whether the context can occur only
-once in its parent. If not specified it defaults to <code>false</code>.
+once in its parent. For a container context, it means that
+<emphasis>each</emphasis> included context can occur once.
+If not specified it defaults to <code>false</code>.
 </para></listitem></varlistentry>
 
 <varlistentry>
@@ -762,7 +764,9 @@ Contained elements:
 </para>
 
 <para>
-The attributes are the same used in simple contexts.
+The attributes are the same used in simple contexts. If the
+<code>once-only</code> attribute is <code>true</code>, it means that
+<emphasis>each</emphasis> keyword can occur once.
 </para>
 
 </refsect2>