/usr/include/ibus-1.0/ibusregistry.h is in libibus-1.0-dev 1.5.5-1ubuntu3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 | /* -*- mode: C; c-basic-offset: 4; indent-tabs-mode: nil; -*- */
/* vim:set et sts=4: */
/* bus - The Input Bus
* Copyright (C) 2013 Peng Huang <shawn.p.huang@gmail.com>
* Copyright (C) 2013 Takao Fujiwara <takao.fujiwara1@gmail.com>
* Copyright (C) 2013 Red Hat, Inc.
*
* 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.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
* USA
*/
#if !defined (__IBUS_H_INSIDE__) && !defined (IBUS_COMPILATION)
#error "Only <ibus.h> can be included directly"
#endif
#ifndef __IBUS_REGISTRY_H_
#define __IBUS_REGISTRY_H_
/**
* SECTION: ibusregistry
* @short_description: Registry cache handling.
* @title: IBusRegistry
* @stability: Stable
*
* An #IBusRegistry loads IBus component files and generates the cache files.
*
* see_also: #IBusComponent
*/
#include "ibuscomponent.h"
/*
* Type macros.
*/
/* define GOBJECT macros */
#define IBUS_TYPE_REGISTRY \
(ibus_registry_get_type ())
#define IBUS_REGISTRY(obj) \
(G_TYPE_CHECK_INSTANCE_CAST ((obj), IBUS_TYPE_REGISTRY, IBusRegistry))
#define IBUS_REGISTRY_CLASS(klass) \
(G_TYPE_CHECK_CLASS_CAST ((klass), IBUS_TYPE_REGISTRY, IBusRegistryClass))
#define IBUS_IS_REGISTRY(obj) \
(G_TYPE_CHECK_INSTANCE_TYPE ((obj), IBUS_TYPE_REGISTRY))
#define IBUS_IS_REGISTRY_CLASS(klass) \
(G_TYPE_CHECK_CLASS_TYPE ((klass), IBUS_TYPE_REGISTRY))
#define IBUS_REGISTRY_GET_CLASS(obj) \
(G_TYPE_INSTANCE_GET_CLASS ((obj), IBUS_TYPE_REGISTRY, IBusRegistryClass))
G_BEGIN_DECLS
typedef struct _IBusRegistry IBusRegistry;
typedef struct _IBusRegistryPrivate IBusRegistryPrivate;
typedef struct _IBusRegistryClass IBusRegistryClass;
/**
* IBusRegistry:
*
* Registry cache handling.
* You can load the registry from compose files or a cache file.
*/
struct _IBusRegistry {
/* instance members */
/*< private >*/
IBusSerializable parent;
IBusRegistryPrivate *priv;
};
struct _IBusRegistryClass {
/* class members */
/*< private >*/
IBusSerializableClass parent;
};
GType ibus_registry_get_type (void);
/**
* ibus_registry_new:
* @returns: A newly allocated #IBusRegistry.
*
* New a #IBusRegistry
*/
IBusRegistry *ibus_registry_new (void);
/**
* ibus_registry_load:
* @registry: An #IBusRegistry.
*
* Read all XML files in a IBus component directory (typically
* /usr/share/ibus/component/ *.xml) and update the registry object.
* IBUS_COMPONENT_PATH environment valuable is also available for
* the custom component directories, whose delimiter is ':'.
*/
void ibus_registry_load (IBusRegistry *registry);
/**
* ibus_registry_load_in_dir:
* @registry: An #IBusRegistry.
* @dirname: IBus component directory which includes XML files.
*
* Read all XML files in @dirname, create a #IBusComponent object for each file,
* and add the component objects to the registry.
* If @dirname is "/usr/share/ibus/component", this API and
* ibus_registry_load() are same.
*/
void ibus_registry_load_in_dir (IBusRegistry *registry,
const gchar *dirname);
/**
* ibus_registry_load_cache:
* @registry: An #IBusRegistry.
* @is_user: %TRUE if the registry cache is loaded in the user directory.
* @returns: %TRUE if the cache exists and is loaded successfully,
* %FALSE otherwise.
*
* Load the user or system registry cache.
*/
gboolean ibus_registry_load_cache (IBusRegistry *registry,
gboolean is_user);
/**
* ibus_registry_load_cache_file:
* @registry: An #IBusRegistry.
* @filename: The file path of the registry cache
* @returns: %TRUE if the cache exists and is loaded successfully,
* %FALSE otherwise.
*
* Load the registry cache @filename.
*/
gboolean ibus_registry_load_cache_file (IBusRegistry *registry,
const gchar *filename);
/**
* ibus_registry_save_cache:
* @registry: An #IBusRegistry.
* @is_user: %TRUE if the registry cache is saved in the user directory.
* @returns: %TRUE if the cache is saved successfully, %FALSE otherwise.
*
* Save the registry in a user directory or system directory.
*/
gboolean ibus_registry_save_cache (IBusRegistry *registry,
gboolean is_user);
/**
* ibus_registry_save_cache_file:
* @registry: An #IBusRegistry.
* @filename: The file path of the registry cache
* @returns: %TRUE if the cache is saved successfully, %FALSE otherwise.
*
* Save the registry cache @filename.
*/
gboolean ibus_registry_save_cache_file (IBusRegistry *registry,
const gchar *filename);
/**
* ibus_registry_output:
* @registry: An #IBusRegistry.
* @output: GString that holds the result.
* @indent: level of indent.
*
* Output #IBusRegistry as an XML-formatted string.
* The output string can be then shown on the screen or written to file.
*/
void ibus_registry_output (IBusRegistry *registry,
GString *output,
int indent);
/**
* ibus_registry_check_modification:
* @registry: An #IBusRegistry.
* @returns: %TRUE if mtime is changed; %FALSE otherwise.
*
* Check if the registry is updated.
*/
gboolean ibus_registry_check_modification
(IBusRegistry *registry);
/**
* ibus_registry_get_components:
* @registry: An #IBusRegistry.
* @returns: (transfer container) (element-type IBusComponent):
* a list of #IBusComponent objects.
* The caller has to call g_list_free() for the returned list.
*
* List components.
*/
GList *ibus_registry_get_components (IBusRegistry *registry);
/**
* ibus_registry_get_observed_paths:
* @registry: An #IBusRegistry.
* @returns: (transfer container) (element-type IBusObservedPath):
* a list of #IBusObservedPath objects.
* The caller has to call g_list_free() for the returned list.
*
* List observed paths.
*/
GList *ibus_registry_get_observed_paths
(IBusRegistry *registry);
/**
* ibus_registry_start_monitor_changes:
* @registry: An #IBusRegistry.
*
* Start to monitor observed paths.
*/
void ibus_registry_start_monitor_changes
(IBusRegistry *registry);
G_END_DECLS
#endif
|