Minor JavaDoc updates

This commit is contained in:
arkon 2023-04-22 11:15:45 -04:00
parent 41cc1fe723
commit 94c94b2d88

View File

@ -7,12 +7,12 @@ import eu.kanade.tachiyomi.util.awaitSingle
import rx.Observable import rx.Observable
/** /**
* A basic interface for creating a source. It could be an online source, a local source, etc... * A basic interface for creating a source. It could be an online source, a local source, etc.
*/ */
interface Source { interface Source {
/** /**
* Id for the source. Must be unique. * ID for the source. Must be unique.
*/ */
val id: Long val id: Long
@ -46,9 +46,9 @@ interface Source {
) )
fun fetchChapterList(manga: SManga): Observable<List<SChapter>> = throw IllegalStateException("Not used") fun fetchChapterList(manga: SManga): Observable<List<SChapter>> = throw IllegalStateException("Not used")
// TODO: remove direct usages on this method
/** /**
* Returns an observable with the list of pages a chapter has. * Returns an observable with the list of pages a chapter has. Pages should be returned
* in the expected order; the index is ignored.
* *
* @param chapter the chapter. * @param chapter the chapter.
*/ */
@ -75,7 +75,8 @@ interface Source {
} }
/** /**
* [1.x API] Get the list of pages a chapter has. * [1.x API] Get the list of pages a chapter has. Pages should be returned
* in the expected order; the index is ignored.
*/ */
@Suppress("DEPRECATION") @Suppress("DEPRECATION")
suspend fun getPageList(chapter: SChapter): List<Page> { suspend fun getPageList(chapter: SChapter): List<Page> {