specparser: add tp:immutable and tp:requestable attributes

Signed-off-by: Jonny Lamb <jonny.lamb@collabora.co.uk>

2 files changed, 26 insertions, 0 deletions

diff --git a/doc/templates/interface.html b/doc/templates/interface.html
index fcdf1b68..e27ffa5f 100644
--- a/doc/templates/interface.html
+++ b/doc/templates/interface.html
@@ -82,6 +82,7 @@
         #if $property.type: (<a href="$property.get_type_url()" title="$property.get_type_title()">$property.get_type().short_name</a>)
        </td>
        <td>$property.get_access()</td>
+       <td>$property.get_flag_summary()</td>
        <td>
         #if $property.deprecated: (deprecated)
        </td>
@@ -316,6 +317,23 @@
      </h2>
       <div class="access">$property.get_access()</div>
 
+     #if $property.immutable:
+     <div class="annotation immutable">This property is
+       <strong>immutable</strong> which means that it can never change
+       once the channel has been given its original value. Immutable
+       properties SHOULD appear in the channel detail list
+       of <a href="Connection_Interface_Requests.html#org.freedesktop.Telepathy.Connection.Interface.Requests.NewChannels">NewChannels</a>
+       signals.</div>
+     #end if
+
+     #if $property.requestable:
+     <div class="annotation requestable">This property
+       is <strong>requestable</strong> which means that it is allowed
+       in the properties hash of a channel request such as in
+       the <a href="Connection_Interface_Requests.html#org.freedesktop.Telepathy.Connection.Interface.Requests.CreateChannel">CreateChannel</a>
+       method.</div>
+     #end if
+
      $property.get_added()
      $property.get_changed()
      $property.get_deprecated()
diff --git a/doc/templates/style.css b/doc/templates/style.css
index a615db70..ba28f994 100644
--- a/doc/templates/style.css
+++ b/doc/templates/style.css
@@ -221,6 +221,14 @@ div.connection-parameter .note {
 	color: #0000a4;
 }
 
+div.immutable {
+	border-left-color: #00d8ff;
+}
+
+div.requestable {
+	border-left-color: #ff9f00;
+}
+
 div.rationale {
 	border: 1px solid gray;
 	-moz-border-radius: 5px;