2006-09-12 Michael Dominic Kostrzewa <michael.kostrzewa@nokia.com>

[hildon] / hildon-widgets / hildon-app.h

diff --git a/hildon-widgets/hildon-app.h b/hildon-widgets/hildon-app.h
index 13c81b6..727ca7b 100644 (file)
--- a/hildon-widgets/hildon-app.h
+++ b/hildon-widgets/hildon-app.h
@@ -1,14 +1,14 @@
 /*
  * This file is part of hildon-libs
  *
- * Copyright (C) 2005 Nokia Corporation.
+ * Copyright (C) 2005, 2006 Nokia Corporation, all rights reserved.
  *
- * Contact: Luc Pionchon <luc.pionchon@nokia.com>
+ * Contact: Michael Dominic Kostrzewa <michael.kostrzewa@nokia.com>
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public License
- * as published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
+ * as published by the Free Software Foundation; version 2.1 of
+ * the License or any later version.
  *
  * This library is distributed in the hope that it will be useful, but
  * WITHOUT ANY WARRANTY; without even the implied warranty of
@@ -60,7 +60,7 @@ struct _HildonAppClass {
     GtkWindowClass parent_class;
     void (*topmost_status_acquire) (HildonApp *self);
     void (*topmost_status_lose) (HildonApp *self);
-    void (*switch_to) (HildonApp *self);
+    void (*switch_to) (HildonApp *self); /* FIXME: Possible browser hack?? */
     void (*im_close) (HildonApp *self);
     void (*clipboard_copy) (HildonApp *self, GtkWidget *widget);
     void (*clipboard_cut) (HildonApp *self, GtkWidget *widget);
@@ -83,7 +83,8 @@ struct _HildonAppClass {
  * This enum is deprecated and should not be used. It's just
  * lecagy stuff from ancient specs.
  */
-typedef enum {
+typedef enum /*< skip >*/
+{
     HILDON_ZOOM_SMALL = 1,
     HILDON_ZOOM_MEDIUM = 2,
     HILDON_ZOOM_LARGE = 3
@@ -91,10 +92,15 @@ typedef enum {
 
 #define HILDON_TYPE_ZOOM_LEVEL (hildon_zoom_level_get_type ())
 
-G_CONST_RETURN GType hildon_zoom_level_get_type (void);
+GType hildon_zoom_level_get_type (void);
 #endif /* deprecated */
 
-/* You should use the correct ones from hildon-defines.h */
+
+/* You should use the correct ones from hildon-defines.h 
+ *
+ * FIXME: These should be removed when API changes are allowed, 
+ * they are not used in hildon code anymore (but might be in external). 
+ */ 
 #define HILDON_MENU_KEY         GDK_F4
 #define HILDON_HOME_KEY         GDK_F5
 #define HILDON_TOOLBAR_KEY      GDK_T
@@ -149,4 +155,4 @@ void hildon_app_set_ui_manager(HildonApp *self, GtkUIManager *uim);
 GtkUIManager *hildon_app_get_ui_manager(HildonApp *self);
 
 G_END_DECLS
-#endif /* HILDON_APP_H */
+#endif /* __HILDON_APP_H__ */