+/**
+ * SECTION:hildon-defines
+ * @Title: Defines
+ * @Short_Description: Definitions for icon sizes, margins, and hard keys definitions.
+ *
+ * The macros of this section should be used for a consistent sizing
+ * of icons and spacing of between user interface elements.
+ *
+ * The icon sizes here presented must be registered during the
+ * application initialization by calling hildon_init(). It is
+ * recommended to use these sizes for a consistent look of
+ * applications in the Hildon platform.
+ *
+ * The margin definitions are used internally in the widgets to define the spacing
+ * and padding between widgets; as well as the margins for dialogs and other windows.
+ * Using them to create a new interface layout will guarantee it to be consistent
+ * with the widgets and other applications.
+ *
+ * The hardkey macros are mapping between the Hildon supported keys and the GDK
+ * key definitions.
+ */