[gtk+/wip/lapo/paddings] Adwaita: add a comment about padding vars

[Lapo Calamandrei <lapo src gnome org>]

commit 3b32024ed167246d63c795613785a50f86719e14
Author: Lapo Calamandrei <calamandrei gmail com>
Date:   Wed Oct 7 17:59:28 2015 +0200

    Adwaita: add a comment about padding vars

 gtk/theme/Adwaita/_common.scss           |   13 ++++++++++++-
 gtk/theme/Adwaita/gtk-contained-dark.css |    2 +-
 gtk/theme/Adwaita/gtk-contained.css      |    2 +-
 3 files changed, 14 insertions(+), 3 deletions(-)
---
diff --git a/gtk/theme/Adwaita/_common.scss b/gtk/theme/Adwaita/_common.scss
index 44a5588..3280026 100644
--- a/gtk/theme/Adwaita/_common.scss
+++ b/gtk/theme/Adwaita/_common.scss
@@ -9,6 +9,17 @@ $padding: 4px;
 $internal_padding: 3px;
 $font_compensation: 1px;
 
+//
+//       GtkImage           GtkLabel
+// +-----------------+  +--------------+
+// |        ip       |  |              | A Canterell 11 label is 21px tall, a symbolic icon is 16px tall
+// | [symbolic icon] |  | Cantarell 11 | so adding 1px to the bottom visually centers the font making the 
label 22px,
+// |        ip       |  |      fc      | to have the GtkImage the same height 3px at the bottom and 3 at the 
top are added.
+// +-----------------+  +--------------+
+//  ip: $internal_padding
+//  fc: $font_compensation
+//
+
 * {
   padding: 0;
   -GtkToolButton-icon-spacing: 4;
@@ -1572,7 +1583,7 @@ column-header.button.dnd { // for treeview-like derive widgets
  ***************/
 
 .popover {
-  padding: 2px;
+  padding: $internal_padding;
   border: 1px solid $borders_color;
   border-radius: 5px;
   background-color: mix($bg_color, $base_color, 50%);
diff --git a/gtk/theme/Adwaita/gtk-contained-dark.css b/gtk/theme/Adwaita/gtk-contained-dark.css
index f5ff30d..4b9b407 100644
--- a/gtk/theme/Adwaita/gtk-contained-dark.css
+++ b/gtk/theme/Adwaita/gtk-contained-dark.css
@@ -2059,7 +2059,7 @@ column-header .titlebar .button.titlebutton,
  * Popovers   *
  ***************/
 .popover {
-  padding: 2px;
+  padding: 3px;
   border: 1px solid #1c1f1f;
   border-radius: 5px;
   background-color: #313434;
diff --git a/gtk/theme/Adwaita/gtk-contained.css b/gtk/theme/Adwaita/gtk-contained.css
index 041747a..076aad6 100644
--- a/gtk/theme/Adwaita/gtk-contained.css
+++ b/gtk/theme/Adwaita/gtk-contained.css
@@ -2065,7 +2065,7 @@ column-header .titlebar .button.titlebutton,
  * Popovers   *
  ***************/
 .popover {
-  padding: 2px;
+  padding: 3px;
   border: 1px solid #a1a1a1;
   border-radius: 5px;
   background-color: #f6f6f6;