[gtk-doc] mkdb: also reorder signal docs, but switch back to use paras
- From: Stefan Kost <stefkost src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk-doc] mkdb: also reorder signal docs, but switch back to use paras
- Date: Thu, 13 Feb 2014 20:14:56 +0000 (UTC)
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]