[gtk-doc] mkdb: also reorder signal docs, but switch back to use paras



commit 7d94a7a279c41529c47b4fcc2efaaa598b1afb1b
Author: Stefan Sauer <ensonic users sf net>
Date:   Thu Feb 13 21:13:02 2014 +0100

    mkdb: also reorder signal docs, but switch back to use paras
    
    Also in signal docs have: title, synopsis, desc, deprecation, .... Revert the
    tables in property docs, as this looks weird with the since and stability docs.

 gtkdoc-mkdb.in  |   29 +++++++++--------------------
 style/style.css |    3 +--
 2 files changed, 10 insertions(+), 22 deletions(-)
---
diff --git a/gtkdoc-mkdb.in b/gtkdoc-mkdb.in
index 3b7036d..d457a0b 100755
--- a/gtkdoc-mkdb.in
+++ b/gtkdoc-mkdb.in
@@ -3557,6 +3557,7 @@ sub GetSignals {
             $xref = &MakeXRef ("gpointer", &tagify("gpointer", "type"));
             $pad = ' ' x ($type_len - length("gpointer"));
             $desc  .= "$xref$pad user_data)";
+            $desc  .= "</programlisting>\n";
 
             my $flags = $SignalFlags[$i];
             my $flags_string = "";
@@ -3590,16 +3591,8 @@ sub GetSignals {
               }
             }
 
-            $desc  .= "</programlisting>\n";
-            if ($flags_string)
-              {
-                $desc  .= "<para>Flags: $flags_string</para>\n";
-              }
-
             $synop .= "<row><entry role=\"signal_type\">${ret_type_output}</entry><entry 
role=\"signal_name\"><link linkend=\"$id\">${name}</link></entry><entry 
role=\"signal_flags\">${flags_string}</entry></row>\n";
 
-            $desc .= &MakeDeprecationNote($symbol);
-
             my $parameters = &OutputParamDescriptions ("SIGNAL", $symbol);
             my $parameters_output = 0;
 
@@ -3618,10 +3611,14 @@ sub GetSignals {
                     $AllDocumentedSymbols{$symbol} = 1;
                 }
             }
+            $desc .= &MakeDeprecationNote($symbol);
 
             if ($parameters_output == 0) {
                 $desc .= $parameters;
-              }
+            }
+            if ($flags_string) {
+                $desc  .= "<para>Flags: $flags_string</para>\n";
+            }
             $desc .= OutputSymbolTraits ($symbol);
             $desc .= "</refsect2>";
         }
@@ -3739,23 +3736,15 @@ sub GetArgs {
             $arg_desc .= $blurb;
             $arg_desc .= &MakeDeprecationNote($symbol);
 
-            $arg_desc .= <<EOF;
-<informaltable role="property_details_table" pgwide="1" frame="none">
-<tgroup cols="2">
-<colspec colname="parameters_name" colwidth="150px"/>
-<colspec colname="parameters_description"/>
-<tbody>
-EOF
             if ($flags_string) {
-              $arg_desc  .= "<row><entry 
role=\"property_detail\">Flags</entry><entry>$flags_string</entry></row>\n";
+              $arg_desc  .= "<para>Flags: $flags_string</para>\n";
             }
             if ($range ne "") {
-                $arg_desc .= "<row><entry role=\"property_detail\">Allowed 
values</entry><entry>$range_output</entry></row>\n";
+                $arg_desc .= "<para>Allowed values: $range_output</para>\n";
             }
             if ($default ne "") {
-                $arg_desc .= "<row><entry role=\"property_detail\">Default 
value</entry><entry>$default_output</entry></row>\n";
+                $arg_desc .= "<para>Default value: $default_output</para>\n";
             }
-            $arg_desc .= "</tbody></tgroup></informaltable>\n";
             $arg_desc .= OutputSymbolTraits ($symbol);
             $arg_desc .= "</refsect2>\n";
 
diff --git a/style/style.css b/style/style.css
index 3643076..9c17d50 100644
--- a/style/style.css
+++ b/style/style.css
@@ -197,8 +197,7 @@ div.informaltable table td, div.informaltable table th
 .struct_member_name,
 .union_member_name,
 .define_keyword,
-.datatype_keyword,
-.property_detail
+.datatype_keyword
 {
   text-align: right;
 }


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]