[nautilus/wip/antoniof/local_vs_native_fixup: 156/157] file: Rename and document has_local_path() method

[António Fernandes <antoniof src gnome org>]

commit c1767706ca669c3a57f4e5adf0caed4a0fafe1dc
Author: António Fernandes <antoniof gnome org>
Date:   Sun May 17 00:53:41 2020 +0100

    file: Rename and document has_local_path() method
    
    The new name better reflects the usage and meaning of this method.

 src/nautilus-file.c         | 14 +++++++++++++-
 src/nautilus-file.h         |  2 +-
 src/nautilus-files-view.c   |  4 ++--
 src/nautilus-mime-actions.c |  2 +-
 4 files changed, 17 insertions(+), 5 deletions(-)
---
diff --git a/src/nautilus-file.c b/src/nautilus-file.c
index becef0ab6..737e64762 100644
--- a/src/nautilus-file.c
+++ b/src/nautilus-file.c
@@ -2369,8 +2369,20 @@ nautilus_file_is_local (NautilusFile *file)
     return nautilus_directory_is_local (file->details->directory);
 }
 
+/**
+ * nautilus_file_has_local_path:
+ *
+ * @file: a #NautilusFile
+ *
+ * Checks whether this file has an obtainable local paths. Usually, this means
+ * the local path can be obtained by calling g_file_get_path(); this includes
+ * native and FUSE files. As an exception, the local URI for files in recent://
+ * can only be obtained from the G_FILE_ATTRIBUTE_STANDARD_TARGET_URI attribute.
+ *
+ * Returns: %TRUE if a local path is known to be obtainable for this file.
+ */
 gboolean
-nautilus_file_is_local_or_fuse (NautilusFile *file)
+nautilus_file_has_local_path (NautilusFile *file)
 {
     g_return_val_if_fail (NAUTILUS_IS_FILE (file), FALSE);
 
diff --git a/src/nautilus-file.h b/src/nautilus-file.h
index 2164808ca..7168a453e 100644
--- a/src/nautilus-file.h
+++ b/src/nautilus-file.h
@@ -421,7 +421,7 @@ gboolean                nautilus_file_matches_uri                       (Nautilu
 
 /* Is the file local? */
 gboolean                nautilus_file_is_local                          (NautilusFile                   
*file);
-gboolean                nautilus_file_is_local_or_fuse                  (NautilusFile                   
*file);
+gboolean                nautilus_file_has_local_path                    (NautilusFile                   
*file);
 
 /* Comparing two file objects for sorting */
 NautilusFileSortType    nautilus_file_get_default_sort_type             (NautilusFile                   
*file,
diff --git a/src/nautilus-files-view.c b/src/nautilus-files-view.c
index 9c1dbf061..c3d95b612 100644
--- a/src/nautilus-files-view.c
+++ b/src/nautilus-files-view.c
@@ -5139,7 +5139,7 @@ get_file_names_as_parameter_array (GList             *selection,
         g_autoptr (GFile) file_location = NULL;
         NautilusFile *file = NAUTILUS_FILE (node->data);
 
-        if (!nautilus_file_is_local_or_fuse (file))
+        if (!nautilus_file_has_local_path (file))
         {
             parameters[i] = NULL;
             g_strfreev (parameters);
@@ -5180,7 +5180,7 @@ get_file_paths_or_uris_as_newline_delimited_string (GList    *selection,
         {
             g_autofree gchar *path = NULL;
 
-            if (!nautilus_file_is_local_or_fuse (file))
+            if (!nautilus_file_has_local_path (file))
             {
                 g_string_free (expanding_string, TRUE);
                 return g_strdup ("");
diff --git a/src/nautilus-mime-actions.c b/src/nautilus-mime-actions.c
index 26468c597..cb2d4ea57 100644
--- a/src/nautilus-mime-actions.c
+++ b/src/nautilus-mime-actions.c
@@ -390,7 +390,7 @@ nautilus_mime_get_default_application_for_file (NautilusFile *file)
 
     mime_type = nautilus_file_get_mime_type (file);
     app = g_app_info_get_default_for_type (mime_type,
-                                           !nautilus_file_is_local_or_fuse (file));
+                                           !nautilus_file_has_local_path (file));
     g_free (mime_type);
 
     if (app == NULL)