Updated API to be more explicit with references

1 files changed, 13 insertions, 7 deletions

diff --git a/libbible.h b/libbible.h
index 85ea9eb..c1058e7 100644
--- a/libbible.h
+++ b/libbible.h
@@ -3,7 +3,7 @@
 #include <map>
 
 namespace libbible {
-    
+
     struct text {
         int chapter;
         int verse;
@@ -17,7 +17,6 @@ namespace libbible {
         std::string modName;
         std::string book;
         std::string bookShort;
-        std::string reference;
         int chapterStart;
         int verseStart;
         int chapterEnd;
@@ -35,13 +34,20 @@ namespace libbible {
     std::vector<struct passage> getPassages(std::string modName, std::string book);
 
     /*
+     * @param modName the module to use for determining the passage
+     * @param reference a human-readable reference, e.g., "gen 1:26-27"
+     * @return the passage matching the reference
+     */
+    passage getPassage(std::string modName, std::string reference);
+
+    /*
      * @return Text for a passage
      */
     std::vector<struct text> getText(struct passage pass);
 
     /**************************
-    * Methods dealing with mods
-    ***************************/
+     * Methods dealing with mods
+     ***************************/
 
     class Status {
         public:
@@ -82,9 +88,9 @@ namespace libbible {
     void uninstallMod(std::string modname);
 
     /******************************
-    * Methods dealing with settings
-    *******************************/
-    
+     * Methods dealing with settings
+     *******************************/
+
     /*
      * From already established code, valid and useful values are:
      *    int fontsize: the last used size of the font