diff options
Diffstat (limited to 'gio/src')
52 files changed, 647 insertions, 647 deletions
diff --git a/gio/src/appinfo.ccg b/gio/src/appinfo.ccg index fc8d0183..84d96b7a 100644 --- a/gio/src/appinfo.ccg +++ b/gio/src/appinfo.ccg @@ -59,7 +59,7 @@ bool AppInfo::launch(const Glib::RefPtr<Gio::File>& file, const Glib::RefPtr<App { std::vector< Glib::RefPtr<Gio::File> > vec; vec.push_back(file); - + GError* gerror = 0; bool retvalue = g_app_info_launch(gobj(), Glib::ListHandler<Glib::RefPtr<Gio::File> >::vector_to_list(vec).data (), Glib::unwrap(launch_context), &(gerror)); if(gerror) @@ -72,7 +72,7 @@ bool AppInfo::launch(const Glib::RefPtr<Gio::File>& file) { std::vector< Glib::RefPtr<Gio::File> > vec; vec.push_back(file); - + GError* gerror = 0; bool retvalue = g_app_info_launch(gobj(), Glib::ListHandler<Glib::RefPtr<Gio::File> >::vector_to_list(vec).data (), 0, &(gerror)); if(gerror) @@ -85,7 +85,7 @@ bool AppInfo::launch_uri(const std::string& uri, const Glib::RefPtr<AppLaunchCon { std::vector<std::string> vec; vec.push_back(uri); - + GError* gerror = 0; bool retvalue = g_app_info_launch_uris(gobj(), Glib::ListHandler<std::string>::vector_to_list(vec).data (), Glib::unwrap(launch_context), &(gerror)); if(gerror) @@ -98,7 +98,7 @@ bool AppInfo::launch_uri(const std::string& uri) { std::vector<std::string> vec; vec.push_back(uri); - + GError* gerror = 0; bool retvalue = g_app_info_launch_uris(gobj(), Glib::ListHandler<std::string>::vector_to_list(vec).data (), 0, &(gerror)); if(gerror) diff --git a/gio/src/appinfo.hg b/gio/src/appinfo.hg index ecbf5987..e4a35e6d 100644 --- a/gio/src/appinfo.hg +++ b/gio/src/appinfo.hg @@ -45,7 +45,7 @@ _WRAP_ENUM(AppInfoCreateFlags, GAppInfoCreateFlags, NO_GTYPE) class File; -/** Application information, to describe applications installed on the system, +/** Application information, to describe applications installed on the system, * and launch them. * See also AppLaunchContext. * @@ -84,16 +84,16 @@ public: * as an argument, using the optional @a launch_context to get information * about the details of the launcher (like what screen it is on). * On error, an exception will be thrown accordingly. - * + * * Note that even if the launch is successful the application launched * can fail to start if it runs into problems during startup. There is * no way to detect this. - * + * * Some URIs can be changed when passed through a GFile (for instance * unsupported uris with strange formats like mailto:), so if you have * a textual uri you want to pass in as argument, consider using * launch_uris() instead. - * + * * On UNIX, this function sets the <envar>GIO_LAUNCHED_DESKTOP_FILE</envar> * environment variable with the path of the launched desktop file and * <envar>GIO_LAUNCHED_DESKTOP_FILE_PID</envar> to the process @@ -109,20 +109,20 @@ public: * @newin{3,2} */ bool launch(const Glib::RefPtr<Gio::File>& file, const Glib::RefPtr<AppLaunchContext>& launch_context); - + /** Launches the application. This passes the @a file to the launched application * as an arguments. * On error, an exception will be thrown accordingly. - * + * * Note that even if the launch is successful the application launched * can fail to start if it runs into problems during startup. There is * no way to detect this. - * + * * Some URIs can be changed when passed through a GFile (for instance * unsupported uris with strange formats like mailto:), so if you have * a textual uri you want to pass in as argument, consider using * launch_uris() instead. - * + * * On UNIX, this function sets the <envar>GIO_LAUNCHED_DESKTOP_FILE</envar> * environment variable with the path of the launched desktop file and * <envar>GIO_LAUNCHED_DESKTOP_FILE_PID</envar> to the process @@ -137,7 +137,7 @@ public: * @newin{3,2} */ bool launch(const Glib::RefPtr<Gio::File>& file); - + _WRAP_METHOD(bool launch(const std::vector< Glib::RefPtr<Gio::File> >& files, const Glib::RefPtr<AppLaunchContext>& launch_context{?}), g_app_info_launch, @@ -157,12 +157,12 @@ public: const Glib::RefPtr<AppLaunchContext>& launch_context{?}), g_app_info_launch_uris, errthrow) - + /** Launches the application. This passes the @a uri to the launched application * as an arguments, using the optional @a launch_context to get information * about the details of the launcher (like what screen it is on). * On error, an exception will be thrown accordingly. - * + * * Note that even if the launch is successful the application launched * can fail to start if it runs into problems during startup. There is * no way to detect this. @@ -179,7 +179,7 @@ public: * @newin{3,2} */ bool launch_uri(const std::string& uris); - + _WRAP_METHOD(bool should_show() const, g_app_info_should_show) // FIXME: use better terminology than delete/do_delete _WRAP_METHOD(bool can_delete() const, g_app_info_can_delete) diff --git a/gio/src/application.ccg b/gio/src/application.ccg index f11e4543..3dee00d6 100644 --- a/gio/src/application.ccg +++ b/gio/src/application.ccg @@ -25,7 +25,7 @@ namespace { -static void Application_signal_open_callback(GApplication* self, GFile** files, +static void Application_signal_open_callback(GApplication* self, GFile** files, gint n_files, const gchar* hint, void* data) { typedef sigc::slot< void, const Gio::Application::type_vec_files&, const Glib::ustring& > SlotType; @@ -35,7 +35,7 @@ static void Application_signal_open_callback(GApplication* self, GFile** files, { vec_files[i] = Glib::wrap(files[i], true); } - + const Glib::ustring hint_str = (hint ? hint : Glib::ustring()); // Do not try to call a signal on a disassociated wrapper. @@ -68,7 +68,7 @@ static void Application_signal_open_notify_callback(GApplication* self, GFile** { vec_files[i] = Glib::wrap(files[i], true); } - + const Glib::ustring hint_str = (hint ? hint : Glib::ustring()); // Do not try to call a signal on a disassociated wrapper. @@ -118,7 +118,7 @@ Application::Application(const Glib::ustring& application_id, ApplicationFlags f Glib::ObjectBase(0), Glib::Object(Glib::ConstructParams(custom_class_init(), "application_id", (application_id.empty() ? 0 : application_id.c_str()), "flags", ((GApplicationFlags)(flags)), static_cast<char*>(0))) { - + } //static @@ -127,7 +127,7 @@ void Application::unset_default() g_application_set_default(0); } -void Application_Class::open_callback(GApplication* self, GFile** files, +void Application_Class::open_callback(GApplication* self, GFile** files, gint n_files, const gchar *hint) { Glib::ObjectBase *const obj_base = static_cast<Glib::ObjectBase*>( @@ -151,9 +151,9 @@ void Application_Class::open_callback(GApplication* self, GFile** files, for (int i = 0; i < n_files; i++) { vec_files[i] = Glib::wrap(files[i], true); } - + const Glib::ustring hint_str = (hint ? hint : Glib::ustring()); - + obj->on_open(vec_files, hint_str); return; } @@ -163,7 +163,7 @@ void Application_Class::open_callback(GApplication* self, GFile** files, } } } - + BaseClassType *const base = static_cast<BaseClassType*>( g_type_class_peek_parent(G_OBJECT_GET_CLASS(self)) // Get the parent class of the object class (The original underlying C class). ); @@ -185,7 +185,7 @@ void Gio::Application::on_open(const Application::type_vec_files& files, const G ); if(base && base->open) { - (*base->open)(gobj(), + (*base->open)(gobj(), Glib::ArrayHandler<type_vec_files::value_type>::vector_to_array(files).data(), files.size(), hint.c_str()); @@ -194,7 +194,7 @@ void Gio::Application::on_open(const Application::type_vec_files& files, const G void Application::open(const type_vec_files& files, const Glib::ustring& hint) { - g_application_open(gobj(), + g_application_open(gobj(), Glib::ArrayHandler<type_vec_files::value_type>::vector_to_array(files).data(), files.size(), hint.c_str()); diff --git a/gio/src/application.hg b/gio/src/application.hg index 093d7b76..d10f8a54 100644 --- a/gio/src/application.hg +++ b/gio/src/application.hg @@ -159,7 +159,7 @@ public: */ void open(const type_vec_files& files, const Glib::ustring& hint = Glib::ustring()); _IGNORE(g_application_open) - + /* Opens the given file. * * In essence, this results in the open signal being emitted @@ -202,7 +202,7 @@ public: _WRAP_SIGNAL(void startup(), "startup") _WRAP_SIGNAL(void activate(), "activate") - + //We wrap the open signal without _WRAP_SIGNAL(), because we need to change its parameters. //See bug https://bugzilla.gnome.org/show_bug.cgi?id=637457 Glib::SignalProxy2< void, const type_vec_files&, const Glib::ustring& > signal_open(); @@ -225,7 +225,7 @@ protected: #m4 _CONVERSION(`char**&', `gchar***',`&($3)') #m4 _CONVERSION(`gchar***', `char**&',`*($3)') _WRAP_VFUNC(bool local_command_line(char**& arguments, int& exit_status), local_command_line) - + #m4 _CONVERSION(`GVariant*',`const Glib::VariantBase&',`Glib::wrap($3,true)') _WRAP_VFUNC(void before_emit(const Glib::VariantBase& platform_data), "before_emit") @@ -240,7 +240,7 @@ protected: private: /** This is just a way to call Glib::init() (which calls g_type_init()) before - * calling application_class_.init(), so that + * calling application_class_.init(), so that * g_application_get_type() will always succeed. * See https://bugzilla.gnome.org/show_bug.cgi?id=639925 */ diff --git a/gio/src/applicationcommandline.ccg b/gio/src/applicationcommandline.ccg index 8cc2b062..1e16f2de 100644 --- a/gio/src/applicationcommandline.ccg +++ b/gio/src/applicationcommandline.ccg @@ -14,7 +14,7 @@ * License along with this library; if not, write to the Free * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ - + #include <gio/gio.h> #include <glibmm/vectorutils.h> @@ -23,12 +23,12 @@ namespace Gio void ApplicationCommandLine::print(const Glib::ustring& message) { - g_application_command_line_print(gobj(), "%s", message.c_str()); + g_application_command_line_print(gobj(), "%s", message.c_str()); } void ApplicationCommandLine::printerr(const Glib::ustring& message) { - g_application_command_line_printerr(gobj(), "%s", message.c_str()); + g_application_command_line_printerr(gobj(), "%s", message.c_str()); } } //namespace Gio diff --git a/gio/src/applicationcommandline.hg b/gio/src/applicationcommandline.hg index 9ec31fec..c8311b13 100644 --- a/gio/src/applicationcommandline.hg +++ b/gio/src/applicationcommandline.hg @@ -62,25 +62,25 @@ protected: public: _WRAP_METHOD(char** get_arguments(int& argc) const, g_application_command_line_get_arguments) - + //We use std::string instead of ustring because the C documentation says that it may be non-UTF-8 data: _WRAP_METHOD(std::string get_cwd() const, g_application_command_line_get_cwd) //We use std::string instead of ustring because the C documentation says that it may be non-UTF-8 data: #m4 _CONVERSION(`const gchar* const*',`std::vector<std::string>',`Glib::ArrayHandler<std::string>::array_to_vector($3, Glib::OWNERSHIP_NONE)') _WRAP_METHOD(std::vector<std::string> get_environ() const, g_application_command_line_get_environ) - + //We use std::string instead of ustring because the C documentation says that it may be non-UTF-8 data: _WRAP_METHOD(std::string getenv(const Glib::ustring& name) const, g_application_command_line_getenv) - + _WRAP_METHOD(bool is_remote() const, g_application_command_line_get_is_remote) #m4 _CONVERSION(`GVariant*',`Glib::Variant< std::map<Glib::ustring, Glib::VariantBase> >',`$2($3)') _WRAP_METHOD(Glib::Variant< std::map<Glib::ustring, Glib::VariantBase> > get_platform_data() const, g_application_command_line_get_platform_data) - + _WRAP_METHOD(void set_exit_status(int exit_status), g_application_command_line_set_exit_status) _WRAP_METHOD(int get_exit_status() const, g_application_command_line_get_exit_status) - + /** Formats a message and prints it using the stdout print handler in the invoking process. * If this is a local invocation then this is exactly equivalent to g_print(). * If this is remote then this is equivalent to calling g_print() in the invoking process. @@ -89,7 +89,7 @@ public: */ void print(const Glib::ustring& message); _IGNORE(g_application_command_line_print) - + /** Formats a message and prints it using the stderr print handler in the invoking process. * If this is a local invocation then this is exactly equivalent to g_printerr(). * If this is remote then this is equivalent to calling g_printerr() in the invoking process. diff --git a/gio/src/asyncinitable.ccg b/gio/src/asyncinitable.ccg index 882f780e..6a3c855a 100644 --- a/gio/src/asyncinitable.ccg +++ b/gio/src/asyncinitable.ccg @@ -87,7 +87,7 @@ void AsyncInitable_Class::init_async_vfunc_callback(GAsyncInitable* self, #endif //GLIBMM_EXCEPTIONS_ENABLED } } - + BaseClassType *const base = static_cast<BaseClassType*>( g_type_interface_peek_parent( // Get the parent interface of the interface (The original underlying C interface). g_type_interface_peek(G_OBJECT_GET_CLASS(self), CppObjectType::get_type()) // Get the interface. @@ -144,7 +144,7 @@ gboolean AsyncInitable_Class::init_finish_vfunc_callback(GAsyncInitable* self, #endif //GLIBMM_EXCEPTIONS_ENABLED } } - + BaseClassType *const base = static_cast<BaseClassType*>( g_type_interface_peek_parent( // Get the parent interface of the interface (The original underlying C interface). g_type_interface_peek(G_OBJECT_GET_CLASS(self), CppObjectType::get_type()) // Get the interface. @@ -158,7 +158,7 @@ g_type_interface_peek(G_OBJECT_GET_CLASS(self), CppObjectType::get_type()) // Ge typedef gboolean RType; return RType(); } -bool Gio::AsyncInitable::init_finish_vfunc(const Glib::RefPtr<AsyncResult>& res) +bool Gio::AsyncInitable::init_finish_vfunc(const Glib::RefPtr<AsyncResult>& res) { BaseClassType *const base = static_cast<BaseClassType*>( g_type_interface_peek_parent( // Get the parent interface of the interface (The original underlying C interface). diff --git a/gio/src/asyncinitable.hg b/gio/src/asyncinitable.hg index d12fddfc..c1d8e793 100644 --- a/gio/src/asyncinitable.hg +++ b/gio/src/asyncinitable.hg @@ -46,7 +46,7 @@ class Cancellable; * C applications you generally just call g_async_initable_new_async() * directly, or indirectly via a foo_thing_new_async() wrapper. This will call * g_async_initable_init_async() under the cover, calling back with NULL and a - * set GError on failure. + * set GError on failure. */ class AsyncInitable : public Glib::Interface { @@ -109,7 +109,7 @@ protected: /** @throw Glib::Errror. */ virtual bool init_finish_vfunc(const Glib::RefPtr<AsyncResult>& res); - + protected: #m4begin _PUSH(SECTION_PCC_CLASS_INIT_VFUNCS) diff --git a/gio/src/asyncresult.hg b/gio/src/asyncresult.hg index fa1a809e..133d1859 100644 --- a/gio/src/asyncresult.hg +++ b/gio/src/asyncresult.hg @@ -45,57 +45,57 @@ class AsyncResult; typedef sigc::slot<void, Glib::RefPtr<AsyncResult>& > SlotAsyncReady; /** Provides a base class for implementing asynchronous function results. - * Asynchronous operations are broken up into two separate operations which are chained together by a SlotAsyncReady. - * To begin an asynchronous operation, provide a SlotAsyncReady to the asynchronous function. This callback will be triggered - * when the operation has completed, and will be passed an AsyncResult instance filled with the details of the operation's success or - * failure, the object the asynchronous function was started for and any error codes returned. The asynchronous callback function is then + * Asynchronous operations are broken up into two separate operations which are chained together by a SlotAsyncReady. + * To begin an asynchronous operation, provide a SlotAsyncReady to the asynchronous function. This callback will be triggered + * when the operation has completed, and will be passed an AsyncResult instance filled with the details of the operation's success or + * failure, the object the asynchronous function was started for and any error codes returned. The asynchronous callback function is then * expected to call the corresponding "_finish()" function with the object the function was called for, and the AsyncResult instance. * - * The purpose of the "_finish()" function is to take the generic result of type AsyncResult and return the specific result that the operation - * in question yields (e.g. a FileEnumerator for an "enumerate children" operation). If the result or error status of the operation is not needed, - * there is no need to call the "_finish()" function and GIO will take care of cleaning up the result and error information after the + * The purpose of the "_finish()" function is to take the generic result of type AsyncResult and return the specific result that the operation + * in question yields (e.g. a FileEnumerator for an "enumerate children" operation). If the result or error status of the operation is not needed, + * there is no need to call the "_finish()" function and GIO will take care of cleaning up the result and error information after the * SlotAsyncReady returns. You may also store the AsyncResult and call "_finish()" later. * * Example of a typical asynchronous operation flow: * @code - * void _theoretical_frobnitz_async(const Glib::RefPtr<Theoretical>& t, + * void _theoretical_frobnitz_async(const Glib::RefPtr<Theoretical>& t, * const SlotAsyncReady& slot); - * + * * gboolean _theoretical_frobnitz_finish(const Glib::RefPtr<Theoretical>& t, * const Glib::RefPtr<AsyncResult>& result); - * - * static void + * + * static void * on_frobnitz_result(Glib::RefPtr<AsyncResult>& result) * { - * + * * Glib::RefPtr<Glib::Object> source_object = result->get_source_object(); * bool success = _theoretical_frobnitz_finish(source_object, res); - * + * * if (success) * std::cout << "Hurray" << std::endl; - * else + * else * std::cout << "Uh oh!" << std::endl; - * + * * ... * } - * + * * int main (int argc, void *argv[]) * { * ... - * - * _theoretical_frobnitz_async (theoretical_data, + * + * _theoretical_frobnitz_async (theoretical_data, * sigc::ptr_fun(&on_frobnitz_result) ); - * + * * ... * } * @endcode * * The async function could also take an optional Glib::Cancellable object, allowing the calling function to cancel the asynchronous operation. * - * The callback for an asynchronous operation is called only once, and is always called, even in the case of a cancelled operation. + * The callback for an asynchronous operation is called only once, and is always called, even in the case of a cancelled operation. * On cancellation the result is a ERROR_CANCELLED error. * - * Some ascynchronous operations are implemented using synchronous calls. These are run in a separate GThread, but otherwise they are sent + * Some ascynchronous operations are implemented using synchronous calls. These are run in a separate GThread, but otherwise they are sent * to the Main Event Loop and processed in an idle function. So, if you truly need asynchronous operations, make sure to initialize GThread. * * @newin{2,16} diff --git a/gio/src/bufferedinputstream.hg b/gio/src/bufferedinputstream.hg index 340087ed..d711fb56 100644 --- a/gio/src/bufferedinputstream.hg +++ b/gio/src/bufferedinputstream.hg @@ -27,15 +27,15 @@ namespace Gio { /** @defgroup Streams Stream Classes - * + * */ /** The buffered input stream implements FilterInputStream and provides for buffered reads. - * By default, BufferedInputStream's buffer size is set at 4 kilobytes, but you can specify + * By default, BufferedInputStream's buffer size is set at 4 kilobytes, but you can specify * this to the constructor. - * - * To get the size of a buffer within a buffered input stream, use get_buffer_size(). - * To change the size of a buffered input stream's buffer, use set_buffer_size(). + * + * To get the size of a buffer within a buffered input stream, use get_buffer_size(). + * To change the size of a buffered input stream's buffer, use set_buffer_size(). * Note that the buffer's size cannot be reduced below the size of the data within the buffer. * * @ingroup Streams @@ -47,18 +47,18 @@ class BufferedInputStream : public Gio::FilterInputStream _CLASS_GOBJECT(BufferedInputStream, GBufferedInputStream, G_BUFFERED_INPUT_STREAM, Gio::FilterInputStream, GFilterInputStream) protected: _WRAP_CTOR(BufferedInputStream(const Glib::RefPtr<InputStream>& base_stream), g_buffered_input_stream_new) - + //Note that we rename the size parameter to buffer_size because that is the actual name of the property. _WRAP_CTOR(BufferedInputStream(const Glib::RefPtr<InputStream>& base_stream, gsize buffer_size), g_buffered_input_stream_new_sized) public: - /** Creates a new InputStream from the given base_stream, with a buffer set to the default size (4 kilobytes). + /** Creates a new InputStream from the given base_stream, with a buffer set to the default size (4 kilobytes). * * @param base_stream An InputStream. * @result an InputStream for the given base_stream. */ _WRAP_CREATE(const Glib::RefPtr<InputStream>& base_stream) - + /** Creates a new InputStream from the given base_stream, with a buffer set to size. * * @param base_stream An InputStream. diff --git a/gio/src/bufferedoutputstream.hg b/gio/src/bufferedoutputstream.hg index 3a1ecca7..7d35ca9b 100644 --- a/gio/src/bufferedoutputstream.hg +++ b/gio/src/bufferedoutputstream.hg @@ -27,11 +27,11 @@ namespace Gio { /** The buffered output stream implements FilterOutputStream and provides for buffered writes. - * By default, BufferedOutputStream's buffer size is set at 4 kilobytes, but you + * By default, BufferedOutputStream's buffer size is set at 4 kilobytes, but you * can specify this to the constructor. * - * To get the size of a buffer within a buffered input stream, use get_buffer_size(). - * To change the size of a buffered output stream's buffer, use set_buffer_size(). + * To get the size of a buffer within a buffered input stream, use get_buffer_size(). + * To change the size of a buffered output stream's buffer, use set_buffer_size(). * Note that the buffer's size cannot be reduced below the size of the data within the buffer. * * @ingroup Streams @@ -43,7 +43,7 @@ class BufferedOutputStream : public Gio::FilterOutputStream _CLASS_GOBJECT(BufferedOutputStream, GBufferedOutputStream, G_BUFFERED_OUTPUT_STREAM, Gio::FilterOutputStream, GFilterOutputStream) protected: _WRAP_CTOR(BufferedOutputStream(const Glib::RefPtr<OutputStream>& base_stream), g_buffered_output_stream_new) - + //Note that we rename the size parameter to buffer_size because that is the actual name of the property. _WRAP_CTOR(BufferedOutputStream(const Glib::RefPtr<OutputStream>& base_stream, gsize buffer_size), g_buffered_output_stream_new_sized) @@ -54,12 +54,12 @@ public: * @result an OutputStream for the given base stream. */ _WRAP_CREATE(const Glib::RefPtr<OutputStream>& base_stream) - - /** Creates a new buffered output stream with a given buffer size. + + /** Creates a new buffered output stream with a given buffer size. * * @param base_stream An InputStream. * @param size A size. - * @result an OutputStream with an internal buffer set to size. + * @result an OutputStream with an internal buffer set to size. */ static Glib::RefPtr<BufferedOutputStream> create_sized(const Glib::RefPtr<OutputStream>& base_stream, gsize buffer_size); diff --git a/gio/src/converter.hg b/gio/src/converter.hg index fbd92be0..03195355 100644 --- a/gio/src/converter.hg +++ b/gio/src/converter.hg @@ -38,7 +38,7 @@ _WRAP_ENUM(ConverterFlags, GConverterFlags) * ways. The conversion can be stateful and may fail at any place. * * Some example conversions are: character set conversion, compression, - * decompression and regular expression replace. + * decompression and regular expression replace. * * @newin{2,34} */ diff --git a/gio/src/converterinputstream.hg b/gio/src/converterinputstream.hg index c7b9f994..8c0e39af 100644 --- a/gio/src/converterinputstream.hg +++ b/gio/src/converterinputstream.hg @@ -36,7 +36,7 @@ class InputStream; class ConverterInputStream : public FilterInputStream, public PollableInputStream { - _CLASS_GOBJECT(ConverterInputStream, GConverterInputStream, G_CONVERTER_INPUT_STREAM, FilterInputStream, GFilterInputStream) + _CLASS_GOBJECT(ConverterInputStream, GConverterInputStream, G_CONVERTER_INPUT_STREAM, FilterInputStream, GFilterInputStream) _IMPLEMENTS_INTERFACE(PollableInputStream) protected: diff --git a/gio/src/converteroutputstream.hg b/gio/src/converteroutputstream.hg index 6fea0271..eeb5d9d8 100644 --- a/gio/src/converteroutputstream.hg +++ b/gio/src/converteroutputstream.hg @@ -36,7 +36,7 @@ class OutputStream; class ConverterOutputStream : public FilterOutputStream, public PollableOutputStream { - _CLASS_GOBJECT(ConverterOutputStream, GConverterOutputStream, G_CONVERTER_OUTPUT_STREAM, FilterOutputStream, GFilterOutputStream) + _CLASS_GOBJECT(ConverterOutputStream, GConverterOutputStream, G_CONVERTER_OUTPUT_STREAM, FilterOutputStream, GFilterOutputStream) _IMPLEMENTS_INTERFACE(PollableOutputStream) protected: diff --git a/gio/src/dbusconnection.hg b/gio/src/dbusconnection.hg index d8be6e1b..5537e005 100644 --- a/gio/src/dbusconnection.hg +++ b/gio/src/dbusconnection.hg @@ -56,7 +56,7 @@ _GMMPROC_EXTRA_NAMESPACE(DBus) /** @defgroup DBus D-Bus API * * API to use D-Bus services as a client or to implement a D-Bus service. - * To write client code, see Gio::DBus::Proxy. + * To write client code, see Gio::DBus::Proxy. * To export objects on the bus for other clients, see Gio::DBus::own_name(), for instance. */ @@ -943,10 +943,10 @@ public: const Glib::RefPtr<InterfaceInfo>& interface_info, const InterfaceVTable& vtable); _IGNORE(g_dbus_connection_register_object) - + /** Registers exported objects at @a object_path with the D-Bus - * interface that is described in @a interface_info. This method overload, - * which does not take a VTable, is useful for + * interface that is described in @a interface_info. This method overload, + * which does not take a VTable, is useful for * <a href=="http://en.wikipedia.org/wiki/Marker_interface_pattern">marker * interfaces</href>. * diff --git a/gio/src/dbuserrorutils.hg b/gio/src/dbuserrorutils.hg index 00b576a0..a2c8ece7 100644 --- a/gio/src/dbuserrorutils.hg +++ b/gio/src/dbuserrorutils.hg @@ -38,9 +38,9 @@ namespace ErrorUtils /** Checks if @a error represents an error received via D-Bus from a remote * peer. If so, use get_remote_error() to get the name of the error. * - * @param error A Glib::Error. + * @param error A Glib::Error. * @return <tt>true</tt> if error represents an error from a remote peer, - * <tt>false</tt> otherwise. + * <tt>false</tt> otherwise. * @newin{2,28} * @ingroup DBus */ @@ -67,9 +67,9 @@ Glib::ustring get_remote_error(const Glib::Error& error); * * This is typically used when presenting errors to the end user. * - * @param error A Glib::Error. + * @param error A Glib::Error. * @return <tt>true</tt> if information was stripped, <tt>false</tt> - * otherwise. + * otherwise. * @newin{2,28} * @ingroup DBus */ diff --git a/gio/src/dbusintrospection.ccg b/gio/src/dbusintrospection.ccg index cd6c2971..771dbef7 100644 --- a/gio/src/dbusintrospection.ccg +++ b/gio/src/dbusintrospection.ccg @@ -26,18 +26,18 @@ namespace Gio namespace DBus { -//We hand-code this because g_dbus_node_info_lookup_interface() doesn't +//We hand-code this because g_dbus_node_info_lookup_interface() doesn't //do this when it takes a NULL. //See bug https://bugzilla.gnome.org/show_bug.cgi?id=646417 Glib::RefPtr<InterfaceInfo> NodeInfo::lookup_interface() { Glib::RefPtr<InterfaceInfo> retvalue; - + if(!gobj() || !(gobj()->interfaces)) return retvalue; retvalue = Glib::wrap(gobj()->interfaces[0]); - + if(retvalue) retvalue->reference(); //The function does not do a ref for us. @@ -48,7 +48,7 @@ Glib::RefPtr<const InterfaceInfo> NodeInfo::lookup_interface() const { return const_cast<NodeInfo*>(this)->lookup_interface(); } - + } //namespace DBus - + } // namespace Gio diff --git a/gio/src/dbusintrospection.hg b/gio/src/dbusintrospection.hg index 1e156374..9613edf0 100644 --- a/gio/src/dbusintrospection.hg +++ b/gio/src/dbusintrospection.hg @@ -140,7 +140,7 @@ public: _WRAP_METHOD(Glib::RefPtr<InterfaceInfo> lookup_interface(const Glib::ustring& name), g_dbus_node_info_lookup_interface, refreturn) _WRAP_METHOD(Glib::RefPtr<const InterfaceInfo> lookup_interface(const Glib::ustring& name) const, g_dbus_node_info_lookup_interface, constversion, refreturn) - + /** Looks up information about the first interface. */ Glib::RefPtr<InterfaceInfo> lookup_interface(); @@ -148,7 +148,7 @@ public: /** Looks up information about the first interface. */ Glib::RefPtr<const InterfaceInfo> lookup_interface() const; - + //TODO: _WRAP_METHOD(void generate_xml(guint indent, GString* string_builder), g_dbus_node_info_generate_xml) }; diff --git a/gio/src/dbusmessage.hg b/gio/src/dbusmessage.hg index 4e5c5b15..3ca25115 100644 --- a/gio/src/dbusmessage.hg +++ b/gio/src/dbusmessage.hg @@ -64,7 +64,7 @@ public: // See here about whether the parameters should be ustring or std::string: // http://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-names - // They are generally UTF-8 that can only contain the ASCII subset, + // They are generally UTF-8 that can only contain the ASCII subset, // so ustring still seems preferrable to std::string, which generally implies an unknown endoding for us. _WRAP_METHOD(static Glib::RefPtr<Message> create_signal(const Glib::ustring& path, const Glib::ustring& interface, const Glib::ustring& signal), g_dbus_message_new_signal) diff --git a/gio/src/drive.ccg b/gio/src/drive.ccg index a51d749b..c0568616 100644 --- a/gio/src/drive.ccg +++ b/gio/src/drive.ccg @@ -49,7 +49,7 @@ void Drive::eject(const SlotAsyncReady& slot, MountUnmountFlags flags) SlotAsyncReady* slot_copy = new SlotAsyncReady(slot); g_drive_eject_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), 0, // mount_operation 0, // cancellable &SignalProxy_async_callback, @@ -89,7 +89,7 @@ void Drive::eject(const Glib::RefPtr<MountOperation>& mount_operation, const Slo void Drive::eject(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags) { g_drive_eject_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), Glib::unwrap(mount_operation), 0, // cancellable 0, // callback @@ -99,7 +99,7 @@ void Drive::eject(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmo void Drive::eject(MountUnmountFlags flags) { g_drive_eject_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), 0, // mount_operation 0, // cancellable 0, // callback diff --git a/gio/src/drive.hg b/gio/src/drive.hg index 3d60f517..b3406666 100644 --- a/gio/src/drive.hg +++ b/gio/src/drive.hg @@ -40,11 +40,11 @@ _WRAP_ENUM(DriveStartStopType, GDriveStartStopType) /** Virtual File System drive management. * * This represent a piece of hardware connected to the machine. It's generally only created for removable hardware or hardware with removable media. - * Gio::Drive is a container class for Gio::Volume objects that stem from the same piece of media. As such, Gio::Drive abstracts a drive with - * (or without) removable media and provides operations for querying whether media is available, determing whether media change is automatically + * Gio::Drive is a container class for Gio::Volume objects that stem from the same piece of media. As such, Gio::Drive abstracts a drive with + * (or without) removable media and provides operations for querying whether media is available, determing whether media change is automatically * detected and ejecting the media. * - * If the Gio::Drive reports that media isn't automatically detected, one can poll for media; typically one should not do this periodically as a + * If the Gio::Drive reports that media isn't automatically detected, one can poll for media; typically one should not do this periodically as a * poll for media operation is potententially expensive and may spin up the drive, creating noise. * * @newin{2,16} @@ -127,7 +127,7 @@ public: errthrow) _WRAP_METHOD(std::string get_identifier(const std::string& kind) const, g_drive_get_identifier) - + #m4 _CONVERSION(`char**',`Glib::StringArrayHandle',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)') _WRAP_METHOD(Glib::StringArrayHandle enumerate_identifiers() const, g_drive_enumerate_identifiers) @@ -184,11 +184,11 @@ Glib::RefPtr<Gio::Drive> wrap(GDrive* object, bool take_copy); namespace Container_Helpers { -/** This specialization of TypeTraits exists - * because the default use of Glib::wrap(GObject*), +/** This specialization of TypeTraits exists + * because the default use of Glib::wrap(GObject*), * instead of a specific Glib::wrap(GSomeInterface*), * would not return a wrapper for an interface. - */ + */ template <> struct TypeTraits< Glib::RefPtr<Gio::Drive> > { @@ -201,7 +201,7 @@ struct TypeTraits< Glib::RefPtr<Gio::Drive> > static CppType to_cpp_type (const CType& item) { - //Use a specific Glib::wrap() function, + //Use a specific Glib::wrap() function, //because CType has the specific type (not just GObject): return Glib::wrap(item, true /* take_copy */); } diff --git a/gio/src/file.ccg b/gio/src/file.ccg index 04b1bf44..1216ff07 100644 --- a/gio/src/file.ccg +++ b/gio/src/file.ccg @@ -971,7 +971,7 @@ void File::unmount_mountable(MountUnmountFlags flags) { g_file_unmount_mountable_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), 0, 0, 0, @@ -1013,7 +1013,7 @@ void File::unmount_mountable(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags) { g_file_unmount_mountable_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), Glib::unwrap(mount_operation), 0, 0, diff --git a/gio/src/file.hg b/gio/src/file.hg index 47cad106..b0b07ed7 100644 --- a/gio/src/file.hg +++ b/gio/src/file.hg @@ -58,29 +58,29 @@ _WRAP_ENUM(FileMonitorFlags, GFileMonitorFlags, NO_GTYPE) /** File and directory handling. - * Gio::File is a high level abstraction for manipulating files on a virtual file system. Gio::Files are lightweight, immutable objects that do no - * I/O upon creation. It is necessary to understand that a Gio::File object does not represent a file, merely a handle to a file. All file I/O is + * Gio::File is a high level abstraction for manipulating files on a virtual file system. Gio::Files are lightweight, immutable objects that do no + * I/O upon creation. It is necessary to understand that a Gio::File object does not represent a file, merely a handle to a file. All file I/O is * implemented as streaming operations (see Gio::InputStream and Gio::OutputStream). * * A GioFile can be constructed from a path, URI, or a command line argument. * - * You can move through the filesystem with Gio::File handles with get_parent() to get a handle to the parent directory, + * You can move through the filesystem with Gio::File handles with get_parent() to get a handle to the parent directory, * get_child() to get a handle to a child within a directory, and resolve_relative_path() to resolve a relative path between two Gio::Files. * - * Many Gio::File operations have both synchronous and asynchronous versions to suit your application. Asynchronous versions of synchronous - * functions simply have _async() appended to their function names. The asynchronous I/O functions call a SlotAsyncReady callback slot which is + * Many Gio::File operations have both synchronous and asynchronous versions to suit your application. Asynchronous versions of synchronous + * functions simply have _async() appended to their function names. The asynchronous I/O functions call a SlotAsyncReady callback slot which is * then used to finalize the operation, producing a AsyncResult which is then passed to the function's matching _finish() operation. * - * Some Gio::File operations do not have synchronous analogs, as they may take a very long time to finish, and blocking may leave an application - * unusable. Notable cases include: mount_mountable() to mount a mountable file, unmount_mountable() to unmount a mountable file, + * Some Gio::File operations do not have synchronous analogs, as they may take a very long time to finish, and blocking may leave an application + * unusable. Notable cases include: mount_mountable() to mount a mountable file, unmount_mountable() to unmount a mountable file, * and eject_mountable() to eject a mountable file. - * - * One notable feature of Gio::Files are entity tags, or "etags" for short. Entity tags are somewhat like a more abstract version of the - * traditional mtime, and can be used to quickly determine if the file has been modified from the version on the file system. + * + * One notable feature of Gio::Files are entity tags, or "etags" for short. Entity tags are somewhat like a more abstract version of the + * traditional mtime, and can be used to quickly determine if the file has been modified from the version on the file system. * See the HTTP 1.1 specification for HTTP Etag headers, which are a very similar concept. * * @newin{2,16} - */ + */ class File : public Glib::Interface { _CLASS_INTERFACE(File, GFile, G_FILE, GFileIface) @@ -116,8 +116,8 @@ public: static Glib::RefPtr<File> create_for_uri(const std::string& uri); _IGNORE(g_file_new_for_uri) - /** Constructs a File for a given argument from the command line. - * The value of @a arg can be either a URI, an absolute path or a relative path resolved relative to the current working directory. + /** Constructs a File for a given argument from the command line. + * The value of @a arg can be either a URI, an absolute path or a relative path resolved relative to the current working directory. * This operation never fails, but the returned object might not support any I/O operation if arg points to a malformed path. * * @param arg A string containing a relative or absolute path. @@ -148,7 +148,7 @@ public: _WRAP_METHOD(std::string get_uri() const, g_file_get_uri) _WRAP_METHOD(Glib::ustring get_parse_name() const, g_file_get_parse_name) - //Note that these return a reference (usually new instances, + //Note that these return a reference (usually new instances, //so we don't need to use refreturn. //TODO: Do we need const and unconst versions of these get_*() methods, @@ -218,16 +218,16 @@ public: /** Gets an output stream for appending data to the file. If * the file doesn't already exist it is created. - * + * * By default files created are generally readable by everyone, * but if you pass FILE_CREATE_PRIVATE in @a flags the file * will be made readable only to the current user, to the level that * is supported on the target filesystem. - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. - * + * was cancelled, a Gio::Error with CANCELLED will be thrown. + * * Some filesystems don't allow all filenames, and may * throw a Gio::Error with INVALID_FILENAME. * If the file is a directory a Gio::Error with IS_DIRECTORY will be @@ -241,15 +241,15 @@ public: /** Gets an output stream for appending data to the file. If * the file doesn't already exist it is created. - * + * * By default files created are generally readable by everyone, * but if you pass FILE_CREATE_PRIVATE in @a flags the file * will be made readable only to the current user, to the level that * is supported on the target filesystem. - * + * * Some filesystems don't allow all filenames, and may * throw a Gio::Error with INVALID_FILENAME. - * If the file is a directory a Gio::Error with IS_DIRECTORY will be + * If the file is a directory a Gio::Error with IS_DIRECTORY will be * thrown. Other errors are possible too, and depend on what kind of * filesystem the file is on. * @param flags A set of FileCreateFlags. @@ -258,21 +258,21 @@ public: Glib::RefPtr<FileOutputStream> append_to(FileCreateFlags flags = FILE_CREATE_NONE); _IGNORE(g_file_append_to) - //We renamed this to create_file from (g_file_create() and g_file_create_readwrite), to avoid confusion with static create() methods, + //We renamed this to create_file from (g_file_create() and g_file_create_readwrite), to avoid confusion with static create() methods, //but I would still like to choose a different word, but can't think of a good one. murrayc. /** Creates a new file and returns an output stream for writing to it. * The file must not already exist. - * + * * By default files created are generally readable by everyone, * but if you pass FILE_CREATE_PRIVATE in @a flags the file * will be made readable only to the current user, to the level that * is supported on the target filesystem. - * - * The operation can be cancelled by triggering the cancellable object from another thread. + * + * The operation can be cancelled by triggering the cancellable object from another thread. * If the operation was cancelled, a Gio::Error with CANCELLED will be thrown. - * - * If a file with this name already exists a Gio::Error with EXISTS + * + * If a file with this name already exists a Gio::Error with EXISTS * will be thrown. If the file is a directory a Gio::Error with IS_DIRECTORY * will be thrown. * @@ -290,13 +290,13 @@ public: /** Creates a new file and returns an output stream for writing to it. * The file must not already exist. - * + * * By default files created are generally readable by everyone, * but if you pass FILE_CREATE_PRIVATE in @a flags the file * will be made readable only to the current user, to the level that * is supported on the target filesystem. - * - * If a file with this name already exists a Gio::Error with EXISTS + * + * If a file with this name already exists a Gio::Error with EXISTS * will be thrown. If the file is a directory a Gio::Error with IS_DIRECTORY * will be thrown. * @@ -314,16 +314,16 @@ public: /** Creates a new file and returns a stream for reading and writing to it. * The file must not already exist. - * + * * By default files created are generally readable by everyone, * but if you pass FILE_CREATE_PRIVATE in @a flags the file * will be made readable only to the current user, to the level that * is supported on the target filesystem. - * - * The operation can be cancelled by triggering the cancellable object from another thread. + * + * The operation can be cancelled by triggering the cancellable object from another thread. * If the operation was cancelled, a Gio::Error with CANCELLED will be thrown. - * - * If a file with this name already exists a Gio::Error with EXISTS + * + * If a file with this name already exists a Gio::Error with EXISTS * will be thrown. If the file is a directory a Gio::Error with IS_DIRECTORY * will be thrown. * @@ -345,13 +345,13 @@ public: /** Creates a new file and returns a stream for reading and writing to it. * The file must not already exist. - * + * * By default files created are generally readable by everyone, * but if you pass FILE_CREATE_PRIVATE in @a flags the file * will be made readable only to the current user, to the level that * is supported on the target filesystem. - * - * If a file with this name already exists a Gio::Error with EXISTS + * + * If a file with this name already exists a Gio::Error with EXISTS * will be thrown. If the file is a directory a Gio::Error with IS_DIRECTORY * will be thrown. * @@ -374,33 +374,33 @@ public: /** Returns an output stream for overwriting the file, possibly creating a backup copy of the file first. - * This will try to replace the file in the safest way possible so that any errors during the writing will - * not affect an already existing copy of the file. For instance, for local files it may write to a + * This will try to replace the file in the safest way possible so that any errors during the writing will + * not affect an already existing copy of the file. For instance, for local files it may write to a * temporary file and then atomically rename over the destination when the stream is closed. * - * By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in - * @a flags the file will be made readable only to the current user, to the level that is supported on the + * By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in + * @a flags the file will be made readable only to the current user, to the level that is supported on the * target filesystem. * - * The operation can be cancelled by triggering the cancellable object from another thread. + * The operation can be cancelled by triggering the cancellable object from another thread. * If the operation was cancelled, a Gio::Error with CANCELLED will be thrown. * - * If you pass in an etag value, then this value is compared to the current entity tag of the file, - * and if they differ a Gio::Error with WRONG_ETAG will be thrown. This generally means that the file has - * been changed since you last read it. You can get the new etag from FileOutputStream::get_etag() - * after you've finished writing and closed the FileOutputStream. When you load a new file you can + * If you pass in an etag value, then this value is compared to the current entity tag of the file, + * and if they differ a Gio::Error with WRONG_ETAG will be thrown. This generally means that the file has + * been changed since you last read it. You can get the new etag from FileOutputStream::get_etag() + * after you've finished writing and closed the FileOutputStream. When you load a new file you can * use FileInputStream::query_info() to get the etag of the file. * - * If @a make_backup is true, this function will attempt to make a backup of the current file before - * overwriting it. If this fails aa Gio::Error with CANT_CREATE_BACKUP will be thrown. If you want to replace + * If @a make_backup is true, this function will attempt to make a backup of the current file before + * overwriting it. If this fails aa Gio::Error with CANT_CREATE_BACKUP will be thrown. If you want to replace * anyway, try again with @a make_backup set to false. * - * If the file is a directory a Gio::Error with IS_DIRECTORY will be thrown, and if the file is some - * other form of non-regular file then aa Gio::Error with NOT_REGULAR_FILE will be thrown. Some file - * systems don't allow all file names, and may throw a Gio::Error with INVALID_FILENAME, and if the - * name is to longa Gio::Error with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and + * If the file is a directory a Gio::Error with IS_DIRECTORY will be thrown, and if the file is some + * other form of non-regular file then aa Gio::Error with NOT_REGULAR_FILE will be thrown. Some file + * systems don't allow all file names, and may throw a Gio::Error with INVALID_FILENAME, and if the + * name is to longa Gio::Error with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and * depend on what kind of filesystem the file is on. - * + * * @param etag An optional entity tag for the current Glib::File. * @param make_backup <tt>true</tt> if a backup should be created. * @param flags A set of FileCreateFlags. @@ -410,30 +410,30 @@ public: /** Returns an output stream for overwriting the file, possibly creating a backup copy of the file first. - * This will try to replace the file in the safest way possible so that any errors during the writing will - * not affect an already existing copy of the file. For instance, for local files it may write to a + * This will try to replace the file in the safest way possible so that any errors during the writing will + * not affect an already existing copy of the file. For instance, for local files it may write to a * temporary file and then atomically rename over the destination when the stream is closed. * - * By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in - * @a flags the file will be made readable only to the current user, to the level that is supported on the + * By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in + * @a flags the file will be made readable only to the current user, to the level that is supported on the * target filesystem. * - * If you pass in an etag value, then this value is compared to the current entity tag of the file, - * and if they differ a Gio::Error with WRONG_ETAG will be thrown. This generally means that the file has - * been changed since you last read it. You can get the new etag from FileOutputStream::get_etag() - * after you've finished writing and closed the FileOutputStream. When you load a new file you can + * If you pass in an etag value, then this value is compared to the current entity tag of the file, + * and if they differ a Gio::Error with WRONG_ETAG will be thrown. This generally means that the file has + * been changed since you last read it. You can get the new etag from FileOutputStream::get_etag() + * after you've finished writing and closed the FileOutputStream. When you load a new file you can * use FileInputStream::query_info() to get the etag of the file. * - * If @a make_backup is true, this function will attempt to make a backup of the current file before - * overwriting it. If this fails aa Gio::Error with CANT_CREATE_BACKUP will be thrown. If you want to replace + * If @a make_backup is true, this function will attempt to make a backup of the current file before + * overwriting it. If this fails aa Gio::Error with CANT_CREATE_BACKUP will be thrown. If you want to replace * anyway, try again with @a make_backup set to false. * - * If the file is a directory a Gio::Error with IS_DIRECTORY will be thrown, and if the file is some - * other form of non-regular file then aa Gio::Error with NOT_REGULAR_FILE will be thrown. Some file - * systems don't allow all file names, and may throw a Gio::Error with INVALID_FILENAME, and if the - * name is to longa Gio::Error with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and + * If the file is a directory a Gio::Error with IS_DIRECTORY will be thrown, and if the file is some + * other form of non-regular file then aa Gio::Error with NOT_REGULAR_FILE will be thrown. Some file + * systems don't allow all file names, and may throw a Gio::Error with INVALID_FILENAME, and if the + * name is to longa Gio::Error with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and * depend on what kind of filesystem the file is on. - * + * * @param etag An optional entity tag for the current Glib::File. * @param make_backup <tt>true</tt> if a backup should be created. * @param flags A set of FileCreateFlags. @@ -446,7 +446,7 @@ public: /** Asynchronously opens the file for appending. * For more details, see append_to() which is the synchronous version of this call. - * + * * When the operation is finished, @a slot will be called. You can then call append_to_finish() to get the result of the operation. * @param slot A callback slot which will be called when the request is satisfied. * @param cancellable A Cancellable object which can be used to cancel the operation. @@ -457,7 +457,7 @@ public: /** Asynchronously opens the file for appending. * For more details, see append_to() which is the synchronous version of this call. - * + * * When the operation is finished, @a slot will be called. You can then call append_to_finish() to get the result of the operation. * @param slot A callback slot which will be called when the request is satisfied. * @param flags a set of FileCreateFlags. @@ -471,14 +471,14 @@ public: refreturn, errthrow) - //We renamed this to create_file_async from (g_file_create_async() and g_file_create_readwrite_async), to avoid confusion with static create() methods, + //We renamed this to create_file_async from (g_file_create_async() and g_file_create_readwrite_async), to avoid confusion with static create() methods, //but I would still like to choose a different word, but can't think of a good one. murrayc. See also create_file(). /** Asynchronously creates a new file and returns an output stream for writing to it. The file must not already exist. * For more details, see create_file() which is the synchronous version of this call. * * When the operation is finished, @a slot will be called. You can then call create_file_finish() to get the result of the operation. - * + * * @param slot A callback slot which will be called when the request is satisfied. * @param cancellable A Cancellable object which can be used to cancel the operation. * @param flags a set of FileCreateFlags. @@ -490,7 +490,7 @@ public: * For more details, see create_file() which is the synchronous version of this call. * * When the operation is finished, @a slot will be called. You can then call create_file_finish() to get the result of the operation. - * + * * @param slot A callback slot which will be called when the request is satisfied. * @param flags a set of FileCreateFlags. * @param io_priority The I/O priority of the request. @@ -509,7 +509,7 @@ public: * For more details, see create_file_readwrite() which is the synchronous version of this call. * * When the operation is finished, @a slot will be called. You can then call create_file_readwrite_finish() to get the result of the operation. - * + * * @param slot A callback slot which will be called when the request is satisfied. * @param cancellable A Cancellable object which can be used to cancel the operation. * @param flags a set of FileCreateFlags. @@ -525,7 +525,7 @@ public: * For more details, see create_file_readwrite() which is the synchronous version of this call. * * When the operation is finished, @a slot will be called. You can then call create_file_readwrite_finish() to get the result of the operation. - * + * * @param slot A callback slot which will be called when the request is satisfied. * @param flags a set of FileCreateFlags. * @param io_priority The I/O priority of the request. @@ -623,15 +623,15 @@ public: /** Returns an output stream for overwriting the file in readwrite mode, possibly creating a backup copy of the file first. - * + * * If the file doesn't exist, it will be created. * * For details about the behaviour, see replace() which does the same thing but returns an output stream only. * - * Note that in many non-local file cases read and write streams are not supported, + * Note that in many non-local file cases read and write streams are not supported, * so make sure you really need to do read and write streaming, * rather than just opening for reading or writing. - * + * * @param etag An optional entity tag for the current Glib::File. * @param make_backup <tt>true</tt> if a backup should be created. * @param flags A set of FileCreateFlags. @@ -643,15 +643,15 @@ public: /** Returns an output stream for overwriting the file in readwrite mode, possibly creating a backup copy of the file first. - * + * * If the file doesn't exist, it will be created. * * For details about the behaviour, see replace() which does the same thing but returns an output stream only. * - * Note that in many non-local file cases read and write streams are not supported, + * Note that in many non-local file cases read and write streams are not supported, * so make sure you really need to do read and write streaming, * rather than just opening for reading or writing. - * + * * @param etag An optional entity tag for the current Glib::File. * @param make_backup <tt>true</tt> if a backup should be created. * @param flags A set of FileCreateFlags. @@ -717,10 +717,10 @@ public: * means all attributes, and a wildcard like "standard::*" means all attributes in the standard * namespace. An example attribute query be "standard::*,owner::user". * The standard attributes are available as defines, like #G_FILE_ATTRIBUTE_STANDARD_NAME. - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. + * was cancelled, a Gio::Error with CANCELLED will be thrown. * * For symlinks, normally the information about the target of the * symlink is returned, rather than information about the symlink itself. @@ -822,7 +822,7 @@ public: * about the filesystem the file is on, rather than the file itself. * For instance the amount of space availible and the type of * the filesystem. - * + * * The @a attribute value is a string that specifies the file attributes that * should be gathered. It is not an error if its not possible to read a particular * requested attribute from a file, it just won't be set. @a attribute should @@ -832,11 +832,11 @@ public: * Common attributes of interest are FILE_ATTRIBUTE_FILESYSTEM_SIZE * (the total size of the filesystem in bytes), FILE_ATTRIBUTE_FILESYSTEM_FREE (number of * bytes availible), and FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem). - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. - * + * was cancelled, a Gio::Error with CANCELLED will be thrown. + * * If the file does not exist, a Gio::Error with NOT_FOUND will be thrown. * Other errors are possible too, and depend on what kind of filesystem the file is on. * @param cancellable A Cancellable object. @@ -849,7 +849,7 @@ public: * about the filesystem the file is on, rather than the file itself. * For instance the amount of space availible and the type of * the filesystem. - * + * * The @a attribute value is a string that specifies the file attributes that * should be gathered. It is not an error if its not possible to read a particular * requested attribute from a file, it just won't be set. @a attribute should @@ -859,8 +859,8 @@ public: * Common attributes of interest are FILE_ATTRIBUTE_FILESYSTEM_SIZE * (the total size of the filesystem in bytes), FILE_ATTRIBUTE_FILESYSTEM_FREE (number of * bytes availible), and FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem). - * - * + * + * * If the file does not exist, a Gio::Error with NOT_FOUND will be thrown. * Other errors are possible too, and depend on what kind of filesystem the file is on. * @param attributes An attribute query string. @@ -869,7 +869,7 @@ public: Glib::RefPtr<FileInfo> query_filesystem_info(const std::string& attributes = "*"); _IGNORE(g_file_query_filesystem_info) - _WRAP_METHOD(Glib::RefPtr<Mount> find_enclosing_mount(const Glib::RefPtr<Cancellable>& cancellable{?}), + _WRAP_METHOD(Glib::RefPtr<Mount> find_enclosing_mount(const Glib::RefPtr<Cancellable>& cancellable{?}), g_file_find_enclosing_mount, retreturn, errthrow) @@ -877,7 +877,7 @@ public: * that the file is on. The result is a FileInfo object * that contains key-value attributes (such as type or size for the * file). - * + * * For more details, see query_filesystem_info() which is the synchronous version of this call. * * When the operation is finished, @a slot will be called. You can then call query_filesystem_info_finish() to get the result of the operation. @@ -893,7 +893,7 @@ public: * that the file is on. The result is a FileInfo object * that contains key-value attributes (such as type or size for the * file). - * + * * For more details, see query_filesystem_info() which is the synchronous version of this call. * * When the operation is finished, @a slot will be called. You can then call query_filesystem_info_finish() to get the result of the operation. @@ -938,14 +938,14 @@ public: void find_enclosing_mount_async(const SlotAsyncReady& slot, int io_priority = Glib::PRIORITY_DEFAULT); _IGNORE(g_file_find_enclosing_mount_async) - _WRAP_METHOD(Glib::RefPtr<Mount> find_enclosing_mount_finish(const Glib::RefPtr<AsyncResult>& result), + _WRAP_METHOD(Glib::RefPtr<Mount> find_enclosing_mount_finish(const Glib::RefPtr<AsyncResult>& result), g_file_find_enclosing_mount_finish, refreturn, errthrow) /** Gets the requested information about the files in a directory. The result * is a FileEnumerator object that will give out FileInfo objects for * all the files in the directory. - * + * * The @a attribute value is a string that specifies the file attributes that * should be gathered. It is not an error if its not possible to read a particular * requested attribute from a file, it just won't be set. @a attribute should @@ -953,11 +953,11 @@ public: * means all attributes, and a wildcard like "standard::*" means all attributes in the standard * namespace. An example attribute query be "standard::*,owner::user". * The standard attributes are availible as defines, like FILE_ATTRIBUTE_STANDARD_NAME. - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. - * + * was cancelled, a Gio::Error with CANCELLED will be thrown. + * * If the file does not exist, a Gio::Error with NOT_FOUND will be thrown. * If the file is not a directory, a Glib::FileError with NOTDIR will be thrown. * Other errors are possible too. @@ -973,7 +973,7 @@ public: /** Gets the requested information about the files in a directory. The result * is a FileEnumerator object that will give out FileInfo objects for * all the files in the directory. - * + * * The @a attribute value is a string that specifies the file attributes that * should be gathered. It is not an error if its not possible to read a particular * requested attribute from a file, it just won't be set. @a attribute should @@ -981,7 +981,7 @@ public: * means all attributes, and a wildcard like "standard::*" means all attributes in the standard * namespace. An example attribute query be "standard::*,owner::user". * The standard attributes are availible as defines, like FILE_ATTRIBUTE_STANDARD_NAME. - * + * * If the file does not exist, a Gio::Error with NOT_FOUND will be thrown. * If the file is not a directory, a Glib::FileError with NOTDIR will be thrown. * Other errors are possible too. @@ -1053,9 +1053,9 @@ public: g_file_set_display_name_finish, errthrow) - /** Deletes a file. + /** Deletes a file. * If the file is a directory, it will only be deleted if it is empty. - * The operation can be cancelled by triggering the cancellable object from another thread. + * The operation can be cancelled by triggering the cancellable object from another thread. * If the operation was cancelled, a Glib::FileError with ERROR_CANCELLED will be thrown. * * @param cancellable A Cancellable object which can be used to cancel the operation. @@ -1116,10 +1116,10 @@ public: * * If FILE_COPY_OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown. * - * If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown. + * If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown. * If trying to overwrite a directory with a directory a Gio::Error with WOULD_MERGE will be thrown. * - * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, + * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, * then a Gio::Error with WOULD_RECURSE will be thrown. * * If you are interested in copying the Gio::File object itself (not the on-disk file), see File::dup(). @@ -1136,10 +1136,10 @@ public: * * If FILE_COPY_OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown. * - * If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown. + * If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown. * If trying to overwrite a directory with a directory a Gio::Error with WOULD_MERGE will be thrown. * - * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, + * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, * then a Gio::Error with WOULD_RECURSE will be thrown. * * If you are interested in copying the Gio::File object itself (not the on-disk file), see File::dup(). @@ -1154,10 +1154,10 @@ public: * * If FILE_COPY_OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown. * - * If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown. + * If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown. * If trying to overwrite a directory with a directory a Gio::Error with WOULD_MERGE will be thrown. * - * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, + * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, * then a Gio::Error with WOULD_RECURSE will be thrown. * * If you are interested in copying the Gio::File object itself (not the on-disk file), see File::dup(). @@ -1234,24 +1234,24 @@ public: g_file_copy_finish, errthrow) - /** Tries to move the file or directory source to the location specified by destination. If native move operations are supported then this is - * used, otherwise a copy and delete fallback is used. The native implementation may support moving directories (for instance on moves inside + /** Tries to move the file or directory source to the location specified by destination. If native move operations are supported then this is + * used, otherwise a copy and delete fallback is used. The native implementation may support moving directories (for instance on moves inside * the same filesystem), but the fallback code does not. * * If the flag FILE_COPY_OVERWRITE is specified an already existing destination file is overwritten. - * + * * If the flag FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied. - * + * * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, a Gio::Error with CANCELLED will be thrown. * * The operation can be monitored via the @a slot callback. * If the source file does not exist then a Gio::Error with NOT_FOUND will be thrown, independent on the status of the destination. - * + * * If G_FILE_COPY_OVERWRITE is not specified and the target exists, then a Gio::Error with EXISTS will be thrown. - * - * If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown. + * + * If trying to overwrite a file over a directory a Gio::Error with IS_DIRECTORY will be thrown. * If trying to overwrite a directory with a directory a Gio::Error with WOULD_MERGE will be thrown. - * + * * If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, then a Gio::Error with WOULD_RECURSE may be thrown (if the native move operation isn't available). */ bool move(const Glib::RefPtr<File>& destination, const SlotFileProgress& slot, const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags = FILE_COPY_NONE); @@ -1292,16 +1292,16 @@ public: GError **error); */ - /** Tries to set all attributes in the FileInfo on the target values, + /** Tries to set all attributes in the FileInfo on the target values, * not stopping on the first error. - * + * * If there is any error during this operation then a Gio::Error will be thrown. - * Error on particular fields are flagged by setting - * the "status" field in the attribute value to + * Error on particular fields are flagged by setting + * the "status" field in the attribute value to * FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect * further errors. - * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * @param info A FileInfo. @@ -1311,16 +1311,16 @@ public: */ bool set_attributes_from_info(const Glib::RefPtr<FileInfo>& info, const Glib::RefPtr<Cancellable>& cancellable, FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE); - /** Tries to set all attributes in the FileInfo on the target values, + /** Tries to set all attributes in the FileInfo on the target values, * not stopping on the first error. - * + * * If there is any error during this operation then a Gio::Error will be thrown. - * Error on particular fields are flagged by setting - * the "status" field in the attribute value to + * Error on particular fields are flagged by setting + * the "status" field in the attribute value to * FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect * further errors. - * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * @param info A FileInfo. @@ -1384,12 +1384,12 @@ public: g_file_set_attribute_int64, errthrow) - /** Starts a @a mount_operation, mounting the volume that contains the file. - * - * When this operation has completed, @a slot will be called with, + /** Starts a @a mount_operation, mounting the volume that contains the file. + * + * When this operation has completed, @a slot will be called with, * and the operation can be finalized with mount_enclosing_volume_finish(). - * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * @param mount_operation A MountOperation. @@ -1398,9 +1398,9 @@ public: */ void mount_enclosing_volume(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountMountFlags flags = MOUNT_MOUNT_NONE); - /** Starts a @a mount_operation, mounting the volume that contains the file. - * - * When this operation has completed, @a slot will be called with, + /** Starts a @a mount_operation, mounting the volume that contains the file. + * + * When this operation has completed, @a slot will be called with, * and the operation can be finalized with mount_enclosing_volume_finish(). * * @param mount_operation A MountOperation. @@ -1408,9 +1408,9 @@ public: */ void mount_enclosing_volume(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, MountMountFlags flags = MOUNT_MOUNT_NONE); - /** Starts a @a mount_operation, mounting the volume that contains the file. - * - * When this operation has completed, @a slot will be called with, + /** Starts a @a mount_operation, mounting the volume that contains the file. + * + * When this operation has completed, @a slot will be called with, * and the operation can be finalized with mount_enclosing_volume_finish(). * * @param slot A callback slot which will be called when the request is satisfied. @@ -1418,7 +1418,7 @@ public: void mount_enclosing_volume(const SlotAsyncReady& slot, MountMountFlags flags = MOUNT_MOUNT_NONE); _IGNORE(g_file_mount_enclosing_volume) - /** Starts a @a mount_operation, mounting the volume that contains the file. + /** Starts a @a mount_operation, mounting the volume that contains the file. * */ void mount_enclosing_volume(MountMountFlags flags = MOUNT_MOUNT_NONE); @@ -1428,10 +1428,10 @@ public: g_file_mount_enclosing_volume_finish, errthrow) - /** Mounts a file of type FILE_TYPE_MOUNTABLE. Using @a mount_operation, you can request callbacks when, for instance, + /** Mounts a file of type FILE_TYPE_MOUNTABLE. Using @a mount_operation, you can request callbacks when, for instance, * passwords are needed during authentication. * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * When the operation is finished, @a slot will be called. You can then call mount_mountable_finish() to get the result of the operation. @@ -1442,7 +1442,7 @@ public: */ void mount_mountable(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, MountMountFlags flags = MOUNT_MOUNT_NONE); - /** Mounts a file of type FILE_TYPE_MOUNTABLE. Using @a mount_operation, you can request callbacks when, for instance, + /** Mounts a file of type FILE_TYPE_MOUNTABLE. Using @a mount_operation, you can request callbacks when, for instance, * passwords are needed during authentication. * * When the operation is finished, @a slot will be called. You can then call mount_mountable_finish() to get the result of the operation. @@ -1471,7 +1471,7 @@ public: /** Unmounts a file of type FILE_TYPE_MOUNTABLE. * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * When the operation is finished, @a slot will be called. You can then call unmount_mountable_finish() to get the result of the operation. @@ -1499,7 +1499,7 @@ public: /** Unmounts a file of type FILE_TYPE_MOUNTABLE. * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * When the operation is finished, @a slot will be called. You can then call unmount_mountable_finish() to get the result of the operation. @@ -1542,7 +1542,7 @@ public: /** Starts an asynchronous eject on a mountable. * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * When the operation is finished, @a slot will be called. You can then call eject_mountable_finish() to get the result of the operation. @@ -1570,7 +1570,7 @@ public: /** Starts an asynchronous eject on a mountable. * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * When the operation is finished, @a slot will be called. You can then call eject_mountable_finish() to get the result of the operation. @@ -1612,7 +1612,7 @@ public: errthrow) - /** Copies the file attributes from @a source to @a destination. + /** Copies the file attributes from @a source to @a destination. * * Normally only a subset of the file attributes are copied, * those that are copies in a normal file copy operation @@ -1627,7 +1627,7 @@ public: */ bool copy_attributes(const Glib::RefPtr<File>& destination, const Glib::RefPtr<Cancellable>& cancellable, FileCopyFlags flags = FILE_COPY_NONE); - /** Copies the file attributes from @a source to @a destination. + /** Copies the file attributes from @a source to @a destination. * * Normally only a subset of the file attributes are copied, * those that are copies in a normal file copy operation @@ -1641,10 +1641,10 @@ public: */ bool copy_attributes(const Glib::RefPtr<File>& destination, FileCopyFlags flags = FILE_COPY_NONE); _IGNORE(g_file_copy_attributes) - + /** Obtains a directory monitor for the given file. * This may fail if directory monitoring is not supported. - * + * * The operation can be cancelled by triggering the cancellable object from another thread. If the operation * was cancelled, a Gio::Error with CANCELLED will be thrown. * @@ -1656,7 +1656,7 @@ public: /** Obtains a directory monitor for the given file. * This may fail if directory monitoring is not supported. - * + * * @param flags A set of FileMonitorFlags. * @return A FileMonitor for the file. */ @@ -1665,7 +1665,7 @@ public: /** Obtains a file monitor for the given file. If no file notification * mechanism exists, then regular polling of the file is used. - * + * * The operation can be cancelled by triggering the cancellable object from another thread. If the operation * was cancelled, a Gio::Error with CANCELLED will be thrown. * @@ -1677,7 +1677,7 @@ public: /** Obtains a file monitor for the given file. If no file notification * mechanism exists, then regular polling of the file is used. - * + * * The operation can be cancelled by triggering the cancellable object from another thread. If the operation * was cancelled, a Gio::Error with CANCELLED will be thrown. * @@ -1691,7 +1691,7 @@ public: /** Obtains a file monitor for the given file. If no file notification * mechanism exists, then regular polling of the file is used. - * + * * The operation can be cancelled by triggering the cancellable object from another thread. If the operation * was cancelled, a Gio::Error with CANCELLED will be thrown. * @@ -1705,7 +1705,7 @@ public: /** Obtains a file monitor for the given file. If no file notification * mechanism exists, then regular polling of the file is used. - * + * * The operation can be cancelled by triggering the cancellable object from another thread. If the operation * was cancelled, a Gio::Error with CANCELLED will be thrown. * @@ -1724,12 +1724,12 @@ public: * Using @a start_operation, you can request callbacks when, for instance, * passwords are needed during authentication. * - * When this operation has completed, @a slot will be called + * When this operation has completed, @a slot will be called * and the operation can be finalized with start_mountable_finish(). - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. + * was cancelled, a Gio::Error with CANCELLED will be thrown. * * @param slot: A callback to call when the request is satisfied. * @param cancellable A Cancellable object. @@ -1743,12 +1743,12 @@ public: * Using @a start_operation, you can request callbacks when, for instance, * passwords are needed during authentication. * - * When this operation has completed, @a slot will be called + * When this operation has completed, @a slot will be called * and the operation can be finalized with start_mountable_finish(). - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. + * was cancelled, a Gio::Error with CANCELLED will be thrown. * * @param slot: A callback to call when the request is satisfied. * @param cancellable A Cancellable object. @@ -1767,12 +1767,12 @@ public: * Using @a start_operation, you can request callbacks when, for instance, * passwords are needed during authentication. * - * When this operation has completed, @a slot will be called + * When this operation has completed, @a slot will be called * and the operation can be finalized with stop_mountable_finish(). - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. + * was cancelled, a Gio::Error with CANCELLED will be thrown. * * @param slot: A callback to call when the request is satisfied. * @param cancellable A Cancellable object. @@ -1787,12 +1787,12 @@ public: * Using @a start_operation, you can request callbacks when, for instance, * passwords are needed during authentication. * - * When this operation has completed, @a slot will be called + * When this operation has completed, @a slot will be called * and the operation can be finalized with stop_mountable_finish(). - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. + * was cancelled, a Gio::Error with CANCELLED will be thrown. * * @param slot: A callback to call when the request is satisfied. * @param start_operation A Cancellable object. @@ -1811,12 +1811,12 @@ public: * Using @a start_operation, you can request callbacks when, for instance, * passwords are needed during authentication. * - * When this operation has completed, @a slot will be called + * When this operation has completed, @a slot will be called * and the operation can be finalized with stop_mountable_finish(). - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. + * was cancelled, a Gio::Error with CANCELLED will be thrown. * * @param slot: A callback to call when the request is satisfied. * @param cancellable A Cancellable object. @@ -1830,12 +1830,12 @@ public: * Using @a start_operation, you can request callbacks when, for instance, * passwords are needed during authentication. * - * When this operation has completed, @a slot will be called + * When this operation has completed, @a slot will be called * and the operation can be finalized with stop_mountable_finish(). - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. + * was cancelled, a Gio::Error with CANCELLED will be thrown. * * @param slot: A callback to call when the request is satisfied. * @@ -1852,46 +1852,46 @@ public: errthrow) //TODO: Something better than char*& for contents? - /** Loads the content of the file into memory, returning the size of the data. + /** Loads the content of the file into memory, returning the size of the data. * The data is always zero terminated, but this is not included in the resultant @a length. - * - * The operation can be cancelled by triggering the cancellable object from another thread. + * + * The operation can be cancelled by triggering the cancellable object from another thread. * If the operation was cancelled, a Gio::Error exception with CANCELLED will be returned. * * @param cancellable A cancellable object. - * @param contents A location to place the contents of the file. + * @param contents A location to place the contents of the file. * @param length A location to place the length of the contents of the file. * @param etag_out A location to place the current entity tag for the file. */ bool load_contents(const Glib::RefPtr<Cancellable>& cancellable, char*& contents, gsize& length, std::string& etag_out); - /** Loads the content of the file into memory, returning the size of the data. + /** Loads the content of the file into memory, returning the size of the data. * The data is always zero terminated, but this is not included in the resultant @a length. - * - * The operation can be cancelled by triggering the cancellable object from another thread. + * + * The operation can be cancelled by triggering the cancellable object from another thread. * If the operation was cancelled, a Gio::Error exception with CANCELLED will be returned. * * @param cancellable A cancellable object. - * @param contents A location to place the contents of the file. + * @param contents A location to place the contents of the file. * @param length A location to place the length of the contents of the file. * @newin{2,22} */ bool load_contents(const Glib::RefPtr<Cancellable>& cancellable, char*& contents, gsize& length); //TODO: Something better than char*& for contents? - /** Loads the content of the file into memory, returning the size of the data. + /** Loads the content of the file into memory, returning the size of the data. * The data is always zero terminated, but this is not included in the resultant @a length. * - * @param contents A location to place the contents of the file. + * @param contents A location to place the contents of the file. * @param length A location to place the length of the contents of the file. * @param etag_out A location to place the current entity tag for the file. */ bool load_contents(char*& contents, gsize& length, std::string& etag_out); - /** Loads the content of the file into memory, returning the size of the data. + /** Loads the content of the file into memory, returning the size of the data. * The data is always zero terminated, but this is not included in the resultant @a length. * - * @param contents A location to place the contents of the file. + * @param contents A location to place the contents of the file. * @param length A location to place the length of the contents of the file. * @newin{2,22} */ @@ -1901,10 +1901,10 @@ public: /** Starts an asynchronous load of the file's contents. * For more details, see load_contents() which is the synchronous version of this call. * - * When the load operation has completed, the @a slot will be called. To finish the operation, + * When the load operation has completed, the @a slot will be called. To finish the operation, * call load_contents_finish() with the AsyncResult provided to the @a slot. * - * The operation can be cancelled by triggering the cancellable object from another thread. + * The operation can be cancelled by triggering the cancellable object from another thread. * If the operation was cancelled, a Gio::Error with CANCELLED will be thrown. * * @param slot A callback slot which will be called when the request is satisfied. @@ -1915,7 +1915,7 @@ public: /** Starts an asynchronous load of the file's contents. * For more details, see load_contents() which is the synchronous version of this call. * - * When the load operation has completed, the @a slot will be called. To finish the operation, + * When the load operation has completed, the @a slot will be called. To finish the operation, * call load_contents_finish() with the AsyncResult provided to the @a slot. * * @param slot A callback slot which will be called when the request is satisfied. @@ -1923,27 +1923,27 @@ public: void load_contents_async(const SlotAsyncReady& slot); _IGNORE(g_file_load_contents_async) - /** Finishes an asynchronous load of the @a file's contents. - * The contents are placed in @a contents, and @a length is set to the - * size of the @a contents string. If @a etag_out is present, it will be + /** Finishes an asynchronous load of the @a file's contents. + * The contents are placed in @a contents, and @a length is set to the + * size of the @a contents string. If @a etag_out is present, it will be * set to the new entity tag for the @a file. * @param res A AsyncResult. * @param contents A location to place the contents of the file. * @param length A location to place the length of the contents of the file. * @param etag_out A location to place the current entity tag for the file. - * @return <tt>true</tt> if the load was successful. If <tt>false</tt> and @a error is + * @return <tt>true</tt> if the load was successful. If <tt>false</tt> and @a error is * present, it will be set appropriately. */ bool load_contents_finish(const Glib::RefPtr<AsyncResult>& result, char*& contents, gsize& length, std::string& etag_out); - /** Finishes an asynchronous load of the @a file's contents. - * The contents are placed in @a contents, and @a length is set to the - * size of the @a contents string. If @a etag_out is present, it will be + /** Finishes an asynchronous load of the @a file's contents. + * The contents are placed in @a contents, and @a length is set to the + * size of the @a contents string. If @a etag_out is present, it will be * set to the new entity tag for the @a file. * @param res A AsyncResult. * @param contents A location to place the contents of the file. * @param length A location to place the length of the contents of the file. - * @return <tt>true</tt> if the load was successful. If <tt>false</tt> and @a error is + * @return <tt>true</tt> if the load was successful. If <tt>false</tt> and @a error is * present, it will be set appropriately. * @newin{2,22} */ @@ -1956,13 +1956,13 @@ public: */ typedef sigc::slot<bool, const char*, goffset> SlotReadMore; - //Note that slot_read_more can be NULL but that would not be a useful method overload, because the documentation says that it would + //Note that slot_read_more can be NULL but that would not be a useful method overload, because the documentation says that it would //then be equivalent to load_contents_async. /** Reads the partial contents of a file. * The @a slot_read_more callback slot should be used to stop reading from the file when appropriate. This operation can be finished by load_partial_contents_finish(). * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * When the operation is finished, @a slot will be called. You can then call load_partial_contents_finish() to get the result of the operation. @@ -1976,7 +1976,7 @@ public: /** Reads the partial contents of a file. * The @a slot_read_more callback slot should be used to stop reading from the file when appropriate. This operation can be finished by load_partial_contents_finish(). * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * When the operation is finished, @a slot will be called. You can then call load_partial_contents_finish() to get the result of the operation. @@ -1994,7 +1994,7 @@ public: * @param contents A location to place the contents of the file. * @param length A location to place the length of the contents of the file. * @param etag_out A location to place the current entity tag for the file. - * @return <tt>true</tt> if the load was successful. If <tt>false</tt> and @a error is + * @return <tt>true</tt> if the load was successful. If <tt>false</tt> and @a error is * present, it will be set appropriately. */ bool load_partial_contents_finish(const Glib::RefPtr<AsyncResult>& result, char*& contents, gsize& length, std::string& etag_out); @@ -2004,7 +2004,7 @@ public: * @param res A AsyncResult. * @param contents A location to place the contents of the file. * @param length A location to place the length of the contents of the file. - * @return <tt>true</tt> if the load was successful. If <tt>false</tt> and @a error is + * @return <tt>true</tt> if the load was successful. If <tt>false</tt> and @a error is * present, it will be set appropriately. * @newin{2,22} */ @@ -2012,21 +2012,21 @@ public: _IGNORE(g_file_load_partial_contents_finish) /** Replaces the contents of the file with @a contents of @a length bytes. - * + * * If @a etag is specified (not an empty string) any existing file must have that etag, or * a Gio::Error with WRONG_ETAG will be thrown. - * + * * If @a make_backup is <tt>true</tt>, this function will attempt to make a backup of the file. - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. - * + * was cancelled, a Gio::Error with CANCELLED will be thrown. + * * The returned @a new_etag can be used to verify that the file hasn't changed the * next time it is saved over. * @param contents A string containing the new contents for the file. * @param length The length of @a contents in bytes. - * @param etag The old entity tag + * @param etag The old entity tag * for the document. * @param make_backup <tt>true</tt> if a backup should be created. * @param flags A set of FileCreateFlags. @@ -2037,17 +2037,17 @@ public: void replace_contents(const char* contents, gsize length, const std::string& etag, std::string& new_etag, const Glib::RefPtr<Cancellable>& cancellable, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE); /** Replaces the contents of the file with @a contents of @a length bytes. - * + * * If @a etag is specified (not an empty string) any existing file must have that etag, or * a Gio::Error with WRONG_ETAG will be thrown. - * + * * If @a make_backup is <tt>true</tt>, this function will attempt to make a backup of the file. - * + * * The returned @a new_etag can be used to verify that the file hasn't changed the * next time it is saved over. * @param contents A string containing the new contents for the file. * @param length The length of @a contents in bytes. - * @param etag The old entity tag + * @param etag The old entity tag * for the document. * @param make_backup <tt>true</tt> if a backup should be created. * @param flags A set of FileCreateFlags. @@ -2057,20 +2057,20 @@ public: void replace_contents(const char* contents, gsize length, const std::string& etag, std::string& new_etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE); /** Replaces the contents of the file with @a contents. - * + * * If @a etag is specified (not an empty string) any existing file must have that etag, or * a Gio::Error with WRONG_ETAG will be thrown. - * + * * If @a make_backup is <tt>true</tt>, this function will attempt to make a backup of the file. - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. - * + * was cancelled, a Gio::Error with CANCELLED will be thrown. + * * The returned @a new_etag can be used to verify that the file hasn't changed the * next time it is saved over. * @param contents A string containing the new contents for the file. - * @param etag The old entity tag + * @param etag The old entity tag * for the document. * @param make_backup <tt>true</tt> if a backup should be created. * @param flags A set of FileCreateFlags. @@ -2081,16 +2081,16 @@ public: void replace_contents(const std::string& contents, const std::string& etag, std::string& new_etag, const Glib::RefPtr<Cancellable>& cancellable, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE); /** Replaces the contents of the file with @a contents. - * + * * If @a etag is specified (not an empty string) any existing file must have that etag, or * a Gio::Error with WRONG_ETAG will be thrown. - * + * * If @a make_backup is <tt>true</tt>, this function will attempt to make a backup of the file. - * + * * The returned @a new_etag can be used to verify that the file hasn't changed the * next time it is saved over. * @param contents A string containing the new contents for the file. - * @param etag The old entity tag + * @param etag The old entity tag * for the document. * @param make_backup <tt>true</tt> if a backup should be created. * @param flags A set of FileCreateFlags. @@ -2104,18 +2104,18 @@ public: //TODO: Add replace_contents() without the etags? - /** Starts an asynchronous replacement of the file with the given - * @a contents of @a length bytes. @a etag will replace the document's + /** Starts an asynchronous replacement of the file with the given + * @a contents of @a length bytes. @a etag will replace the document's * current entity tag. - * - * When this operation has completed, @a slot will be called + * + * When this operation has completed, @a slot will be called * and the operation can be finalized with replace_contents_finish(). - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. - * - * If @a make_backup is true, this function will attempt to + * was cancelled, a Gio::Error with CANCELLED will be thrown. + * + * If @a make_backup is true, this function will attempt to * make a backup of the file. * * @param slot: A callback to call when the request is satisfied. @@ -2128,14 +2128,14 @@ public: */ void replace_contents_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const char* contents, gsize length, const std::string& etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE); - /** Starts an asynchronous replacement of the file with the given - * @a contents of @a length bytes. @a etag will replace the document's + /** Starts an asynchronous replacement of the file with the given + * @a contents of @a length bytes. @a etag will replace the document's * current entity tag. - * - * When this operation has completed, @a slot will be called + * + * When this operation has completed, @a slot will be called * and the operation can be finalized with replace_contents_finish(). - * - * If @a make_backup is true, this function will attempt to + * + * If @a make_backup is true, this function will attempt to * make a backup of the file. * * @param slot: A callback to call when the request is satisfied. @@ -2147,18 +2147,18 @@ public: */ void replace_contents_async(const SlotAsyncReady& slot, const char* contents, gsize length, const std::string& etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE); - /** Starts an asynchronous replacement of the file with the given - * @a contents of @a length bytes. @a etag will replace the document's + /** Starts an asynchronous replacement of the file with the given + * @a contents of @a length bytes. @a etag will replace the document's * current entity tag. - * - * When this operation has completed, @a slot will be called + * + * When this operation has completed, @a slot will be called * and the operation can be finalized with replace_contents_finish(). - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. - * - * If @a make_backup is true, this function will attempt to + * was cancelled, a Gio::Error with CANCELLED will be thrown. + * + * If @a make_backup is true, this function will attempt to * make a backup of the file. * * @param slot: A callback to call when the request is satisfied. @@ -2170,18 +2170,18 @@ public: */ void replace_contents_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& contents, const std::string& etag, bool make_backup = false, FileCreateFlags flags = FILE_CREATE_NONE); - /** Starts an asynchronous replacement of the file with the given - * @a contents. @a etag will replace the document's + /** Starts an asynchronous replacement of the file with the given + * @a contents. @a etag will replace the document's * current entity tag. - * - * When this operation has completed, @a slot will be called + * + * When this operation has completed, @a slot will be called * and the operation can be finalized with replace_contents_finish(). - * + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED will be thrown. - * - * If @a make_backup is true, this function will attempt to + * was cancelled, a Gio::Error with CANCELLED will be thrown. + * + * If @a make_backup is true, this function will attempt to * make a backup of the file. * * @param slot: A callback to call when the request is satisfied. @@ -2195,16 +2195,16 @@ public: _IGNORE(g_file_replace_contents_async) /** Finishes an asynchronous replace of the given file . See - * replace_contents_async(). Sets @a new_etag to the new entity + * replace_contents_async(). Sets @a new_etag to the new entity * tag for the document. * @param result A AsyncResult. - * @param new_etag A location of a new entity tag + * @param new_etag A location of a new entity tag * for the document. */ void replace_contents_finish(const Glib::RefPtr<AsyncResult>& result, std::string& etag); /** Finishes an asynchronous replace of the given file . See - * replace_contents_async(). Sets @a new_etag to the new entity + * replace_contents_async(). Sets @a new_etag to the new entity * tag for the document. * @param result A AsyncResult. * for the document. @@ -2259,11 +2259,11 @@ Glib::RefPtr<Gio::File> wrap(GFile* object, bool take_copy); namespace Container_Helpers { -/** This specialization of TypeTraits exists - * because the default use of Glib::wrap(GObject*), +/** This specialization of TypeTraits exists + * because the default use of Glib::wrap(GObject*), * instead of a specific Glib::wrap(GSomeInterface*), * would not return a wrapper for an interface. - */ + */ template <> struct TypeTraits< Glib::RefPtr<Gio::File> > { @@ -2276,7 +2276,7 @@ struct TypeTraits< Glib::RefPtr<Gio::File> > static CppType to_cpp_type (const CType& item) { - //Use a specific Glib::wrap() function, + //Use a specific Glib::wrap() function, //because CType has the specific type (not just GObject): return Glib::wrap(item, true /* take_copy */); } diff --git a/gio/src/fileattributeinfolist.hg b/gio/src/fileattributeinfolist.hg index 5bbd25aa..dc3903aa 100644 --- a/gio/src/fileattributeinfolist.hg +++ b/gio/src/fileattributeinfolist.hg @@ -27,18 +27,18 @@ namespace Gio /** Key-Value paired file attributes. * File attributes in GIO consist of a list of key-value pairs. * - * Keys are strings that contain a key namespace and a key name, separated by a colon, e.g. "namespace:keyname". - * Namespaces are included to sort key-value pairs by namespaces for relevance. Keys can be retreived using wildcards, + * Keys are strings that contain a key namespace and a key name, separated by a colon, e.g. "namespace:keyname". + * Namespaces are included to sort key-value pairs by namespaces for relevance. Keys can be retreived using wildcards, * e.g. "standard::*" will return all of the keys in the "standard" namespace. * - * Values are stored within the list in Gio::FileAttributeValue structures. Values can store different types, listed in the enum + * Values are stored within the list in Gio::FileAttributeValue structures. Values can store different types, listed in the enum * Gio::FileAttributeType. Upon creation of a Gio::FileAttributeValue, the type will be set to Gio::FILE_ATTRIBUTE_TYPE_INVALID. * - * The list of possible attributes for a filesystem (pointed to by a Gio::File) is availible as a Gio::FileAttributeInfoList. + * The list of possible attributes for a filesystem (pointed to by a Gio::File) is availible as a Gio::FileAttributeInfoList. * This list is queryable by key names as indicated earlier. * - * Classes that implement Gio::FileIface will create a Gio::FileAttributeInfoList and install default keys and values for their given file - * system, architecture, and other possible implementation details (e.g., on a UNIX system, a file attribute key will be registered for + * Classes that implement Gio::FileIface will create a Gio::FileAttributeInfoList and install default keys and values for their given file + * system, architecture, and other possible implementation details (e.g., on a UNIX system, a file attribute key will be registered for * the user id for a given file). * * See http://library.gnome.org/devel/gio/unstable/gio-GFileAttribute.html for the list of default namespaces and the list of default keys. @@ -64,7 +64,7 @@ public: */ bool empty() const; - /** Gets the file attribute with the name name from list. + /** Gets the file attribute with the name name from list. * @param name The name of the attribute to lookup. * @result A FileAttributeInfo for the name. */ diff --git a/gio/src/fileenumerator.hg b/gio/src/fileenumerator.hg index 439971f8..85cb75ef 100644 --- a/gio/src/fileenumerator.hg +++ b/gio/src/fileenumerator.hg @@ -37,14 +37,14 @@ class File; //TODO: Consider wrapping this like a std::iterator (or at least renaming it), though the asyncness probably makes that unsuitable. /** Enumerated Files Routines. - * FileEnumerator allows you to operate on a set of Gio::Files, returning a Gio::FileInfo instance for each file enumerated + * FileEnumerator allows you to operate on a set of Gio::Files, returning a Gio::FileInfo instance for each file enumerated * (e.g. Gio::File::enumerate_children() will return a FileEnumerator for each of the children within a directory). * - * To get the next file's information from a Gio::FileEnumerator, use next_file() or its asynchronous version, next_file_async(). - * Note that the asynchronous version will return a list of Gio::FileInfos, whereas the synchronous version will only return the next + * To get the next file's information from a Gio::FileEnumerator, use next_file() or its asynchronous version, next_file_async(). + * Note that the asynchronous version will return a list of Gio::FileInfos, whereas the synchronous version will only return the next * file in the enumerator. * - * To close a Gio::FileEnumerator, use FileEnumerator::close(), or its asynchronous version, close_async(). Once a FileEnumerator is closed, + * To close a Gio::FileEnumerator, use FileEnumerator::close(), or its asynchronous version, close_async(). Once a FileEnumerator is closed, * no further actions may be performed on it. * * @newin{2,16} @@ -63,16 +63,16 @@ public: errthrow) - /** Request information for a number of files from the enumerator asynchronously. + /** Request information for a number of files from the enumerator asynchronously. * When all I/O for the operation is finished the callback slot will be called with the requested information. * - * The callback could be called with less than num_files files in case of error or at the end of the enumerator. - * In case of a partial error the callback will be called with any succeeding items and no error, and on the next request the error will be reported. + * The callback could be called with less than num_files files in case of error or at the end of the enumerator. + * In case of a partial error the callback will be called with any succeeding items and no error, and on the next request the error will be reported. * If a request is cancelled the callback will be called with ERROR_CANCELLED. * * During an async request no other sync and async calls are allowed, and will result in ERROR_PENDING errors. * - * Any outstanding I/O request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. + * Any outstanding I/O request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. * The default priority is PRIORITY_DEFAULT. * @param slot A callback to call when the request is satisfied. * @param cancellable An cancellable object which can be used to cancel the request. @@ -81,16 +81,16 @@ public: */ void next_files_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, int num_files = 1, int io_priority = Glib::PRIORITY_DEFAULT); - /** Request information for a number of files from the enumerator asynchronously. + /** Request information for a number of files from the enumerator asynchronously. * When all I/O for the operation is finished the callback slot will be called with the requested information. * - * The callback could be called with less than num_files files in case of error or at the end of the enumerator. - * In case of a partial error the callback will be called with any succeeding items and no error, and on the next request the error will be reported. + * The callback could be called with less than num_files files in case of error or at the end of the enumerator. + * In case of a partial error the callback will be called with any succeeding items and no error, and on the next request the error will be reported. * If a request is cancelled the callback will be called with ERROR_CANCELLED. * * During an async request no other sync and async calls are allowed, and will result in ERROR_PENDING errors. * - * Any outstanding I/O request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. + * Any outstanding I/O request with higher priority (lower numerical value) will be executed before an outstanding request with lower priority. * The default priority is PRIORITY_DEFAULT. * @param slot A callback to call when the request is satisfied. * @param num_files The number of file info objects to request. @@ -110,7 +110,7 @@ public: * * See close(), which is the synchronous version of this function. * - * The operation can be cancelled by triggering the cancellable object from another thread. + * The operation can be cancelled by triggering the cancellable object from another thread. * If the operation was cancelled, a Gio::Error with CANCELLED will be thrown by close_finish(). * * @param io_priority The I/O priority of the request. diff --git a/gio/src/fileinputstream.hg b/gio/src/fileinputstream.hg index 08d56266..476e3916 100644 --- a/gio/src/fileinputstream.hg +++ b/gio/src/fileinputstream.hg @@ -31,7 +31,7 @@ namespace Gio /** FileInputStream provides input streams that take their content from a file. * - * FileInputStream implements Seekable, which allows the input stream to jump to arbitrary positions in the file, + * FileInputStream implements Seekable, which allows the input stream to jump to arbitrary positions in the file, * provided the file system of the file allows it. * Use the methods of the Seekable base class for seeking and positioning. * @@ -39,8 +39,8 @@ namespace Gio * * @newin{2,16} */ -class FileInputStream -: public Gio::InputStream, +class FileInputStream +: public Gio::InputStream, public Seekable { _CLASS_GOBJECT(FileInputStream, GFileInputStream, G_FILE_INPUT_STREAM, Gio::InputStream, GInputStream) @@ -48,10 +48,10 @@ class FileInputStream public: - /** Queries a file input stream the given @a attributes. This function blocks - * while querying the stream. For the asynchronous (non-blocking) version - * of this function, see query_info_async(). While the - * stream is blocked, the stream will set the pending flag internally, and + /** Queries a file input stream the given @a attributes. This function blocks + * while querying the stream. For the asynchronous (non-blocking) version + * of this function, see query_info_async(). While the + * stream is blocked, the stream will set the pending flag internally, and * any other operations on the stream will throw a Gio::Error with PENDING. * * @param attributes A file attribute query string. @@ -60,10 +60,10 @@ public: */ Glib::RefPtr<FileInfo> query_info(const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*"); - /** Queries a file input stream the given @a attributes. This function blocks - * while querying the stream. For the asynchronous (non-blocking) version - * of this function, see query_info_async(). While the - * stream is blocked, the stream will set the pending flag internally, and + /** Queries a file input stream the given @a attributes. This function blocks + * while querying the stream. For the asynchronous (non-blocking) version + * of this function, see query_info_async(). While the + * stream is blocked, the stream will set the pending flag internally, and * any other operations on the stream will throw a Gio::Error with PENDING. * * @param attributes A file attribute query string. @@ -75,7 +75,7 @@ public: /** Queries the stream information asynchronously. For the synchronous version of this function, see query_info(). * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * When the operation is finished, @a slot will be called. You can then call query_info_finish() to get the result of the operation. diff --git a/gio/src/fileiostream.hg b/gio/src/fileiostream.hg index 474dd027..b015268b 100644 --- a/gio/src/fileiostream.hg +++ b/gio/src/fileiostream.hg @@ -29,7 +29,7 @@ namespace Gio /** FileIOStream provides input streams that take their content from a file. * - * FileInputStream implements Seekable, which allows the input stream to jump to arbitrary positions in the file, + * FileInputStream implements Seekable, which allows the input stream to jump to arbitrary positions in the file, * provided the file system of the file allows it. * Use the methods of the Seekable base class for seeking and positioning. * @@ -46,10 +46,10 @@ class FileIOStream public: - /** Queries a file input stream the given @a attributes. This function blocks - * while querying the stream. For the asynchronous (non-blocking) version - * of this function, see query_info_async(). While the - * stream is blocked, the stream will set the pending flag internally, and + /** Queries a file input stream the given @a attributes. This function blocks + * while querying the stream. For the asynchronous (non-blocking) version + * of this function, see query_info_async(). While the + * stream is blocked, the stream will set the pending flag internally, and * any other operations on the stream will throw a Gio::Error with PENDING. * * @param attributes A file attribute query string. @@ -58,10 +58,10 @@ public: */ Glib::RefPtr<FileInfo> query_info(const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*"); - /** Queries a file input stream the given @a attributes. This function blocks - * while querying the stream. For the asynchronous (non-blocking) version - * of this function, see query_info_async(). While the - * stream is blocked, the stream will set the pending flag internally, and + /** Queries a file input stream the given @a attributes. This function blocks + * while querying the stream. For the asynchronous (non-blocking) version + * of this function, see query_info_async(). While the + * stream is blocked, the stream will set the pending flag internally, and * any other operations on the stream will throw a Gio::Error with PENDING. * * @param attributes A file attribute query string. @@ -73,7 +73,7 @@ public: /** Queries the stream information asynchronously. For the synchronous version of this function, see query_info(). * - * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, + * The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, * a Gio::Error with CANCELLED will be thrown. * * When the operation is finished, @a slot will be called. You can then call query_info_finish() to get the result of the operation. diff --git a/gio/src/filemonitor.hg b/gio/src/filemonitor.hg index fbbc851c..d5663d44 100644 --- a/gio/src/filemonitor.hg +++ b/gio/src/filemonitor.hg @@ -32,10 +32,10 @@ _WRAP_ENUM(FileMonitorEvent, GFileMonitorEvent, NO_GTYPE) class File; /** Monitors a file or directory for changes. - * To obtain a FileMonitor for a file or directory, use File::monitor_file() or + * To obtain a FileMonitor for a file or directory, use File::monitor_file() or * File::monitor_directory(). - * - * To get informed about changes to the file or directory you are monitoring, + * + * To get informed about changes to the file or directory you are monitoring, * connect to signal_changed(). * * @newin{2,16} @@ -46,7 +46,7 @@ class FileMonitor : public Glib::Object protected: public: - + _WRAP_METHOD(bool cancel(), g_file_monitor_cancel) _WRAP_METHOD(bool is_cancelled() const, g_file_monitor_is_cancelled) _WRAP_METHOD(void set_rate_limit(int limit_msecs), g_file_monitor_set_rate_limit) @@ -56,7 +56,7 @@ public: #m4 _CONVERSION(`GFile*',`const Glib::RefPtr<File>&',`Glib::wrap($3, true)') _WRAP_SIGNAL(void changed(const Glib::RefPtr<File>& file, const Glib::RefPtr<File>& other_file, FileMonitorEvent event_type), "changed") - + //_WRAP_VFUNC(bool cancel(), cancel); _WRAP_PROPERTY("rate-limit", int) diff --git a/gio/src/filenamecompleter.hg b/gio/src/filenamecompleter.hg index 39108562..773d3631 100644 --- a/gio/src/filenamecompleter.hg +++ b/gio/src/filenamecompleter.hg @@ -30,7 +30,7 @@ namespace Gio class File; -/** Completes partial file and directory names given a partial string by looking in the file system for clues. +/** Completes partial file and directory names given a partial string by looking in the file system for clues. * Can return a list of possible completion strings for widget implementation. * * @newin{2,16} @@ -45,7 +45,7 @@ public: _WRAP_CREATE() _WRAP_METHOD(std::string get_completion_suffix(const std::string& initial_text) const, g_filename_completer_get_completion_suffix) - + #m4 _CONVERSION(`char**',`Glib::StringArrayHandle',`Glib::StringArrayHandle($3, Glib::OWNERSHIP_DEEP)') _WRAP_METHOD(Glib::StringArrayHandle get_completions(const std::string& initial_text) const, g_filename_completer_get_completions) _WRAP_METHOD(void set_dirs_only(bool dirs_only = true), g_filename_completer_set_dirs_only) diff --git a/gio/src/fileoutputstream.hg b/gio/src/fileoutputstream.hg index 4295ea4c..0ba250a4 100644 --- a/gio/src/fileoutputstream.hg +++ b/gio/src/fileoutputstream.hg @@ -33,11 +33,11 @@ namespace Gio /** FileOutputStream provides output streams that write their content to a file. * - * FileOutputStream implements Seekable, which allows the output stream to jump - * to arbitrary positions in the file and to truncate the file, provided the + * FileOutputStream implements Seekable, which allows the output stream to jump + * to arbitrary positions in the file and to truncate the file, provided the * file system of the file supports these operations. - * Use the methods of the Seekable base class for seeking and positioning. - * + * Use the methods of the Seekable base class for seeking and positioning. + * * @ingroup Streams * * @newin{2,16} @@ -51,21 +51,21 @@ class FileOutputStream public: - /** Queries a file output stream for the given @a attributes . - * This function blocks while querying the stream. For the asynchronous - * version of this function, see query_info_async(). - * While the stream is blocked, the stream will set the pending flag - * internally, and any other operations on the stream will throw a Gio::Error with + /** Queries a file output stream for the given @a attributes . + * This function blocks while querying the stream. For the asynchronous + * version of this function, see query_info_async(). + * While the stream is blocked, the stream will set the pending flag + * internally, and any other operations on the stream will throw a Gio::Error with * PENDING. - * - * Can fail if the stream was already closed (with a + * + * Can fail if the stream was already closed (with a * CLOSED error), the stream has pending operations (with a PENDING error), - * or if querying info is not supported for + * or if querying info is not supported for * the stream's interface (with a NOT_SUPPORTED error). In * all cases of failure, an empty RefPtr will be returned. - * + * * The operation can be cancelled by triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED may be thrown, and an empty RefPtr will + * was cancelled, a Gio::Error with CANCELLED may be thrown, and an empty RefPtr will * be returned. * * @param cancellable A Cancellable object. @@ -74,21 +74,21 @@ public: */ Glib::RefPtr<FileInfo> query_info(const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*"); - /** Queries a file output stream for the given @a attributes . - * This function blocks while querying the stream. For the asynchronous - * version of this function, see query_info_async(). - * While the stream is blocked, the stream will set the pending flag - * internally, and any other operations on the stream will throw a Gio::Error with + /** Queries a file output stream for the given @a attributes . + * This function blocks while querying the stream. For the asynchronous + * version of this function, see query_info_async(). + * While the stream is blocked, the stream will set the pending flag + * internally, and any other operations on the stream will throw a Gio::Error with * PENDING. - * - * Can fail if the stream was already closed (with a CLOSED error), + * + * Can fail if the stream was already closed (with a CLOSED error), * the stream has pending operations (with an PENDING error), - * or if querying info is not supported for + * or if querying info is not supported for * the stream's interface (with a NOT_SUPPORTED error). In * all cases of failure, an empty RefPtr will be returned. - * + * * The operation can be cancelled by triggering the cancellable object from another thread. If the operation - * was cancelled, a Gio::Error with CANCELLED may be thrown, and an empty RefPtr will + * was cancelled, a Gio::Error with CANCELLED may be thrown, and an empty RefPtr will * be returned. * * @param cancellable A Cancellable object. @@ -101,17 +101,17 @@ public: /** Queries the stream information asynchronously. - * When the operation is finished @a slot will be called. - * You can then call query_info_finish() + * When the operation is finished @a slot will be called. + * You can then call query_info_finish() * to get the result of the operation. * - * For the synchronous version of this function, - * see query_info(). - * + * For the synchronous version of this function, + * see query_info(). + * * The operation can be cancelled by * triggering the cancellable object from another thread. If the operation * was cancelled, a Gio::Error with CANCELLED may be thrown - * + * * @param slot Callback to call when the request is satisfied. * @param cancellable A Cancellable object. * @param attributes A file attribute query string. @@ -120,13 +120,13 @@ public: void query_info_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*", int io_priority = Glib::PRIORITY_DEFAULT); /** Queries the stream information asynchronously. - * When the operation is finished @a slot will be called. - * You can then call query_info_finish() + * When the operation is finished @a slot will be called. + * You can then call query_info_finish() * to get the result of the operation. * - * For the synchronous version of this function, - * see query_info(). - * + * For the synchronous version of this function, + * see query_info(). + * * @param slot Callback to call when the request is satisfied. * @param attributes A file attribute query string. * @param io_priority The <io-priority of the request. @@ -142,7 +142,7 @@ public: //These seem to be just C convenience functions - they are already in the Seekable base class: //See http://bugzilla.gnome.org/show_bug.cgi?id=509990 - _IGNORE(g_file_output_stream_tell, g_file_output_stream_can_seek, g_file_output_stream_seek, + _IGNORE(g_file_output_stream_tell, g_file_output_stream_can_seek, g_file_output_stream_seek, g_file_output_stream_can_truncate, g_file_output_stream_truncate) // _WRAP_METHOD(goffset tell() const, g_file_output_stream_tell) // _WRAP_METHOD(bool can_seek() const, g_file_output_stream_can_seek) diff --git a/gio/src/filterinputstream.hg b/gio/src/filterinputstream.hg index db2050b4..6d09e4dc 100644 --- a/gio/src/filterinputstream.hg +++ b/gio/src/filterinputstream.hg @@ -27,8 +27,8 @@ namespace Gio { /** Filter Input Stream. - * This is a base class for input stream implementations that perform some kind of filtering operation on a base stream. - & Typical examples of filtering operations are character set conversion, compression and byte order flipping. + * This is a base class for input stream implementations that perform some kind of filtering operation on a base stream. + & Typical examples of filtering operations are character set conversion, compression and byte order flipping. * * @ingroup Streams * diff --git a/gio/src/filteroutputstream.hg b/gio/src/filteroutputstream.hg index bb8d3cbf..47b5e013 100644 --- a/gio/src/filteroutputstream.hg +++ b/gio/src/filteroutputstream.hg @@ -28,8 +28,8 @@ namespace Gio /** Filter Output Stream. * - * This is a base class for output stream implementations that perform some kind of filtering operation on a base stream. - * Typical examples of filtering operations are character set conversion, compression and byte order flipping. + * This is a base class for output stream implementations that perform some kind of filtering operation on a base stream. + * Typical examples of filtering operations are character set conversion, compression and byte order flipping. * * @ingroup Streams * diff --git a/gio/src/icon.hg b/gio/src/icon.hg index b6d78e67..97ef3479 100644 --- a/gio/src/icon.hg +++ b/gio/src/icon.hg @@ -30,7 +30,7 @@ namespace Gio { /** This is a very minimal interface for icons. It provides functions for checking the equality of two icons and hashing of icons. - * Glib::Icon does not provide the actual pixmap for the icon as this is out of GIO's scope. However implementations of Icon may contain the name of an + * Glib::Icon does not provide the actual pixmap for the icon as this is out of GIO's scope. However implementations of Icon may contain the name of an * icon (see ThemedIcon), or the path to an icon (see LoadableIcon). * * To obtain a hash of an Icon instance, see hash(). diff --git a/gio/src/inputstream.hg b/gio/src/inputstream.hg index ba55fa29..7065303d 100644 --- a/gio/src/inputstream.hg +++ b/gio/src/inputstream.hg @@ -66,12 +66,12 @@ public: //TODO: Why not use _WRAP_METHOD() for this? /** Request an asynchronous read of @a count bytes from the stream into a - * new Glib::Bytes. When the operation is finished @a slot will be called. - * You can then call read_bytes_finish() to get the result of the + * new Glib::Bytes. When the operation is finished @a slot will be called. + * You can then call read_bytes_finish() to get the result of the * operation. * * During an async request no other sync and async calls are allowed, and will - * result in Gio::Error with PENDING being thrown. + * result in Gio::Error with PENDING being thrown. * * A value of @a count larger than MAXSSIZE will cause a Gio::Error with INVALID_ARGUMENT to be thrown. * @@ -95,12 +95,12 @@ public: void read_bytes_async(gsize count, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, int io_priority = Glib::PRIORITY_DEFAULT); /** Request an asynchronous read of @a count bytes from the stream into a - * new Glib::Bytes. When the operation is finished @a slot will be called. - * You can then call read_bytes_finish() to get the result of the + * new Glib::Bytes. When the operation is finished @a slot will be called. + * You can then call read_bytes_finish() to get the result of the * operation. * * During an async request no other sync and async calls are allowed, and will - * result in Gio::Error with PENDING being thrown. + * result in Gio::Error with PENDING being thrown. * * A value of @a count larger than MAXSSIZE will cause a Gio::Error with INVALID_ARGUMENT to be thrown. * @@ -137,12 +137,12 @@ public: /** Request an asynchronous read of @a count bytes from the stream into the buffer - * starting at @a buffer. When the operation is finished @a slot will be called. - * You can then call read_finish() to get the result of the + * starting at @a buffer. When the operation is finished @a slot will be called. + * You can then call read_finish() to get the result of the * operation. * * During an async request no other sync and async calls are allowed, and will - * result in Gio::Error with PENDING being thrown. + * result in Gio::Error with PENDING being thrown. * * A value of @a count larger than MAXSSIZE will cause a Gio::Error with INVALID_ARGUMENT to be thrown. * @@ -169,12 +169,12 @@ public: void read_async(void* buffer, gsize count, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, int io_priority = Glib::PRIORITY_DEFAULT); /** Request an asynchronous read of @a count bytes from the stream into the buffer - * starting at @a buffer. When the operation is finished @a slot will be called. - * You can then call read_finish() to get the result of the + * starting at @a buffer. When the operation is finished @a slot will be called. + * You can then call read_finish() to get the result of the * operation. * * During an async request no other sync and async calls are allowed, and will - * result in a Gio::Error with PENDING being thrown. + * result in a Gio::Error with PENDING being thrown. * * A value of @a count larger than MAXSSIZE will cause a Gio::Error with INVALID_ARGUMENT to be thrown. * @@ -195,7 +195,7 @@ public: * @param buffer A buffer to read data into (which should be at least count bytes long). * @param count The number of bytes that will be read from the stream. * @param slot Callback to call when the request is satisfied. - * @param io_priority The I/O priority of the request. + * @param io_priority The I/O priority of the request. */ void read_async(void* buffer, gsize count, const SlotAsyncReady& slot, int io_priority = Glib::PRIORITY_DEFAULT); _IGNORE(g_input_stream_read_async) @@ -207,11 +207,11 @@ public: //TODO: Use std::size_type instead of gsize? /** Request an asynchronous skip of @a count bytes from the stream into the buffer - * starting at @a buffer. When the operation is finished @a slot will be called. + * starting at @a buffer. When the operation is finished @a slot will be called. * You can then call skip_finish() to get the result of the operation. * * During an async request no other sync and async calls are allowed, and will - * result in Gio::Error with PENDING being thrown. + * result in Gio::Error with PENDING being thrown. * * A value of @a count larger than MAXSSIZE will cause a Gio::Error with INVALID_ARGUMENT to be thrown. * @@ -232,16 +232,16 @@ public: * @param count The number of bytes that will be skipped from the stream. * @param slot Callback to call when the request is satisfied. * @param cancellable A Cancellable object. - * @param io_priority The I/O priority of the request. + * @param io_priority The I/O priority of the request. */ void skip_async(gsize count, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, int io_priority = Glib::PRIORITY_DEFAULT); /** Request an asynchronous skip of @a count bytes from the stream into the buffer - * starting at @a buffer. When the operation is finished @a slot will be called. + * starting at @a buffer. When the operation is finished @a slot will be called. * You can then call skip_finish() to get the result of the operation. * * During an async request no other sync and async calls are allowed, and will - * result in Gio::Error with PENDING being thrown. + * result in Gio::Error with PENDING being thrown. * * A value of @a count larger than MAXSSIZE will cause a Gio::Error with INVALID_ARGUMENT to be thrown. * @@ -261,7 +261,7 @@ public: * * @param count The number of bytes that will be skipped from the stream. * @param slot Callback to call when the request is satisfied. - * @param io_priority The I/O priority of the request. + * @param io_priority The I/O priority of the request. */ void skip_async(gsize count, const SlotAsyncReady& slot, int io_priority = Glib::PRIORITY_DEFAULT); _IGNORE(g_input_stream_skip_async) @@ -271,8 +271,8 @@ public: errthrow) /** Requests an asynchronous closes of the stream, releasing resources related to it. - * When the operation is finished @a slot will be called. - * You can then call close_finish() to get the result of the + * When the operation is finished @a slot will be called. + * You can then call close_finish() to get the result of the * operation. * * For behaviour details see close(). @@ -283,13 +283,13 @@ public: * * @param slot Callback to call when the request is satisfied. * @param cancellable A Cancellable object. - * @param io_priority The I/O priority of the request. + * @param io_priority The I/O priority of the request. */ void close_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, int io_priority = Glib::PRIORITY_DEFAULT); /** Requests an asynchronous closes of the stream, releasing resources related to it. - * When the operation is finished @a slot will be called. - * You can then call close_finish() to get the result of the + * When the operation is finished @a slot will be called. + * You can then call close_finish() to get the result of the * operation. * * For behaviour details see close(). @@ -299,7 +299,7 @@ public: * override one you must override all. * * @param slot Callback to call when the request is satisfied. - * @param io_priority The I/O priority of the request. + * @param io_priority The I/O priority of the request. */ void close_async(const SlotAsyncReady& slot, int io_priority = Glib::PRIORITY_DEFAULT); _IGNORE(g_input_stream_close_async) diff --git a/gio/src/iostream.hg b/gio/src/iostream.hg index 35f49221..dcd5a763 100644 --- a/gio/src/iostream.hg +++ b/gio/src/iostream.hg @@ -90,7 +90,7 @@ public: /// A non-cancellable version of splice_async(). void splice_async(const Glib::RefPtr<IOStream>& stream2, - const SlotAsyncReady& slot, + const SlotAsyncReady& slot, IOStreamSpliceFlags flags = Gio::IO_STREAM_SPLICE_NONE, int io_priority = Glib::PRIORITY_DEFAULT); diff --git a/gio/src/memoryoutputstream.hg b/gio/src/memoryoutputstream.hg index d44aa463..24147e32 100644 --- a/gio/src/memoryoutputstream.hg +++ b/gio/src/memoryoutputstream.hg @@ -31,7 +31,7 @@ namespace Gio /** Streaming output operations on memory chunks * - * This class uses arbitrary memory chunks as output for GIO streaming output operations. + * This class uses arbitrary memory chunks as output for GIO streaming output operations. * * @ingroup Streams * @@ -57,13 +57,13 @@ public: _WRAP_METHOD(gsize get_size() const, g_memory_output_stream_get_size) _WRAP_METHOD(gsize get_data_size() const, g_memory_output_stream_get_data_size) - + _WRAP_PROPERTY("data", void*) _WRAP_PROPERTY("data-size", gulong) //Too C-like: _WRAP_PROPERTY("destroy-function", void*) //Too C-like: _WRAP_PROPERTY("realloc-function" gpointer : Read / Write / Construct Only _WRAP_PROPERTY("size", gulong) - + }; } // namespace Gio diff --git a/gio/src/menuitem.ccg b/gio/src/menuitem.ccg index bf8e897a..221eaea9 100644 --- a/gio/src/menuitem.ccg +++ b/gio/src/menuitem.ccg @@ -22,7 +22,7 @@ namespace Gio void MenuItem::set_action_and_target(const Glib::ustring& action) { - g_menu_item_set_action_and_target_value(gobj(), action.c_str(), 0); + g_menu_item_set_action_and_target_value(gobj(), action.c_str(), 0); } } // namespace Gio diff --git a/gio/src/menuitem.hg b/gio/src/menuitem.hg index 51e5e84a..3798d5b8 100644 --- a/gio/src/menuitem.hg +++ b/gio/src/menuitem.hg @@ -42,7 +42,7 @@ public: _WRAP_CREATE(const Glib::ustring& label{?}, const Glib::RefPtr<MenuModel>& submenu) - + //TODO: GMenuItem * g_menu_item_new_section (const Glib::ustring& label, // const Glib::RefPtr<MenuModel>& section); @@ -63,7 +63,7 @@ public: // Ignore varargs function. _IGNORE(g_menu_item_get_attribute) - + //TODO: Rename this to unset_action_target() and deprecate this one. /** Unsets the target for the specified @a action. */ diff --git a/gio/src/mount.hg b/gio/src/mount.hg index fb529cfa..d50a4f1e 100644 --- a/gio/src/mount.hg +++ b/gio/src/mount.hg @@ -45,12 +45,12 @@ class Drive; class Volume; /** The Mount interface represents user-visible mounts. - * Mount is a "mounted" filesystem that you can access. Mounted is in quotes because it's not the same as a unix mount: + * Mount is a "mounted" filesystem that you can access. Mounted is in quotes because it's not the same as a unix mount: * it might be a gvfs mount, but you can still access the files on it if you use GIO. It might or might not be related to a volume object. * - * Unmounting a Mount instance is an asynchronous operation. For more information about asynchronous operations, see AsyncReady. - * To unmount a Mount instance, first call unmount(). The callback slot will be called when the operation has resolved (either with success or failure), - * and a AsyncReady structure will be passed to the callback. That callback should then call unmount_finish() with the AsyncReady data to see if the operation was completed successfully. + * Unmounting a Mount instance is an asynchronous operation. For more information about asynchronous operations, see AsyncReady. + * To unmount a Mount instance, first call unmount(). The callback slot will be called when the operation has resolved (either with success or failure), + * and a AsyncReady structure will be passed to the callback. That callback should then call unmount_finish() with the AsyncReady data to see if the operation was completed successfully. * * @ingroup Streams * @@ -99,8 +99,8 @@ public: /** Remounts a mount. * This is an asynchronous operation, and is finished by calling mount_finish() with the AsyncResult data returned in the callback slot. * - * Remounting is useful when some setting affecting the operation of the volume has been changed, as this may need a remount - * to take affect. While this is semantically equivalent with unmounting and then remounting, not all backends might need to + * Remounting is useful when some setting affecting the operation of the volume has been changed, as this may need a remount + * to take affect. While this is semantically equivalent with unmounting and then remounting, not all backends might need to * actually be unmounted. * * @param operation A mount operation. @@ -112,8 +112,8 @@ public: /** Remounts a mount. * This is an asynchronous operation, and is finished by calling mount_finish() with the AsyncResult data returned in the callback slot. * - * Remounting is useful when some setting affecting the operation of the volume has been changed, as this may need a remount - * to take affect. While this is semantically equivalent with unmounting and then remounting, not all backends might need to + * Remounting is useful when some setting affecting the operation of the volume has been changed, as this may need a remount + * to take affect. While this is semantically equivalent with unmounting and then remounting, not all backends might need to * actually be unmounted. * * @param operation A mount operation. @@ -122,9 +122,9 @@ public: void remount(const Glib::RefPtr<MountOperation>& operation, const SlotAsyncReady& slot, MountMountFlags flags = MOUNT_MOUNT_NONE); /** Remounts a mount. - * - * Remounting is useful when some setting affecting the operation of the volume has been changed, as this may need a remount - * to take affect. While this is semantically equivalent with unmounting and then remounting, not all backends might need to + * + * Remounting is useful when some setting affecting the operation of the volume has been changed, as this may need a remount + * to take affect. While this is semantically equivalent with unmounting and then remounting, not all backends might need to * actually be unmounted. * * @param operation A mount operation. @@ -132,9 +132,9 @@ public: void remount(const Glib::RefPtr<MountOperation>& operation, MountMountFlags flags = MOUNT_MOUNT_NONE); /** Remounts a mount, without user interaction. - * - * Remounting is useful when some setting affecting the operation of the volume has been changed, as this may need a remount - * to take affect. While this is semantically equivalent with unmounting and then remounting, not all backends might need to + * + * Remounting is useful when some setting affecting the operation of the volume has been changed, as this may need a remount + * to take affect. While this is semantically equivalent with unmounting and then remounting, not all backends might need to * actually be unmounted. */ void remount(MountMountFlags flags = MOUNT_MOUNT_NONE); @@ -159,10 +159,10 @@ public: /** Tries to guess the type of content stored on the mount. * Returns one or more textual identifiers of well-known content types (typically - * prefixed with "x-content/"), e.g. x-content/image-dcf for camera + * prefixed with "x-content/"), e.g. x-content/image-dcf for camera * memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink> specification for more on x-content types. * - * This is an asynchronous operation, and is finished by calling + * This is an asynchronous operation, and is finished by calling * guess_content_type_finish(). * * @param slot A callback which will be called when the operation is completed or canceled. @@ -175,10 +175,10 @@ public: /** Tries to guess the type of content stored on the mount. * Returns one or more textual identifiers of well-known content types (typically - * prefixed with "x-content/"), e.g. x-content/image-dcf for camera + * prefixed with "x-content/"), e.g. x-content/image-dcf for camera * memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink> specification for more on x-content types. * - * This is an asynchronous operation, and is finished by calling + * This is an asynchronous operation, and is finished by calling * guess_content_type_finish(). * * @param slot A callback which will be called when the operation is completed or canceled. @@ -190,7 +190,7 @@ public: /** Tries to guess the type of content stored on the mount. * Returns one or more textual identifiers of well-known content types (typically - * prefixed with "x-content/"), e.g. x-content/image-dcf for camera + * prefixed with "x-content/"), e.g. x-content/image-dcf for camera * memory cards. See the <ulink url="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec">shared-mime-info</ulink> specification for more on x-content types. * * @param force_rescan Whether to force a rescan of the content. Otherwise a cached result will be used if available. @@ -235,11 +235,11 @@ Glib::RefPtr<Gio::Mount> wrap(GMount* object, bool take_copy); namespace Container_Helpers { -/** This specialization of TypeTraits exists - * because the default use of Glib::wrap(GObject*), +/** This specialization of TypeTraits exists + * because the default use of Glib::wrap(GObject*), * instead of a specific Glib::wrap(GSomeInterface*), * would not return a wrapper for an interface. - */ + */ template <> struct TypeTraits< Glib::RefPtr<Gio::Mount> > { @@ -252,7 +252,7 @@ struct TypeTraits< Glib::RefPtr<Gio::Mount> > static CppType to_cpp_type (const CType& item) { - //Use a specific Glib::wrap() function, + //Use a specific Glib::wrap() function, //because CType has the specific type (not just GObject): return Glib::wrap(item, true /* take_copy */); } diff --git a/gio/src/mountoperation.hg b/gio/src/mountoperation.hg index 879aed2b..f57eb616 100644 --- a/gio/src/mountoperation.hg +++ b/gio/src/mountoperation.hg @@ -34,9 +34,9 @@ _WRAP_ENUM(MountOperationResult, GMountOperationResult, NO_GTYPE) /** Authentication methods for mountable locations. * * MountOperation provides a mechanism for authenticating mountable operations, such as loop mounting files, hard drive partitions or server locations. - * - * Mounting operations are handed a MountOperation that they can use if they require any privileges or authentication for their volumes to be mounted (e.g. - * a hard disk partition or an encrypted filesystem), or if they are implementing a remote server protocol which requires user credentials such as FTP or + * + * Mounting operations are handed a MountOperation that they can use if they require any privileges or authentication for their volumes to be mounted (e.g. + * a hard disk partition or an encrypted filesystem), or if they are implementing a remote server protocol which requires user credentials such as FTP or * WebDAV. * * Developers should instantiate a subclass of this that implements all the various callbacks to show the required dialogs. diff --git a/gio/src/outputstream.hg b/gio/src/outputstream.hg index fbfc6f15..3ba1aec2 100644 --- a/gio/src/outputstream.hg +++ b/gio/src/outputstream.hg @@ -48,16 +48,16 @@ public: /** Tries to write @a count bytes from @a buffer into the stream. Will block * during the operation. - * - * If count is zero returns zero and does nothing. A value of @a count + * + * If count is zero returns zero and does nothing. A value of @a count * larger than MAXSSIZE will cause a Gio::Error with INVALID_ARGUMENT to be thrown. - * + * * On success, the number of bytes written to the stream is returned. * It is not an error if this is not the same as the requested size, as it * can happen e.g. on a partial i/o error, or if the there is not enough * storage in the stream. All writes either block until at least one byte * is written, so zero is never returned (unless @a count is zero). - * + * * On error -1 is returned. * @param buffer The buffer containing the data to write. * @param cancellable Cancellable object. @@ -67,15 +67,15 @@ public: /** Tries to write @a count bytes from @a buffer into the stream. Will block * during the operation. - * + * * If string that is larger than MAXSSIZE bytes will cause a Gio::Error with INVALID_ARGUMENT to be thrown. - * + * * On success, the number of bytes written to the stream is returned. * It is not an error if this is not the same as the requested size, as it * can happen e.g. on a partial i/o error, or if the there is not enough * storage in the stream. All writes either block until at least one byte * is written, so zero is never returned (unless @a count is zero). - * + * * On error -1 is returned. * @param buffer The buffer containing the data to write. * @return Number of bytes written, or -1 on error. @@ -89,18 +89,18 @@ public: /** Tries to write @a count bytes from @a buffer into the stream. Will block * during the operation. - * + * * This function is similar to write(), except it tries to * write as many bytes as requested, only stopping on an error. - * - * On a successful write of @a count bytes, <tt>true</tt> is returned, and @a bytes_written + * + * On a successful write of @a count bytes, <tt>true</tt> is returned, and @a bytes_written * is set to @a count . - * - * If there is an error during the operation <tt>false</tt> is returned and @a error + * + * If there is an error during the operation <tt>false</tt> is returned and @a error * is set to indicate the error status, @a bytes_written is updated to contain * the number of bytes written into the stream before the error occured. * @param buffer The buffer containing the data to write. - * @param bytes_written Location to store the number of bytes that was + * @param bytes_written Location to store the number of bytes that was * written to the stream. * @param cancellable Cancellable object. * @return <tt>true</tt> on success, <tt>false</tt> if there was an error. @@ -109,18 +109,18 @@ public: /** Tries to write @a count bytes from @a buffer into the stream. Will block * during the operation. - * + * * This function is similar to write(), except it tries to * write as many bytes as requested, only stopping on an error. - * - * On a successful write of @a count bytes, <tt>true</tt> is returned, and @a bytes_written + * + * On a successful write of @a count bytes, <tt>true</tt> is returned, and @a bytes_written * is set to @a count . - * - * If there is an error during the operation <tt>false</tt> is returned and @a error + * + * If there is an error during the operation <tt>false</tt> is returned and @a error * is set to indicate the error status, @a bytes_written is updated to contain * the number of bytes written into the stream before the error occured. * @param buffer The buffer containing the data to write. - * @param bytes_written Location to store the number of bytes that was + * @param bytes_written Location to store the number of bytes that was * written to the stream. * @return <tt>true</tt> on success, <tt>false</tt> if there was an error. */ @@ -133,12 +133,12 @@ public: * then call write_bytes_finish() to get the result of * the operation. * - * During an async request no other sync and async calls are allowed, - * and will result in Gio::Error with PENDING being thrown. + * During an async request no other sync and async calls are allowed, + * and will result in Gio::Error with PENDING being thrown. * - * A Glib:Bytes larger than MAXSSIZE will cause a Gio::Error with + * A Glib:Bytes larger than MAXSSIZE will cause a Gio::Error with * INVALID_ARGUMENT to be thrown. - * + * * On success, the number of bytes written will be passed to the * callback @a slot. It is not an error if this is not the same as the * requested size, as it can happen e.g. on a partial I/O error, @@ -148,13 +148,13 @@ public: * IO_ERROR_WOULD_BLOCK - if the stream can't accept more data, the * method will just wait until this changes. * - * Any outstanding I/O request with higher priority (lower numerical - * value) will be executed before an outstanding request with lower + * Any outstanding I/O request with higher priority (lower numerical + * value) will be executed before an outstanding request with lower * priority. Default priority is Glib::PRIORITY_DEFAULT. - * + * * For the synchronous, blocking version of this function, see write_bytes(). * - * @param bytes The bytes to + * @param bytes The bytes to * @param slot Callback slot to call when the request is satisfied. * @param cancellable Cancellable object. * @param io_priority The io priority of the request. @@ -168,12 +168,12 @@ public: * then call write_bytes_finish() to get the result of * the operation. * - * During an async request no other sync and async calls are allowed, - * and will result in Gio::Error with PENDING being thrown. + * During an async request no other sync and async calls are allowed, + * and will result in Gio::Error with PENDING being thrown. * - * A Glib:Bytes larger than MAXSSIZE will cause a Gio::Error with + * A Glib:Bytes larger than MAXSSIZE will cause a Gio::Error with * INVALID_ARGUMENT to be thrown. - * + * * On success, the number of bytes written will be passed to the * callback @a slot. It is not an error if this is not the same as the * requested size, as it can happen e.g. on a partial I/O error, @@ -183,13 +183,13 @@ public: * IO_ERROR_WOULD_BLOCK - if the stream can't accept more data, the * method will just wait until this changes. * - * Any outstanding I/O request with higher priority (lower numerical - * value) will be executed before an outstanding request with lower + * Any outstanding I/O request with higher priority (lower numerical + * value) will be executed before an outstanding request with lower * priority. Default priority is Glib::PRIORITY_DEFAULT. - * + * * For the synchronous, blocking version of this function, see write_bytes(). * - * @param bytes The bytes to + * @param bytes The bytes to * @param slot Callback slot to call when the request is satisfied. * @param io_priority The io priority of the request. * @@ -228,34 +228,34 @@ public: g_output_stream_close, errthrow) - /** Request an asynchronous write of @a count bytes from @a buffer into - * the stream. When the operation is finished @a slot will be called. - * You can then call write_finish() to get the result of the + /** Request an asynchronous write of @a count bytes from @a buffer into + * the stream. When the operation is finished @a slot will be called. + * You can then call write_finish() to get the result of the * operation. * - * During an async request no other sync and async calls are allowed, - * and will result in Gio::Error with PENDING being thrown. + * During an async request no other sync and async calls are allowed, + * and will result in Gio::Error with PENDING being thrown. * - * A value of @a count larger than MAXSSIZE will cause a Gio::Error with + * A value of @a count larger than MAXSSIZE will cause a Gio::Error with * INVALID_ARGUMENT to be thrown. * * On success, the number of bytes written will be passed to the - * callback @a slot. It is not an error if this is not the same as the - * requested size, as it can happen e.g. on a partial I/O error, - * but generally we try to write as many bytes as requested. + * callback @a slot. It is not an error if this is not the same as the + * requested size, as it can happen e.g. on a partial I/O error, + * but generally we try to write as many bytes as requested. * - * Any outstanding I/O request with higher priority (lower numerical - * value) will be executed before an outstanding request with lower + * Any outstanding I/O request with higher priority (lower numerical + * value) will be executed before an outstanding request with lower * priority. Default priority is Glib::PRIORITY_DEFAULT. * - * The asyncronous methods have a default fallback that uses threads - * to implement asynchronicity, so they are optional for inheriting + * The asyncronous methods have a default fallback that uses threads + * to implement asynchronicity, so they are optional for inheriting * classes. However, if you override one you must override all. * - * For the synchronous, blocking version of this function, see + * For the synchronous, blocking version of this function, see * write(). * - * @param buffer The buffer containing the data to write. + * @param buffer The buffer containing the data to write. * @param count The number of bytes to write * @param slot Callback slot to call when the request is satisfied. * @param cancellable Cancellable object. @@ -263,34 +263,34 @@ public: */ void write_async(const void* buffer, gsize count, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, int io_priority = Glib::PRIORITY_DEFAULT); - /** Request an asynchronous write of @a count bytes from @a buffer into - * the stream. When the operation is finished @a slot will be called. - * You can then call write_finish() to get the result of the + /** Request an asynchronous write of @a count bytes from @a buffer into + * the stream. When the operation is finished @a slot will be called. + * You can then call write_finish() to get the result of the * operation. * - * During an async request no other sync and async calls are allowed, - * and will result in Gio::Error with PENDING being thrown. + * During an async request no other sync and async calls are allowed, + * and will result in Gio::Error with PENDING being thrown. * - * A value of @a count larger than MAXSSIZE will cause a Gio::Error with + * A value of @a count larger than MAXSSIZE will cause a Gio::Error with * INVALID_ARGUMENT to be thrown. * * On success, the number of bytes written will be passed to the - * callback @a slot. It is not an error if this is not the same as the - * requested size, as it can happen e.g. on a partial I/O error, - * but generally we try to write as many bytes as requested. + * callback @a slot. It is not an error if this is not the same as the + * requested size, as it can happen e.g. on a partial I/O error, + * but generally we try to write as many bytes as requested. * - * Any outstanding I/O request with higher priority (lower numerical - * value) will be executed before an outstanding request with lower + * Any outstanding I/O request with higher priority (lower numerical + * value) will be executed before an outstanding request with lower * priority. Default priority is Glib::PRIORITY_DEFAULT. * - * The asyncronous methods have a default fallback that uses threads - * to implement asynchronicity, so they are optional for inheriting + * The asyncronous methods have a default fallback that uses threads + * to implement asynchronicity, so they are optional for inheriting * classes. However, if you override one you must override all. * - * For the synchronous, blocking version of this function, see + * For the synchronous, blocking version of this function, see * write(). * - * @param buffer The buffer containing the data to write. + * @param buffer The buffer containing the data to write. * @param count The number of bytes to write * @param slot Callback slot to call when the request is satisfied. * @param io_priority The io priority of the request. @@ -303,11 +303,11 @@ public: errthrow) /** Splices a stream asynchronously. - * When the operation is finished @a slot will be called. - * You can then call splice_finish() to get the result of the + * When the operation is finished @a slot will be called. + * You can then call splice_finish() to get the result of the * operation. * - * For the synchronous, blocking version of this function, see + * For the synchronous, blocking version of this function, see * splice(). * * @param source An InputStream. @@ -318,11 +318,11 @@ public: void splice_async(const Glib::RefPtr<InputStream>& source, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, OutputStreamSpliceFlags flags = OUTPUT_STREAM_SPLICE_NONE, int io_priority = Glib::PRIORITY_DEFAULT); /** Splices a stream asynchronously. - * When the operation is finished @a slot will be called. - * You can then call splice_finish() to get the result of the + * When the operation is finished @a slot will be called. + * You can then call splice_finish() to get the result of the * operation. * - * For the synchronous, blocking version of this function, see + * For the synchronous, blocking version of this function, see * splice(). * * @param source An InputStream. @@ -363,12 +363,12 @@ public: g_output_stream_flush_finish, errthrow) - /** Requests an asynchronous close of the stream, releasing resources related to it. + /** Requests an asynchronous close of the stream, releasing resources related to it. * When the operation is finished the @a slot will be called, giving the results. * You can then call close_finish() to get the result of the operation. * For behaviour details see close(). * - * The asyncronous methods have a default fallback that uses threads to implement asynchronicity, + * The asyncronous methods have a default fallback that uses threads to implement asynchronicity, * so they are optional for inheriting classes. However, if you override one you must override all. * * @param slot Callback slot to call when the request is satisfied. @@ -377,12 +377,12 @@ public: */ void close_async(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable, int io_priority = Glib::PRIORITY_DEFAULT); - /** Requests an asynchronous close of the stream, releasing resources related to it. - * When the operation is finished the @a slot will be called, giving the results. + /** Requests an asynchronous close of the stream, releasing resources related to it. + * When the operation is finished the @a slot will be called, giving the results. * You can then call close_finish() to get the result of the operation. * For behaviour details see close(). * - * The asyncronous methods have a default fallback that uses threads to implement asynchronicity, + * The asyncronous methods have a default fallback that uses threads to implement asynchronicity, * so they are optional for inheriting classes. However, if you override one you must override all. * * @param slot Callback slot to call when the request is satisfied. diff --git a/gio/src/proxy.ccg b/gio/src/proxy.ccg index 8f8a7cd4..232333e0 100644 --- a/gio/src/proxy.ccg +++ b/gio/src/proxy.ccg @@ -40,7 +40,7 @@ void Proxy::connect_async(const Glib::RefPtr<IOStream>& connection, const Glib:: &SignalProxy_async_callback, slot_copy); } - + void Proxy::connect_async(const Glib::RefPtr<IOStream>& connection, const Glib::RefPtr<const ProxyAddress>& proxy_address, const SlotAsyncReady& slot) { // Create a copy of the slot. diff --git a/gio/src/proxyresolver.ccg b/gio/src/proxyresolver.ccg index cec6b7ed..3fd2d6a8 100644 --- a/gio/src/proxyresolver.ccg +++ b/gio/src/proxyresolver.ccg @@ -51,7 +51,7 @@ void ProxyResolver::lookup_async(const Glib::ustring& uri, const SlotAsyncReady& &SignalProxy_async_callback, slot_copy); } - + void ProxyResolver::lookup_async(const Glib::ustring& uri, const SlotAsyncReady& slot) { // Create a copy of the slot. diff --git a/gio/src/resolver.hg b/gio/src/resolver.hg index 66ff18f4..b9b9b09c 100644 --- a/gio/src/resolver.hg +++ b/gio/src/resolver.hg @@ -60,8 +60,8 @@ public: #m4 _CONVERSION(`GList*',`Glib::ListHandle< Glib::RefPtr<InetAddress> >',`$2($3, Glib::OWNERSHIP_DEEP)') _WRAP_METHOD(Glib::ListHandle< Glib::RefPtr<InetAddress> > lookup_by_name(const Glib::ustring& hostname, const Glib::RefPtr<Cancellable>& cancellable{?}), g_resolver_lookup_by_name, errthrow) - - /** Begins asynchronously resolving hostname to determine its associated IP address(es), and eventually calls @a slot, which must call + + /** Begins asynchronously resolving hostname to determine its associated IP address(es), and eventually calls @a slot, which must call * lookup_by_name_finish() to get the result. See lookup_by_name() for more details. * * @param hostname hostname The hostname to look up. @@ -69,8 +69,8 @@ public: * @param cancellable A Cancellable object which can be used to cancel the operation. */ void lookup_by_name_async(const Glib::ustring& hostname, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable); - - /** Begins asynchronously resolving hostname to determine its associated IP address(es), and eventually calls @a slot, which must call + + /** Begins asynchronously resolving hostname to determine its associated IP address(es), and eventually calls @a slot, which must call * lookup_by_name_finish() to get the result. See lookup_by_name() for more details. * * @param hostname hostname The hostname to look up. @@ -78,12 +78,12 @@ public: */ void lookup_by_name_async(const Glib::ustring& hostname, const SlotAsyncReady& slot); _IGNORE(g_resolver_lookup_by_name_async) - + _WRAP_METHOD(Glib::ListHandle< Glib::RefPtr<InetAddress> > lookup_by_name_finish(const Glib::RefPtr<AsyncResult>& result), g_resolver_lookup_by_name_finish, errthrow) _WRAP_METHOD(Glib::ustring lookup_by_address(const Glib::RefPtr<InetAddress>& address, const Glib::RefPtr<Cancellable>& cancellable{?}), g_resolver_lookup_by_address, errthrow) - /** Begins asynchronously reverse-resolving an address to determine its associated hostname, and eventually calls callback, which must call + /** Begins asynchronously reverse-resolving an address to determine its associated hostname, and eventually calls callback, which must call * lookup_by_address_finish() to get the final result. * * @param address The address to reverse-resolve. @@ -92,8 +92,8 @@ public: * @param cancellable A Cancellable object which can be used to cancel the operation. */ void lookup_by_address_async(const Glib::RefPtr<InetAddress>& address, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable); - - /** Begins asynchronously reverse-resolving an address to determine its associated hostname, and eventually calls callback, which must call + + /** Begins asynchronously reverse-resolving an address to determine its associated hostname, and eventually calls callback, which must call * lookup_by_address_finish() to get the final result. * * @param address The address to reverse-resolve. @@ -102,28 +102,28 @@ public: */ void lookup_by_address_async(const Glib::RefPtr<InetAddress>& address, const SlotAsyncReady& slot); _IGNORE(g_resolver_lookup_by_address_async) - + _WRAP_METHOD(Glib::ustring lookup_by_address_finish(const Glib::RefPtr<AsyncResult>& result), g_resolver_lookup_by_address_finish, errthrow) #m4 _CONVERSION(`GList*',`ListHandle_SrvTarget',`$2($3, Glib::OWNERSHIP_DEEP)') _WRAP_METHOD(ListHandle_SrvTarget lookup_service(const Glib::ustring& service, const Glib::ustring& protocol, const Glib::ustring& domain, const Glib::RefPtr<Cancellable>& cancellable{?}), g_resolver_lookup_service, errthrow) - /** Begins asynchronously performing a DNS SRV lookup for the given service and protocol in the given domain, and eventually calls callback, + /** Begins asynchronously performing a DNS SRV lookup for the given service and protocol in the given domain, and eventually calls callback, * which must call lookup_service_finish() to get the final result. See glookup_service() for more details. * * @param service The service type to look up (eg, "ldap"). - * @param protocol The networking protocol to use for service (eg, "tcp") + * @param protocol The networking protocol to use for service (eg, "tcp") * @param domain The DNS domain to look up the service in. * @param slot A callback slot to call after the resolution completes. * @param cancellable A Cancellable object which can be used to cancel the operation. */ void lookup_service_async(const Glib::ustring& service, const Glib::ustring& protocol, const Glib::ustring& domain, const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& cancellable); - - /** Begins asynchronously performing a DNS SRV lookup for the given service and protocol in the given domain, and eventually calls callback, + + /** Begins asynchronously performing a DNS SRV lookup for the given service and protocol in the given domain, and eventually calls callback, * which must call lookup_service_finish() to get the final result. See glookup_service() for more details. * * @param service The service type to look up (eg, "ldap"). - * @param protocol The networking protocol to use for service (eg, "tcp") + * @param protocol The networking protocol to use for service (eg, "tcp") * @param domain The DNS domain to look up the service in. * @param slot A callback slot to call after the resolution completes. */ diff --git a/gio/src/seekable.hg b/gio/src/seekable.hg index 941fd928..79c0d07c 100644 --- a/gio/src/seekable.hg +++ b/gio/src/seekable.hg @@ -34,10 +34,10 @@ namespace Gio /** Stream seeking interface. * Seekable is implemented by streams (implementations of InputStream or OutputStream) that support seeking. - * To find the position of a stream, use tell(). To find - * out if a stream supports seeking, use can_seek(). To position a - * stream, use seek(). To find out if a stream supports - * truncating, use can_truncate(). To truncate a stream, use + * To find the position of a stream, use tell(). To find + * out if a stream supports seeking, use can_seek(). To position a + * stream, use seek(). To find out if a stream supports + * truncating, use can_truncate(). To truncate a stream, use * truncate(). * * @ingroup Streams diff --git a/gio/src/socket.hg b/gio/src/socket.hg index 17eb6f9f..602d0452 100644 --- a/gio/src/socket.hg +++ b/gio/src/socket.hg @@ -178,7 +178,7 @@ public: _WRAP_METHOD(SocketProtocol get_protocol() const, g_socket_get_protocol) _WRAP_METHOD(SocketType get_socket_type() const, g_socket_get_socket_type) _WRAP_METHOD(bool speaks_ipv4() const, g_socket_speaks_ipv4) - + _WRAP_METHOD(Glib::RefPtr<Credentials> get_credentials(), g_socket_get_credentials, errthrow) _WRAP_METHOD(Glib::RefPtr<const Credentials> get_credentials() const, g_socket_get_credentials, errthrow) @@ -205,7 +205,7 @@ public: _WRAP_METHOD(bool join_multicast_group(const Glib::RefPtr<InetAddress>& group, bool source_specific, const std::string& iface{?}), g_socket_join_multicast_group, errthrow) _WRAP_METHOD(bool leave_multicast_group(const Glib::RefPtr<InetAddress>& ggroup, bool source_specific, const std::string& iface{?}), g_socket_leave_multicast_group, errthrow) - + _WRAP_PROPERTY("blocking", bool) _WRAP_PROPERTY("family", SocketFamily) _WRAP_PROPERTY("fd", int) diff --git a/gio/src/socketaddressenumerator.hg b/gio/src/socketaddressenumerator.hg index cf483d94..01a137ae 100644 --- a/gio/src/socketaddressenumerator.hg +++ b/gio/src/socketaddressenumerator.hg @@ -41,7 +41,7 @@ class SocketAddressEnumerator : public Glib::Object public: _WRAP_METHOD(Glib::RefPtr<SocketAddress> next(const Glib::RefPtr<Cancellable>& cancellable{?}), g_socket_address_enumerator_next, errthrow) - /** Asynchronously retrieves the next SocketAddress from the enumerator and then calls @a slot, + /** Asynchronously retrieves the next SocketAddress from the enumerator and then calls @a slot, * which must call next_finish() to get the result. * * @param cancellable A Cancellable object which can be used to cancel the operation. @@ -49,7 +49,7 @@ public: */ void next_async(const Glib::RefPtr<Cancellable>& cancellable, const SlotAsyncReady& slot); - /** Asynchronously retrieves the next SocketAddress from the enumerator and then calls @a slot, + /** Asynchronously retrieves the next SocketAddress from the enumerator and then calls @a slot, * which must call next_finish() to get the result. * * @param slot A callback slot to call after the resolution completes. diff --git a/gio/src/socketlistener.ccg b/gio/src/socketlistener.ccg index dd275599..b55c6055 100644 --- a/gio/src/socketlistener.ccg +++ b/gio/src/socketlistener.ccg @@ -30,10 +30,10 @@ bool SocketListener::add_socket(const Glib::RefPtr<Socket>& socket) Glib::unwrap(socket), 0, &gerror); - + if(gerror) ::Glib::Error::throw_exception(gerror); - + return retval; } @@ -128,7 +128,7 @@ Glib::RefPtr<Socket> SocketListener::accept_socket(Glib::RefPtr<Glib::Object>& s &gerror); if(gerror) ::Glib::Error::throw_exception(gerror); - + if(retobj) source_object = Glib::wrap(retobj); diff --git a/gio/src/socketlistener.hg b/gio/src/socketlistener.hg index 883f10de..9472e6ad 100644 --- a/gio/src/socketlistener.hg +++ b/gio/src/socketlistener.hg @@ -59,7 +59,7 @@ public: _WRAP_METHOD(bool add_socket(const Glib::RefPtr<Socket>& socket, const Glib::RefPtr<Glib::Object>& source_object), g_socket_listener_add_socket, errthrow) - //TODO: The use of WRAP_METHOD_DOCS_ONLY here is almost certainly not good enough. + //TODO: The use of WRAP_METHOD_DOCS_ONLY here is almost certainly not good enough. //Check the HTML actually outputed and probably hand-code them as for Gio::File. _WRAP_METHOD_DOCS_ONLY(g_socket_listener_add_socket) @@ -106,7 +106,7 @@ Glib::RefPtr<Socket> accept_socket(Glib::RefPtr<Glib::Object>& source_object, co _WRAP_METHOD_DOCS_ONLY(g_socket_listener_accept_socket_finish) Glib::RefPtr<Socket> accept_socket_finish(const Glib::RefPtr<AsyncResult>& result, Glib::RefPtr<Glib::Object>& source_object); _IGNORE(g_socket_listener_accept_socket_finish) - + _WRAP_METHOD_DOCS_ONLY(g_socket_listener_accept_socket_finish) Glib::RefPtr<Socket> accept_socket_finish(const Glib::RefPtr<AsyncResult>& result); diff --git a/gio/src/volume.ccg b/gio/src/volume.ccg index 2a7b6bd0..d06790a8 100644 --- a/gio/src/volume.ccg +++ b/gio/src/volume.ccg @@ -91,7 +91,7 @@ void Volume::eject(const SlotAsyncReady& slot, const Glib::RefPtr<Cancellable>& SlotAsyncReady* slot_copy = new SlotAsyncReady(slot); g_volume_eject_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), 0, // mount_operation Glib::unwrap(cancellable), &SignalProxy_async_callback, @@ -106,7 +106,7 @@ void Volume::eject(const SlotAsyncReady& slot, MountUnmountFlags flags) SlotAsyncReady* slot_copy = new SlotAsyncReady(slot); g_volume_eject_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), 0, // mount_operation 0, // cancellable &SignalProxy_async_callback, @@ -116,7 +116,7 @@ void Volume::eject(const SlotAsyncReady& slot, MountUnmountFlags flags) void Volume::eject(MountUnmountFlags flags) { g_volume_eject_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), 0, // mount_operation 0, // cancellable 0, // callback @@ -131,7 +131,7 @@ void Volume::eject(const Glib::RefPtr<MountOperation>& mount_operation, const Sl SlotAsyncReady* slot_copy = new SlotAsyncReady(slot); g_volume_eject_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), Glib::unwrap(mount_operation), Glib::unwrap(cancellable), &SignalProxy_async_callback, @@ -146,7 +146,7 @@ void Volume::eject(const Glib::RefPtr<MountOperation>& mount_operation, const Sl SlotAsyncReady* slot_copy = new SlotAsyncReady(slot); g_volume_eject_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), Glib::unwrap(mount_operation), 0, // cancellable &SignalProxy_async_callback, @@ -156,7 +156,7 @@ void Volume::eject(const Glib::RefPtr<MountOperation>& mount_operation, const Sl void Volume::eject(const Glib::RefPtr<MountOperation>& mount_operation, MountUnmountFlags flags) { g_volume_eject_with_operation(gobj(), - static_cast<GMountUnmountFlags>(flags), + static_cast<GMountUnmountFlags>(flags), Glib::unwrap(mount_operation), 0, // cancellable 0, // callback diff --git a/gio/src/volume.hg b/gio/src/volume.hg index 653a73a3..72329ef7 100644 --- a/gio/src/volume.hg +++ b/gio/src/volume.hg @@ -40,15 +40,15 @@ class File; class Drive; /** The Volume interface represents user-visible objects that can be mounted. - * - * Mounting a Volume instance is an asynchronous operation. For more information about asynchronous operations, see AsyncReady and SimpleAsyncReady. To + * + * Mounting a Volume instance is an asynchronous operation. For more information about asynchronous operations, see AsyncReady and SimpleAsyncReady. To * mount a GVolume, first call mount(), optionally providing a MountOperation object and a SlotAsyncReady callback. - * - * Typically, you will not want to provide a MountOperation if automounting all volumes when a desktop session starts since it's not desirable to + * + * Typically, you will not want to provide a MountOperation if automounting all volumes when a desktop session starts since it's not desirable to * put up a lot of dialogs asking for credentials. - * - * The callback will be fired when the operation has resolved (either with success or failure), and a AsyncReady structure will be passed to the callback. - * That callback should then call g_volume_mount_finish() with the GVolume instance and the GAsyncReady data to see if the operation was completed + * + * The callback will be fired when the operation has resolved (either with success or failure), and a AsyncReady structure will be passed to the callback. + * That callback should then call g_volume_mount_finish() with the GVolume instance and the GAsyncReady data to see if the operation was completed * successfully. If an error is present when finish() is called, then it will be filled with any error information. * * @newin{2,16} @@ -110,7 +110,7 @@ public: void mount(const Glib::RefPtr<MountOperation>& mount_operation, const SlotAsyncReady& slot, MountMountFlags flags = MOUNT_MOUNT_NONE); /** Mounts a volume. - * + * * @param mount_operation A mount operation. */ void mount(const Glib::RefPtr<MountOperation>& mount_operation, MountMountFlags flags = MOUNT_MOUNT_NONE); @@ -166,11 +166,11 @@ public: //_WRAP_VFUNC(bool can_mount(), can_mount) //_WRAP_VFUNC(bool can_eject(), can_eject) - //_WRAP_VFUNC(void mount_fn(GMountMountFlags flags, GMountOperation* mount_operation, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data), mount_fn) //TODO: Rename to mount()? + //_WRAP_VFUNC(void mount_fn(GMountMountFlags flags, GMountOperation* mount_operation, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data), mount_fn) //TODO: Rename to mount()? //_WRAP_VFUNC(bool mount_finish(GAsyncResult* result, GError** error), mount_finish) //_WRAP_VFUNC(void eject(GMountUnmountFlags flags, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data), eject) //_WRAP_VFUNC(bool eject_finish(GAsyncResult* result, GError** error), eject_finish) - + //_WRAP_VFUNC(std::string get_identifier(const std::string& kind), get_identifier) //TODO: Use an ArrayHandle. @@ -190,11 +190,11 @@ Glib::RefPtr<Gio::Volume> wrap(GVolume* object, bool take_copy); namespace Container_Helpers { -/** This specialization of TypeTraits exists - * because the default use of Glib::wrap(GObject*), +/** This specialization of TypeTraits exists + * because the default use of Glib::wrap(GObject*), * instead of a specific Glib::wrap(GSomeInterface*), * would not return a wrapper for an interface. - */ + */ template <> struct TypeTraits< Glib::RefPtr<Gio::Volume> > { @@ -207,7 +207,7 @@ struct TypeTraits< Glib::RefPtr<Gio::Volume> > static CppType to_cpp_type (const CType& item) { - //Use a specific Glib::wrap() function, + //Use a specific Glib::wrap() function, //because CType has the specific type (not just GObject): return Glib::wrap(item, true /* take_copy */); } diff --git a/gio/src/volumemonitor.hg b/gio/src/volumemonitor.hg index 59881198..6e7cc1ad 100644 --- a/gio/src/volumemonitor.hg +++ b/gio/src/volumemonitor.hg @@ -33,8 +33,8 @@ namespace Gio { /** Monitors a file or directory for changes. - * VolumeMonitor is for listing the user-interesting devices and volumes on the - * computer. In other words, what a file selector or file manager would show in + * VolumeMonitor is for listing the user-interesting devices and volumes on the + * computer. In other words, what a file selector or file manager would show in * a sidebar. * * @newin{2,16} |