X-Git-Url: https://git.pterodactylus.net/?p=Sone.git;a=blobdiff_plain;f=src%2Fmain%2Fjava%2Fnet%2Fpterodactylus%2Fsone%2Ftext%2FParser.java;h=0daf30c3c08738afaf2db1fc254f9a8b2a79cd5b;hp=3fef8ae997e60a8550555c6a01ef01b70af8a7c0;hb=179e7da4d8d8a474d0b622d60b5f5d32d6ab4052;hpb=ab7fada54ed08b0a8d9ce9c606cbea29c3c3f819

diff --git a/src/main/java/net/pterodactylus/sone/text/Parser.java b/src/main/java/net/pterodactylus/sone/text/Parser.java
index 3fef8ae..0daf30c 100644
--- a/src/main/java/net/pterodactylus/sone/text/Parser.java
+++ b/src/main/java/net/pterodactylus/sone/text/Parser.java
@@ -1,5 +1,5 @@
 /*
- * Sone - Parser.java - Copyright © 2010 David Roden
+ * Sone - Parser.java - Copyright © 2010–2019 David Roden
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -17,8 +17,9 @@
 
 package net.pterodactylus.sone.text;
 
-import java.io.IOException;
 import java.io.Reader;
+import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
 
 /**
  * Interface for parsers that can create {@link Part}s from a text source
@@ -26,21 +27,19 @@ import java.io.Reader;
  *
  * @param <C>
  *            The type of the parser context
- * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
  */
 public interface Parser<C extends ParserContext> {
 
 	/**
-	 * Create a {@link Part} from the given text source.
+	 * Create one or more {@link Part}s from the given text source.
 	 *
-	 * @param context
-	 *            The parser context
 	 * @param source
 	 *            The text source
-	 * @return The parsed part
-	 * @throws IOException
-	 *             if an I/O error occurs
+	 * @param context
+	 *            The parser context (may be {@code null})
+	 * @return The parsed parts
 	 */
-	public Iterable<Part> parse(C context, Reader source) throws IOException;
+	@Nonnull
+	Iterable<Part> parse(@Nonnull String source, @Nullable C context);
 
 }