Reword some of the headings and IndexTerm

Signed-off-by: David Zeuthen <davidz@redhat.com>

1 files changed, 9 insertions, 9 deletions

diff --git a/src/codegen_docbook.py b/src/codegen_docbook.py
index b70e6d3..a05f0f6 100644
--- a/src/codegen_docbook.py
+++ b/src/codegen_docbook.py
@@ -118,7 +118,7 @@ class DocbookCodeGenerator:
 
     def print_synopsis_methods(self, i):
         self.out.write('  <refsynopsisdiv role="synopsis">\n'%())
-        self.out.write('    <title role="synopsis.title">Synopsis</title>\n'%())
+        self.out.write('    <title role="synopsis.title">Methods</title>\n'%())
         self.out.write('    <synopsis>\n'%())
         for m in i.methods:
             self.print_method_prototype(i, m, in_synopsis=True)
@@ -145,8 +145,8 @@ class DocbookCodeGenerator:
 
     def print_method(self, i, m):
         self.out.write('<refsect2 role="method" id="gdbus-method-%s.%s">\n'%(i.name, m.name))
-        self.out.write('  <title>%s</title>\n'%(m.name))
-        self.out.write('  <indexterm zone="gdbus-method-%s.%s"><primary sortas="%s.%s">The %s.%s() D-Bus Method</primary></indexterm>\n'%(i.name, m.name, i.name_without_prefix, m.name, i.name, m.name))
+        self.out.write('  <title>The %s() method</title>\n'%(m.name))
+        self.out.write('  <indexterm zone="gdbus-method-%s.%s"><primary sortas="%s.%s">%s.%s()</primary></indexterm>\n'%(i.name, m.name, i.name_without_prefix, m.name, i.name, m.name))
         self.out.write('<programlisting>\n')
         self.print_method_prototype(i, m, in_synopsis=False)
         self.out.write('</programlisting>\n')
@@ -167,8 +167,8 @@ class DocbookCodeGenerator:
 
     def print_signal(self, i, s):
         self.out.write('<refsect2 role="signal" id="gdbus-signal-%s.%s">\n'%(i.name, s.name))
-        self.out.write('  <title>%s</title>\n'%(s.name))
-        self.out.write('  <indexterm zone="gdbus-signal-%s.%s"><primary sortas="%s::%s">The %s::%s D-Bus Signal</primary></indexterm>\n'%(i.name, s.name, i.name_without_prefix, s.name, i.name, s.name))
+        self.out.write('  <title>The "%s" signal</title>\n'%(s.name))
+        self.out.write('  <indexterm zone="gdbus-signal-%s.%s"><primary sortas="%s::%s">%s::%s</primary></indexterm>\n'%(i.name, s.name, i.name_without_prefix, s.name, i.name, s.name))
         self.out.write('<programlisting>\n')
         self.print_signal_prototype(i, s, in_synopsis=False)
         self.out.write('</programlisting>\n')
@@ -184,8 +184,8 @@ class DocbookCodeGenerator:
 
     def print_property(self, i, p):
         self.out.write('<refsect2 role="property" id="gdbus-property-%s.%s">\n'%(i.name, p.name))
-        self.out.write('  <title>%s</title>\n'%(p.name))
-        self.out.write('  <indexterm zone="gdbus-property-%s.%s"><primary sortas="%s:%s">The %s:%s D-Bus Property</primary></indexterm>\n'%(i.name, p.name, i.name_without_prefix, p.name, i.name, p.name))
+        self.out.write('  <title>The "%s" property</title>\n'%(p.name))
+        self.out.write('  <indexterm zone="gdbus-property-%s.%s"><primary sortas="%s:%s">%s:%s</primary></indexterm>\n'%(i.name, p.name, i.name_without_prefix, p.name, i.name, p.name))
         self.out.write('<programlisting>\n')
         self.print_property_prototype(i, p, in_synopsis=False)
         self.out.write('</programlisting>\n')
@@ -199,7 +199,7 @@ class DocbookCodeGenerator:
             self.out.write('<refentry id="gdbus-%s">\n'%(i.name))
             self.out.write('  <refmeta>'%())
             self.out.write('    <refentrytitle role="top_of_page" id="gdbus-%s.top_of_page">%s</refentrytitle>\n'%(i.name, i.name))
-            self.out.write('  <indexterm zone="gdbus-interface-%s"><primary sortas="%s">The %s D-Bus Interface</primary></indexterm>\n'%(i.name, i.name_without_prefix, i.name))
+            self.out.write('  <indexterm zone="gdbus-interface-%s"><primary sortas="%s">%s</primary></indexterm>\n'%(i.name, i.name_without_prefix, i.name))
             self.out.write('  </refmeta>'%())
 
             self.out.write('  <refnamediv>'%())
@@ -215,7 +215,7 @@ class DocbookCodeGenerator:
                 self.print_synopsis_properties(i)
 
             self.out.write('<refsect1 role="desc" id="gdbus-interface-%s">\n'%(i.name))
-            self.out.write('  <title role="desc.title">Description</title>\n'%())
+            self.out.write('  <title role="desc.title">D-Bus Interface %s</title>\n'%(i.name))
             self.out.write('  <para>%s</para>\n'%(i.doc_string))
             self.out.write('</refsect1>\n'%())