[nautilus-actions] na_io_provider_are_writings_authorized(): Fix comment
- From: Pierre Wieser <pwieser src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [nautilus-actions] na_io_provider_are_writings_authorized(): Fix comment
- Date: Wed, 19 Jan 2011 21:47:51 +0000 (UTC)
commit f8d652a511fc0cb5b3b8b7d2cac4f8540c378fd6
Author: Pierre Wieser <pwieser trychlos org>
Date: Wed Jan 5 19:32:27 2011 +0100
na_io_provider_are_writings_authorized(): Fix comment
src/core/na-io-provider.c | 15 +++++++++------
1 files changed, 9 insertions(+), 6 deletions(-)
---
diff --git a/src/core/na-io-provider.c b/src/core/na-io-provider.c
index 4c98554..957e79f 100644
--- a/src/core/na-io-provider.c
+++ b/src/core/na-io-provider.c
@@ -348,7 +348,7 @@ na_io_provider_get_providers_list( const NAPivot *pivot )
}
/*
- * @priority: the internal ids of IO providers id descending order of
+ * @priority: the internal ids of IO providers in descending order of
* priority for writing new elements, as a string list
*
* build the static list of I/O providers, depending of setup of NAPivot
@@ -421,10 +421,9 @@ merge_available_io_providers( const NAPivot *pivot, GList *ordered )
provider = NULL;
if( id ){
-
provider = na_io_provider_find_provider_by_id( merged, id );
- if( !provider ){
+ if( !provider ){
g_debug( "%s: no provider already allocated in ordered list for id=%s", thisfn, id );
provider = g_object_new( NA_IO_PROVIDER_TYPE, IO_PROVIDER_PROP_ID, id, NULL );
merged = g_list_append( merged, provider );
@@ -1173,12 +1172,16 @@ na_io_provider_has_write_api( const NAIOProvider *provider )
}
/*
- * na_io_provider_get_writable_provider:
+ * na_io_provider_are_writings_authorized:
+ * @provider: the #NAIOProvider provider.
* @pivot: the #NAPivot instance.
*
- * Returns: the first willing and able to write I/O provider, or NULL.
+ * Returns: %TRUE if the @provider will be able to write proposed items,
+ * %FALSE else.
*
- * The returned provider should not be g_object_unref() by the caller.
+ * Unless some external condition change between this call and the actual
+ * writing, the caller can be sure that writings are really possible when
+ * this function returns %TRUE.
*/
gboolean
na_io_provider_are_writings_authorized( const NAIOProvider *provider, const NAPivot *pivot )
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]