Deprecate DefaultEntityResolver.resolveEntity(String) for removal.

See #1

Author: carlosame

junit/io/sf/carte/doc/xml/dtd/DefaultEntityResolverTest.java

@@ -164,6 +164,7 @@ public void resolveEntityStringStringRemote() throws SAXException, IOException {
 
 	@Test
 	public void resolveEntityString() throws SAXException, IOException {
+		@SuppressWarnings("removal")
 		InputSource isrc = resolver.resolveEntity(DocumentTypeDeclaration.XHTML1_TRA_DTDECL);
 		assertNotNull(isrc);
 		assertNotNull(isrc.getPublicId());
@@ -173,6 +174,7 @@ public void resolveEntityString() throws SAXException, IOException {
 		re.close();
 	}
 
+	@SuppressWarnings("removal")
 	@Test
 	public void resolveNonexistentDeclaration() {
 		try {

src/io/sf/carte/doc/xml/dtd/DefaultEntityResolver.java

@@ -516,18 +516,22 @@ public InputSource resolveEntity(DocumentType dtDecl) throws SAXException, IOExc
 	}
 
 	/**
-	 * Resolve the given DTD.
-	 * <p>
-	 * This method is deprecated, use any of the other variants.
-	 * </p>
+	 * Resolve the given DTD string.
 	 * 
 	 * @param documentTypeDeclaration the document type declaration.
 	 * @return an InputSource object describing the new input source to be used by
 	 *         the parser.
 	 * @throws SAXException Any SAX exception, possibly wrapping another exception.
 	 * @throws IOException  indicating a failure to create a new InputStream or
 	 *                      Reader, or an illegal URL.
+	 * @deprecated This method uses the {@link DocumentTypeDeclaration} type, which
+	 *             carries a dependency with the {@code jclf-text} module, and is
+	 *             going to be removed to make the class a bit lighter. People
+	 *             needing this functionality can always parse the DTD string on
+	 *             their own with {@link DocumentTypeDeclaration#parse(String)} and
+	 *             then call {@link #resolveEntity(String, String, String, String)}.
 	 */
+	@Deprecated(forRemoval=true)
 	public InputSource resolveEntity(String documentTypeDeclaration) throws SAXException, IOException {
 		DocumentTypeDeclaration dtDecl = DocumentTypeDeclaration.parse(documentTypeDeclaration);
 		return resolveEntity(dtDecl.getName(), dtDecl.getPublicId(), null, dtDecl.getSystemId());