From 1e617ccfb51855736e27cd618afc092a70832983 Mon Sep 17 00:00:00 2001
From: Soroush Nejad <sardabir@gmail.com>
Date: Mon, 7 Oct 2019 10:59:35 +0200
Subject: Add documentation for Tolerate

---
 .../templates/features/experimental/Tolerate.html  | 34 ++++++++++++++++++++++
 website/templates/features/experimental/index.html |  6 +++-
 .../usageExamples/experimental/Tolerate_post.jpage |  8 +++++
 .../usageExamples/experimental/Tolerate_pre.jpage  | 11 +++++++
 4 files changed, 58 insertions(+), 1 deletion(-)
 create mode 100644 website/templates/features/experimental/Tolerate.html
 create mode 100644 website/usageExamples/experimental/Tolerate_post.jpage
 create mode 100644 website/usageExamples/experimental/Tolerate_pre.jpage

(limited to 'website')

diff --git a/website/templates/features/experimental/Tolerate.html b/website/templates/features/experimental/Tolerate.html
new file mode 100644
index 00000000..09610069
--- /dev/null
+++ b/website/templates/features/experimental/Tolerate.html
@@ -0,0 +1,34 @@
+<#import "../_features.html" as f>
+
+    <@f.scaffold title="@Tolerate" logline="Skip, jump, and forget! Skip a method or constructor.">
+        <@f.history>
+            <p>
+                <code>@Tolerate</code> was introduced as feature in lombok v1.14.2<br />
+            </p>
+        </@f.history>
+
+        <@f.experimental>
+            <ul>
+                <li>
+                    Not used that much.
+                </li>
+                <li>
+                    Difficult to support for edge cases, such as recursive delegation.
+                </li>
+            </ul>
+        </@f.experimental>
+
+        <@f.overview>
+            <p>
+                Any method or constructor can be annotated with <code>@Tolerate</code> and lombok will skip it when
+                considering whether or not to generate a method or constructor. This is useful if the types of the
+                parameters of your method do not clash with what lombok would generate.
+            </p>
+            <p>
+                Put on any method or constructor to make lombok pretend it doesn't exist,i.e., to generate a method
+                which would otherwise be skipped due to possible conflicts.
+            </p>
+        </@f.overview>
+
+        <@f.snippets name="experimental/Tolerate" />
+    </@f.scaffold>
\ No newline at end of file
diff --git a/website/templates/features/experimental/index.html b/website/templates/features/experimental/index.html
index 960f4b1a..9ed3f546 100644
--- a/website/templates/features/experimental/index.html
+++ b/website/templates/features/experimental/index.html
@@ -9,7 +9,7 @@
 		</div>
 		<div class="row">
 			The <a href="/api/">Lombok javadoc</a> is available, but we advise these pages.
-			
+
 			<p>
 				Experimental features are available in your normal lombok installation, but are not as robustly supported as lombok's main features. In particular, experimental features:
 				<ul>
@@ -67,6 +67,10 @@
 			<@main.feature title="@SuperBuilder" href="SuperBuilder">
 				Bob now knows his ancestors: Builders with fields from superclasses, too.
 			</@main.feature>
+
+			<@main.feature title="@Tolerate" href="Tolerate">
+				Skip, jump, and forget! Skip a method or constructor.
+			</@main.feature>
 		</div>
 
 		<@f.confKeys>
diff --git a/website/usageExamples/experimental/Tolerate_post.jpage b/website/usageExamples/experimental/Tolerate_post.jpage
new file mode 100644
index 00000000..57f29e1b
--- /dev/null
+++ b/website/usageExamples/experimental/Tolerate_post.jpage
@@ -0,0 +1,8 @@
+public class TolerateExample {
+    @Setter
+    private Date date;
+
+    public void setDateFromString(String date) {
+        this.date = Date.valueOf(date);
+    }
+}
diff --git a/website/usageExamples/experimental/Tolerate_pre.jpage b/website/usageExamples/experimental/Tolerate_pre.jpage
new file mode 100644
index 00000000..5723df5c
--- /dev/null
+++ b/website/usageExamples/experimental/Tolerate_pre.jpage
@@ -0,0 +1,11 @@
+import lombok.experimental.Tolerate;
+
+public class TolerateExample {
+    @Setter
+    private Date date;
+
+    @Tolerate
+    public void setDate(String date) {
+        this.date = Date.valueOf(date);
+    }
+}
-- 
cgit