diff --git a/core/ViewableData.php b/core/ViewableData.php
index efa9920a4..f7bb113e8 100644
--- a/core/ViewableData.php
+++ b/core/ViewableData.php
@@ -361,7 +361,7 @@ class ViewableData extends Object implements IteratorAggregate {
 	
 	/**
 	 * Return the value (non-object) version of the given field/method.
-	 * @deprecated
+	 * @deprecated ViewableData->val() is deprecated, use XML_val() instead
 	 */
 	public function val($fieldName, $args = null) {
 		return $this->XML_val($fieldName, $args);
diff --git a/core/model/Image.php b/core/model/Image.php
index 202e8eee0..28cfb6b7e 100755
--- a/core/model/Image.php
+++ b/core/model/Image.php
@@ -391,14 +391,14 @@ class Image extends File {
 	// ###################
 	
 	/**
-	 * @deprecated
+	 * @deprecated Use getTag() instead
 	 */
 	function Tag() {
 		return $this->getTag();
 	}
 	
 	/**
-	 * @deprecated
+	 * @deprecated Use getURL() instead
 	 */
 	function URL() {
 		return $this->getURL();