diff --git a/framework/yii/data/BaseDataProvider.php b/framework/yii/data/BaseDataProvider.php
index 15705b7b58..3b0669df25 100644
--- a/framework/yii/data/BaseDataProvider.php
+++ b/framework/yii/data/BaseDataProvider.php
@@ -157,6 +157,9 @@ abstract class BaseDataProvider extends Component implements DataProviderInterfa
 	}
 
 	/**
+	 * Returns the pagination object used by this data provider.
+	 * Note that you should call [[prepare()]] or [[getModels()]] first to get correct values
+	 * of [[Pagination::totalCount]] and [[Pagination::pageCount]].
 	 * @return Pagination|boolean the pagination object. If this is false, it means the pagination is disabled.
 	 */
 	public function getPagination()