[gupnp/gupnp-1.4] RootDevice: Rename get_relative_location function

[Jens Georg <jensgeorg src gnome org>]

commit 5002436bbf121e00741f88b9749151eecea0ea50
Author: Jens Georg <mail jensge org>
Date:   Thu Dec 30 11:41:05 2021 +0100

    RootDevice: Rename get_relative_location function
    
    Rename it to get_description_document_name as that is what it actually
    does
    
    Deprecate the old function, pointing to the new name

 doc/gupnp-sections.txt       |  3 ++-
 libgupnp/gupnp-root-device.c | 16 ++++++++++++++++
 libgupnp/gupnp-root-device.h |  4 ++++
 3 files changed, 22 insertions(+), 1 deletion(-)
---
diff --git a/doc/gupnp-sections.txt b/doc/gupnp-sections.txt
index af2573b..980b4c6 100644
--- a/doc/gupnp-sections.txt
+++ b/doc/gupnp-sections.txt
@@ -167,10 +167,11 @@ gupnp_root_device_new
 gupnp_root_device_new_full
 gupnp_root_device_set_available
 gupnp_root_device_get_available
-gupnp_root_device_get_relative_location
+gupnp_root_device_get_description_document_name
 gupnp_root_device_get_description_dir
 gupnp_root_device_get_description_path
 gupnp_root_device_get_ssdp_resource_group
+gupnp_root_device_get_relative_location
 <SUBSECTION Standard>
 GUPnPRootDeviceClass
 GUPNP_ROOT_DEVICE
diff --git a/libgupnp/gupnp-root-device.c b/libgupnp/gupnp-root-device.c
index 0ba44f9..0872752 100644
--- a/libgupnp/gupnp-root-device.c
+++ b/libgupnp/gupnp-root-device.c
@@ -664,9 +664,24 @@ gupnp_root_device_get_available (GUPnPRootDevice *root_device)
  * Get the relative location of @root_device.
  *
  * Return value: The relative location of @root_device.
+ * Deprecated: 1.4.2: Use gupnp_root_device_get_description_document_name() instead.
  **/
 const char *
 gupnp_root_device_get_relative_location (GUPnPRootDevice *root_device)
+{
+        return gupnp_root_device_get_description_document_name (root_device);
+}
+
+/**
+ * gupnp_root_device_get_description_document_name:
+ * @root_device: A #GUPnPRootDevice
+ *
+ * Gets the name of the description document as hosted via HTTP.
+ *
+ * Return value: The relative location of @root_device.
+ **/
+const char *
+gupnp_root_device_get_description_document_name (GUPnPRootDevice *root_device)
 {
         GUPnPRootDevicePrivate *priv;
 
@@ -677,6 +692,7 @@ gupnp_root_device_get_relative_location (GUPnPRootDevice *root_device)
         return priv->relative_location;
 }
 
+
 /**
  * gupnp_root_device_get_description_path:
  * @root_device: A #GUPnPRootDevice
diff --git a/libgupnp/gupnp-root-device.h b/libgupnp/gupnp-root-device.h
index ef53683..17280c8 100644
--- a/libgupnp/gupnp-root-device.h
+++ b/libgupnp/gupnp-root-device.h
@@ -62,6 +62,10 @@ gboolean
 gupnp_root_device_get_available   (GUPnPRootDevice      *root_device);
 
 const char *
+gupnp_root_device_get_descrliption_document_name
+                                  (GUPnPRootDevice      *root_device);
+
+G_GNUC_DEPRECATED_FOR (gupnp_root_device_get_descrliption_document_name) const char *
 gupnp_root_device_get_relative_location
                                   (GUPnPRootDevice      *root_device);