Changeset 7c3fb9b in mainline for uspace/lib/gui

Timestamp:

2018-05-17T08:29:01Z (7 years ago)

Author:

Jiri Svoboda <jiri@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

6ff23ff

Parents:

fac0ac7

git-author:

Jiri Svoboda <jiri@…> (2018-05-16 17:28:17)

git-committer:

Jiri Svoboda <jiri@…> (2018-05-17 08:29:01)

Message:

Fix block comment formatting (ccheck).

Location:

uspace/lib/gui

Files:

• widget.h (modified) (6 diffs)
• window.h (modified) (4 diffs)

uspace/lib/gui/widget.h

@@ -72 +72 @@
          * Virtual destructor. Apart from deallocating the resources specific for
          * the particular widget, each widget shall remove itself from parents
-         * children and deallocate itself. */
+         * children and deallocate itself.
+         */
         void (*destroy)(widget_t *);
 
@@ -82 +83 @@
          * to be changed. If not, widget shall calculate new layout for its children
          * and call rearrange() on each of them. Otherwise, widget shall change its
-         * own properties and call reconfigure() on its parent. */
+         * own properties and call reconfigure() on its parent.
+         */
         void (*reconfigure)(widget_t *);
 
@@ -90 +92 @@
          * position and size according to provided arguments, paint itself,
          * calculate new layout for its children and call rearrange() on each
-         * of them. */
+         * of them.
+         */
         void (*rearrange)(widget_t *, sysarg_t, sysarg_t, sysarg_t, sysarg_t);
 
@@ -97 +100 @@
          * in top-bottom order and repaint() is called on each widget. Widget shall
          * either paint itself or copy its private buffer onto window surface.
-         * Widget shall also post damage event into window event loop. */
+         * Widget shall also post damage event into window event loop.
+         */
         void (*repaint)(widget_t *);
 
@@ -104 +108 @@
          * reaction to the event, widget might call reconfigure() on its parent or
          * rearrange() on its children. If the widget wants to change its visual
-         * information, refresh event should be posted to the window event loop. */
+         * information, refresh event should be posted to the window event loop.
+         */
         void (*handle_keyboard_event)(widget_t *, kbd_event_t);
 
@@ -114 +119 @@
          * should be posted to the window event loop. If the widget accepts
          * keyboard events, it should take ownership of keyboard focus. Widget can
-         * also acquire or release mouse grab. */
+         * also acquire or release mouse grab.
+         */
         void (*handle_position_event)(widget_t *, pos_event_t);
 };

uspace/lib/gui/window.h

@@ -73 +73 @@
  * compositor and asks all widgets in the tree to calculate their new properties
  * and to paint themselves on the new surface (top-bottom order). Should be
- * called also after opening new window to obtain surface. */
+ * called also after opening new window to obtain surface.
+ */
 extern void window_resize(window_t *, sysarg_t, sysarg_t, sysarg_t, sysarg_t,
     window_placement_flags_t);
@@ -84 +85 @@
  * are asked to repaint themselves in top-bottom order. Should be called by
  * widget after such change of its internal state that does not need resizing
- * of neither parent nor children (). */
+ * of neither parent nor children ().
+ */
 extern void window_refresh(window_t *);
 
@@ -90 +92 @@
  * Post damage event into event loop. Handler informs compositor to update the
  * window surface on the screen. Should be called by widget after painting
- * itself or copying its buffer onto window surface. */
+ * itself or copying its buffer onto window surface.
+ */
 extern void window_damage(window_t *);
 
 /**
  * Retrieve dummy root widget of the window widget tree. Intended to be called
- * by proper top-level widget to set his parent. */
+ * by proper top-level widget to set his parent.
+ */
 extern widget_t *window_root(window_t *);
 
 /**
  * Prepare and enqueue window fibrils for event loop and input fetching. When
- * async_manager() function is called, event loop is executed. */
+ * async_manager() function is called, event loop is executed.
+ */
 extern void window_exec(window_t *);
 
 /**
  * Claim protected window surface. Intended for widgets painting from their
- * internal fibrils (e.g. terminal, animation, video). */
+ * internal fibrils (e.g. terminal, animation, video).
+ */
 extern surface_t *window_claim(window_t *);
 
 /**
- * Yield protected window surface after painting. */
+ * Yield protected window surface after painting.
+ */
 extern void window_yield(window_t *);
 
@@ -119 +126 @@
  * terminates. When event loop fibril handles closing event, all window
  * resources are deallocated and fibril also terminates. Moreover, if the
- * window is main window of the application, whole task terminates. */
+ * window is main window of the application, whole task terminates.
+ */
 extern void window_close(window_t *);