From 3032ceba962d6d9a876da8712f1cc632899129fc Mon Sep 17 00:00:00 2001
From: Gilles Crettenand <gilles@crettenand.info>
Date: Tue, 2 Jun 2015 16:15:26 +0200
Subject: [PATCH] document genres methods

---
 NetBiblio.php | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/NetBiblio.php b/NetBiblio.php
index 3d1b8f8..893c2f8 100644
--- a/NetBiblio.php
+++ b/NetBiblio.php
@@ -490,17 +490,31 @@ class NetBiblio extends WebService
         return AudioBook::listOfReaders();
     }
 
+    /**
+     * This method is called by the website in Drupal to get the list
+     * of available 'Genres'.
+     * @return array
+     */
     public function ListOfGenres()
     {
         return AudioBook::ListOfGenres();
     }
 
+    /**
+     * This method is called by the Android application to get the list
+     * of available 'Genres'.
+     * @return array
+     */
     public function ListOfCategories()
     {
-        // this method exists for compatibility purpose with the Android and iOS applications
-        return $this->ListOfGenres();
+        return AudioBook::ListOfGenres();
     }
 
+    /**
+     * This method is called by the iOS application to get the list
+     * of available 'Genres'. 'Jeunesse' must be a part of them.
+     * @return array
+     */
     public function ListOfTypes()
     {
         return array_map(function($g) {