diff --git a/fesod-sheet/src/main/java/org/apache/fesod/sheet/cache/Ehcache.java b/fesod-sheet/src/main/java/org/apache/fesod/sheet/cache/Ehcache.java
index 32ba67570..a13d2dc3a 100644
--- a/fesod-sheet/src/main/java/org/apache/fesod/sheet/cache/Ehcache.java
+++ b/fesod-sheet/src/main/java/org/apache/fesod/sheet/cache/Ehcache.java
@@ -79,6 +79,11 @@ public class Ehcache implements ReadCache {
      */
     private int cacheMiss = 0;
 
+    /**
+     * @param maxCacheActivateSize
+     *            maximum size of the activated cache
+     * @deprecated use {@link #Ehcache(Integer, Integer)} instead, which also accepts a batch count
+     */
     @Deprecated
     public Ehcache(Integer maxCacheActivateSize) {
         this(maxCacheActivateSize, null);
diff --git a/fesod-sheet/src/main/java/org/apache/fesod/sheet/cache/selector/SimpleReadCacheSelector.java b/fesod-sheet/src/main/java/org/apache/fesod/sheet/cache/selector/SimpleReadCacheSelector.java
index 6084aa32b..b96d12530 100644
--- a/fesod-sheet/src/main/java/org/apache/fesod/sheet/cache/selector/SimpleReadCacheSelector.java
+++ b/fesod-sheet/src/main/java/org/apache/fesod/sheet/cache/selector/SimpleReadCacheSelector.java
@@ -69,7 +69,7 @@ public class SimpleReadCacheSelector implements ReadCacheSelector {
     /**
      * Maximum size of cache activation.unit MB.
      *
-     * @deprecated Please use maxCacheActivateBatchCount to control the size of the occupied memory
+     * @deprecated use {@link #maxCacheActivateBatchCount} instead to control the occupied memory
      */
     @Deprecated
     private Integer maxCacheActivateSize;
@@ -87,6 +87,8 @@ public SimpleReadCacheSelector() {}
      *
      * @param maxUseMapCacheSize
      * @param maxCacheActivateSize
+     * @deprecated use {@link #SimpleReadCacheSelector()} plus {@link #setMaxCacheActivateBatchCount(Integer)}
+     *             instead; {@code maxCacheActivateSize} is no longer honored
      */
     @Deprecated
     public SimpleReadCacheSelector(Long maxUseMapCacheSize, Integer maxCacheActivateSize) {
diff --git a/fesod-sheet/src/main/java/org/apache/fesod/sheet/context/WriteContext.java b/fesod-sheet/src/main/java/org/apache/fesod/sheet/context/WriteContext.java
index fa747b86f..ebaf78f15 100644
--- a/fesod-sheet/src/main/java/org/apache/fesod/sheet/context/WriteContext.java
+++ b/fesod-sheet/src/main/java/org/apache/fesod/sheet/context/WriteContext.java
@@ -97,7 +97,7 @@ public interface WriteContext {
      * Current sheet
      *
      * @return
-     * @deprecated please us e{@link #writeSheetHolder()}
+     * @deprecated please use {@link #writeSheetHolder()}
      */
     @Deprecated
     Sheet getCurrentSheet();
@@ -106,7 +106,7 @@ public interface WriteContext {
      * Need head
      *
      * @return
-     * @deprecated please us e{@link #writeSheetHolder()}
+     * @deprecated please use {@link #writeSheetHolder()}
      */
     @Deprecated
     boolean needHead();
diff --git a/fesod-sheet/src/main/java/org/apache/fesod/sheet/converters/string/StringImageConverter.java b/fesod-sheet/src/main/java/org/apache/fesod/sheet/converters/string/StringImageConverter.java
index 06f426a33..65c3e5bdf 100644
--- a/fesod-sheet/src/main/java/org/apache/fesod/sheet/converters/string/StringImageConverter.java
+++ b/fesod-sheet/src/main/java/org/apache/fesod/sheet/converters/string/StringImageConverter.java
@@ -37,6 +37,8 @@
  * String and image converter
  *
  * @see StringPathnameImageConverter
+ * @deprecated use {@link StringPathnameImageConverter} instead, which has the same behaviour under a
+ *             name that reflects it
  */
 @Deprecated
 public class StringImageConverter implements Converter<String> {
diff --git a/fesod-sheet/src/main/java/org/apache/fesod/sheet/read/metadata/holder/ReadSheetHolder.java b/fesod-sheet/src/main/java/org/apache/fesod/sheet/read/metadata/holder/ReadSheetHolder.java
index def35c622..1a7383461 100644
--- a/fesod-sheet/src/main/java/org/apache/fesod/sheet/read/metadata/holder/ReadSheetHolder.java
+++ b/fesod-sheet/src/main/java/org/apache/fesod/sheet/read/metadata/holder/ReadSheetHolder.java
@@ -106,9 +106,9 @@ public ReadSheetHolder(ReadSheet readSheet, ReadWorkbookHolder readWorkbookHolde
 
     /**
      * Approximate total number of rows.
-     * use: getApproximateTotalRowNumber()
      *
      * @return
+     * @deprecated use {@link #getApproximateTotalRowNumber()} instead
      */
     @Deprecated
     public Integer getTotal() {