[devhelp] Book: remove cmp_by_path() (dead code)

[Sébastien Wilmet <swilmet src gnome org>]

commit 7abe623f033ecd59216d3c253d03900c3dc0b7c2
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Sat Dec 23 17:35:08 2017 +0100

    Book: remove cmp_by_path() (dead code)

 docs/reference/api-breaks.xml       |   11 ++++++++++
 docs/reference/devhelp-sections.txt |    1 -
 src/dh-book.c                       |   36 -----------------------------------
 src/dh-book.h                       |    3 --
 4 files changed, 11 insertions(+), 40 deletions(-)
---
diff --git a/docs/reference/api-breaks.xml b/docs/reference/api-breaks.xml
index 2553d0c..3b10fa0 100644
--- a/docs/reference/api-breaks.xml
+++ b/docs/reference/api-breaks.xml
@@ -196,4 +196,15 @@
       </listitem>
     </itemizedlist>
   </refsect1>
+
+  <refsect1>
+    <title>3.27.1 -> 3.27.2</title>
+    <itemizedlist>
+      <listitem>
+        <para>
+          <code>dh_book_cmp_by_path()</code> has been removed (dead code).
+        </para>
+      </listitem>
+    </itemizedlist>
+  </refsect1>
 </part>
diff --git a/docs/reference/devhelp-sections.txt b/docs/reference/devhelp-sections.txt
index aa17a3e..fe9d168 100644
--- a/docs/reference/devhelp-sections.txt
+++ b/docs/reference/devhelp-sections.txt
@@ -37,7 +37,6 @@ dh_book_get_tree
 dh_book_get_completions
 dh_book_get_enabled
 dh_book_set_enabled
-dh_book_cmp_by_path
 dh_book_cmp_by_id
 dh_book_cmp_by_title
 <SUBSECTION Standard>
diff --git a/src/dh-book.c b/src/dh-book.c
index e38bfd2..b838f82 100644
--- a/src/dh-book.c
+++ b/src/dh-book.c
@@ -576,42 +576,6 @@ dh_book_set_enabled (DhBook   *book,
 }
 
 /**
- * dh_book_cmp_by_path:
- * @a: a #DhBook.
- * @b: a #DhBook.
- *
- * Compares the #DhBook's by their path to the index file.
- *
- * Returns: an integer less than, equal to, or greater than zero, if @a is <, ==
- * or > than @b.
- */
-gint
-dh_book_cmp_by_path (DhBook *a,
-                     DhBook *b)
-{
-        DhBookPrivate *priv_a;
-        DhBookPrivate *priv_b;
-        gchar *path_a;
-        gchar *path_b;
-        gint diff;
-
-        if (a == NULL || b == NULL)
-                return -1;
-
-        priv_a = dh_book_get_instance_private (a);
-        priv_b = dh_book_get_instance_private (b);
-
-        path_a = g_file_get_path (priv_a->index_file);
-        path_b = g_file_get_path (priv_b->index_file);
-
-        diff = g_strcmp0 (path_a, path_b);
-
-        g_free (path_a);
-        g_free (path_b);
-        return diff;
-}
-
-/**
  * dh_book_cmp_by_id:
  * @a: a #DhBook.
  * @b: a #DhBook.
diff --git a/src/dh-book.h b/src/dh-book.h
index f0ad9d5..300cbca 100644
--- a/src/dh-book.h
+++ b/src/dh-book.h
@@ -68,9 +68,6 @@ gboolean     dh_book_get_enabled     (DhBook *book);
 void         dh_book_set_enabled     (DhBook   *book,
                                       gboolean  enabled);
 
-gint         dh_book_cmp_by_path     (DhBook *a,
-                                      DhBook *b);
-
 gint         dh_book_cmp_by_id       (DhBook *a,
                                       DhBook *b);