util.h File Reference

Go to the source code of this file.

Defines
#define	_(x)   dgettext (GETTEXT_PACKAGE, x)
#define	N_(x)   x
Enumerations
enum	MetaDebugTopic {   META_DEBUG_FOCUS = 1 << 0, META_DEBUG_WORKAREA = 1 << 1, META_DEBUG_STACK = 1 << 2, META_DEBUG_THEMES = 1 << 3,   META_DEBUG_SM = 1 << 4, META_DEBUG_EVENTS = 1 << 5, META_DEBUG_WINDOW_STATE = 1 << 6, META_DEBUG_WINDOW_OPS = 1 << 7,   META_DEBUG_GEOMETRY = 1 << 8, META_DEBUG_PLACEMENT = 1 << 9, META_DEBUG_PING = 1 << 10, META_DEBUG_XINERAMA = 1 << 11,   META_DEBUG_KEYBINDINGS = 1 << 12, META_DEBUG_SYNC = 1 << 13, META_DEBUG_ERRORS = 1 << 14, META_DEBUG_STARTUP = 1 << 15,   META_DEBUG_PREFS = 1 << 16, META_DEBUG_GROUPS = 1 << 17, META_DEBUG_RESIZING = 1 << 18, META_DEBUG_SHAPES = 1 << 19,   META_DEBUG_COMPOSITOR = 1 << 20, META_DEBUG_EDGE_RESISTANCE = 1 << 21 }
Functions
gboolean	meta_is_verbose (void)
void	meta_set_verbose (gboolean setting)
gboolean	meta_is_debugging (void)
void	meta_set_debugging (gboolean setting)
gboolean	meta_is_syncing (void)
	Returns whether X synchronisation is currently enabled.
void	meta_set_syncing (gboolean setting)
	A handy way to turn on synchronisation on or off for every display.
gboolean	meta_get_replace_current_wm (void)
void	meta_set_replace_current_wm (gboolean setting)
void	meta_debug_spew_real (const char *format,...) G_GNUC_PRINTF(1
void void	meta_verbose_real (const char *format,...) G_GNUC_PRINTF(1
void void void	meta_bug (const char *format,...) G_GNUC_PRINTF(1
void void void void	meta_warning (const char *format,...) G_GNUC_PRINTF(1
void void void void void	meta_fatal (const char *format,...) G_GNUC_PRINTF(1
void	meta_topic_real (MetaDebugTopic topic, const char *format,...) G_GNUC_PRINTF(2
void void	meta_push_no_msg_prefix (void)
void	meta_pop_no_msg_prefix (void)
gint	meta_unsigned_long_equal (gconstpointer v1, gconstpointer v2)
guint	meta_unsigned_long_hash (gconstpointer v)
void	meta_print_backtrace (void)
const char *	meta_gravity_to_string (int gravity)
char *	meta_g_utf8_strndup (const gchar *src, gsize n)
void	meta_free_gslist_and_elements (GSList *list_to_deep_free)

---

Define Documentation

#define _

(

x

)

dgettext (GETTEXT_PACKAGE, x)

Definition at line 93 of file util.h.

Referenced by add_context_to_error(), benchmark_summary(), border_only_contents(), change_notify(), check_no_attributes(), check_state(), create_lame_apps_list(), create_title_layout(), delete_ping_timeout_func(), dialog_contents(), do_operation(), do_operations(), enable_compositor(), end_element_handler(), ensure_logfile(), error_about_command(), error_on_generic_command(), get_window_contents(), get_workspace_name_with_accel(), handle_preference_init_enum(), handle_preference_init_int(), handle_preference_update_bool(), handle_preference_update_enum(), handle_preference_update_int(), handle_preference_update_string(), handle_run_command(), handle_run_terminal(), init_workspace_names(), io_from_ping_dialog(), kill_window_question(), load_state(), locate_attributes(), main(), maybe_give_disable_workarounds_warning(), menu_contents(), menu_item_new(), meta_accel_label_class_init(), meta_bug(), meta_change_keygrab(), meta_color_spec_new_from_string(), meta_core_get(), meta_debug_spew_real(), meta_fatal(), meta_frame_layout_validate(), meta_frame_style_set_validate(), meta_frame_style_validate(), meta_gradient_spec_validate(), meta_prefs_change_workspace_name(), meta_prefs_set_num_workspaces(), meta_screen_free(), meta_screen_new(), meta_set_verbose(), meta_theme_define_color_constant(), meta_theme_define_float_constant(), meta_theme_define_int_constant(), meta_theme_load(), meta_theme_set_current(), meta_theme_validate(), meta_warning(), meta_window_kill(), mouse_button_mods_handler(), normal_contents(), parse_alpha(), parse_angle(), parse_aspect_ratio(), parse_boolean(), parse_border(), parse_button_element(), parse_dialog_output(), parse_distance(), parse_double(), parse_draw_op_element(), parse_geometry_element(), parse_gradient_element(), parse_info_element(), parse_menu_icon_element(), parse_number(), parse_piece_element(), parse_positive_integer(), parse_rounding(), parse_size_unchecked(), parse_style_element(), parse_style_set_element(), parse_title_scale(), parse_toplevel_element(), parse_x_position_unchecked(), parse_y_position_unchecked(), pid_from_string(), pos_eval_get_variable(), pos_eval_helper(), pos_tokenize(), previews_of_button_layouts(), recalc_window_features(), reload_net_wm_pid(), reload_transient_for(), run_position_expression_tests(), run_theme_benchmark(), save_state(), set_error(), set_title_text(), show_tip_now(), start_element_handler(), text_handler(), titlebar_handler(), update_binding(), update_list_binding(), update_size_window(), update_sm_hints(), update_workspace_name(), usage(), utf8_list_from_results(), utf8_string_from_results(), validate_border(), validate_geometry_border(), validate_geometry_value(), validate_or_free_results(), version(), warn_about_lame_clients_and_finish_interact(), warn_about_no_sm_support(), window_from_string(), and x_io_error_handler().

#define N_

(

x

)

x

Definition at line 94 of file util.h.

Referenced by meta_parse_options(), and meta_window_menu_new().

---

Enumeration Type Documentation

enum MetaDebugTopic

Enumerator:

META_DEBUG_FOCUS
META_DEBUG_WORKAREA
META_DEBUG_STACK
META_DEBUG_THEMES
META_DEBUG_SM
META_DEBUG_EVENTS
META_DEBUG_WINDOW_STATE
META_DEBUG_WINDOW_OPS
META_DEBUG_GEOMETRY
META_DEBUG_PLACEMENT
META_DEBUG_PING
META_DEBUG_XINERAMA
META_DEBUG_KEYBINDINGS
META_DEBUG_SYNC
META_DEBUG_ERRORS
META_DEBUG_STARTUP
META_DEBUG_PREFS
META_DEBUG_GROUPS
META_DEBUG_RESIZING
META_DEBUG_SHAPES
META_DEBUG_COMPOSITOR
META_DEBUG_EDGE_RESISTANCE

Definition at line 51 of file util.h.

---

Function Documentation

void void void meta_bug	(	const char *	format,
			...
	)

void meta_debug_spew_real	(	const char *	format,
			...
	)

void void void void void meta_fatal	(	const char *	format,
			...
	)

void meta_free_gslist_and_elements

(

GSList *

list_to_deep_free

)

Definition at line 208 of file util.c.

References NULL.

Referenced by meta_window_free(), and meta_window_update_struts().

char* meta_g_utf8_strndup	(	const gchar *	src,
		gsize	n
	)

Definition at line 175 of file util.c.

Referenced by set_title_text(), and tab_entry_new().

gboolean meta_get_replace_current_wm

(

void

)

Definition at line 163 of file util.c.

References replace_current.

Referenced by meta_screen_new().

const char* meta_gravity_to_string

(

int

gravity

)

Definition at line 501 of file util.c.

Referenced by process_keyboard_resize_grab(), save_state(), setup_constraint_info(), and start_element_handler().

gboolean meta_is_debugging

(

void

)

Definition at line 146 of file util.c.

References is_debugging.

Referenced by meta_change_button_grab(), meta_change_keygrab(), meta_theme_load(), and ungrab_all_keys().

gboolean meta_is_syncing

(

void

)

Returns whether X synchronisation is currently enabled.

Returns:

true if we must wait for events whenever we send X requests; false otherwise.

Bug:

This is *only* called by meta_display_open, but by that time we have already turned syncing on or off on startup, and we don't have any way to do so while Metacity is running, so it's rather pointless.

Definition at line 3985 of file display.c.

gboolean meta_is_verbose

(

void

)

Definition at line 126 of file util.c.

References is_verbose.

Referenced by cache_edges(), do_screen_and_xinerama_relative_constraints(), event_callback(), get_possible_matches(), meta_screen_calc_workspace_layout(), meta_spew_event(), meta_window_client_message(), and update_net_wm_type().

void meta_pop_no_msg_prefix

(

void

)

Definition at line 466 of file util.c.

References no_prefix.

Referenced by meta_screen_calc_workspace_layout(), and stack_sync_to_server().

void meta_print_backtrace

(

void

)

Definition at line 43 of file util.c.

Referenced by log_handler(), meta_bug(), and timestamp_too_old().

void void meta_push_no_msg_prefix

(

void

)

Definition at line 460 of file util.c.

References no_prefix.

Referenced by meta_screen_calc_workspace_layout(), and stack_sync_to_server().

void meta_set_debugging

(

gboolean

setting

)

Definition at line 152 of file util.c.

References ensure_logfile(), and is_debugging.

Referenced by main().

void meta_set_replace_current_wm

(

gboolean

setting

)

Definition at line 169 of file util.c.

References replace_current.

Referenced by main().

void meta_set_syncing

(

gboolean

setting

)

A handy way to turn on synchronisation on or off for every display.

Bug:

Of course there is only one display ever anyway, so this can be rather hugely simplified.

Definition at line 3997 of file display.c.

References meta_get_display().

Referenced by main().

void meta_set_verbose

(

gboolean

setting

)

Definition at line 132 of file util.c.

References _, ensure_logfile(), is_verbose, and meta_fatal().

Referenced by event_callback(), and main().

void meta_topic_real	(	MetaDebugTopic	topic,
		const char *	format,
			...
	)

gint meta_unsigned_long_equal	(	gconstpointer	v1,
		gconstpointer	v2
	)

Definition at line 481 of file util.c.

Referenced by meta_group_new().

guint meta_unsigned_long_hash

(

gconstpointer

v

)

Definition at line 488 of file util.c.

Referenced by meta_group_new().

void void meta_verbose_real	(	const char *	format,
			...
	)

void void void void meta_warning	(	const char *	format,
			...
	)