fix scaladoc errors

Author: sullivan-

.travis.yml

@@ -1,6 +1,6 @@
 language: scala
 script:
-  - sbt -J-Xmx2048M clean test
+  - sbt -J-Xmx4096M clean test doc
 scala:
   - 2.11.7
 jdk:

src/main/scala/longevity/exceptions/subdomain/AssocIsUnpersistedException.scala

@@ -6,8 +6,8 @@ import longevity.subdomain.Root
 // TODO this should be a persistence exception
 
 /** thrown on attempt to use an unpersisted assoc as a persisted assoc. for instance,
- * when calling [[longevity.persistence.Repo.retrieve(Assoc)]], or attempting to persist with
- * [[longevity.persistence.Repo.create]]
+ * when calling [[longevity.persistence.Repo repository method]] `retrieve(Assoc[R])`,
+ * or attempting to persist with [[longevity.persistence.Repo.create]]
  */
 class AssocIsUnpersistedException(assoc: Assoc[_ <: Root])
 extends AssocException(assoc, "cannot retrieve a persisted aggregate from an unpersisted assoc")

src/main/scala/longevity/persistence/Repo.scala

@@ -18,17 +18,20 @@ trait Repo[R <: Root] {
   def retrieve(assoc: Assoc[R]): Future[Option[PState[R]]]
 
   /** retrieves a non-optional persisted assoc
-   * @throws longevity.exceptions.subdomain.AssocIsUnpersistedException whenever the assoc is not persisted
-   * @throws NoSuchElementException whenever the assoc does not refer to an aggregate in the repository.
+   * 
+   * throws NoSuchElementException whenever the assoc does not refer to an aggregate in the repository.
    * most likely it was deleted.
+   * 
+   * @throws longevity.exceptions.subdomain.AssocIsUnpersistedException whenever the assoc is not persisted
    */
   def retrieveOne(assoc: Assoc[R]): Future[PState[R]]
 
   /** retrieves an optional aggregate by a key value */
   def retrieve(keyVal: KeyVal[R]): Future[Option[PState[R]]]
 
   /** retrieves a non-optional aggregate by a key value
-   * @throws NoSuchElementException whenever the key value does not refer to an aggregate in the repository
+   * 
+   * throws NoSuchElementException whenever the key value does not refer to an aggregate in the repository
    */
   def retrieveOne(keyVal: KeyVal[R]): Future[PState[R]]
 

src/main/scala/longevity/subdomain/Assoc.scala

@@ -21,7 +21,8 @@ object Assoc {
  *
  * there are basically two kinds of associations that you have to understand. the main kind is a
  * "persisted assoc", which means an association to an aggregate that has already been persisted.
- * the associated aggregate can be retrieved using [[longevity.persistence.Repo.retrieve(Assoc)]].
+ * the associated aggregate can be retrieved using [[longevity.persistence.Repo repository method]]
+ * `retrieve(Assoc[R])`.
  *
  * the second kind of association is an "unpersisted assoc", which you can use when creating multiple
  * aggregates at once with [[longevity.persistence.RepoPool.createMany]]. unpersisted assocs are