[UNOMI-592] - a tip for building on non-English Windows env (#435)
* UNOMI-592: a tip for building on non-English Windows env
* UNOMI-592 : correct set window command examples for multiple jvm args
diff --git a/manual/src/archives/1.5/asciidoc/building-and-deploying.adoc b/manual/src/archives/1.5/asciidoc/building-and-deploying.adoc
index 19d9a8d..807fa95 100644
--- a/manual/src/archives/1.5/asciidoc/building-and-deploying.adoc
+++ b/manual/src/archives/1.5/asciidoc/building-and-deploying.adoc
@@ -48,7 +48,20 @@
+
This will compile Apache Unomi without running the tests and takes less
time to build.
-
++
+TIP: On a non-English Windows env, the Asciidoctor Maven Plugin may fail to
+ generate manuals due to an encoding conversion issue.
+ To solve this issue, we recommend setting the *file.encoding* system property
+ to _UTF-8_ like the following examples before issuing the commands shown above.
++
+[source]
+----
+ > set MAVEN_OPTS=-Dfile.encoding=UTF-8
+ or
+ > set MAVEN_OPTS=-Dfile.encoding=UTF-8 -Xmx2048m
+ ...
+----
++
. The distributions will be available under "package/target" directory.
==== Installing an ElasticSearch server
diff --git a/manual/src/archives/1.6/asciidoc/building-and-deploying.adoc b/manual/src/archives/1.6/asciidoc/building-and-deploying.adoc
index 21d1fba..7148014 100644
--- a/manual/src/archives/1.6/asciidoc/building-and-deploying.adoc
+++ b/manual/src/archives/1.6/asciidoc/building-and-deploying.adoc
@@ -48,7 +48,20 @@
+
This will compile Apache Unomi without running the tests and takes less
time to build.
-
++
+TIP: On a non-English Windows env, the Asciidoctor Maven Plugin may fail to
+ generate manuals due to an encoding conversion issue.
+ To solve this issue, we recommend setting the *file.encoding* system property
+ to _UTF-8_ like the following examples before issuing the commands shown above.
++
+[source]
+----
+ > set MAVEN_OPTS=-Dfile.encoding=UTF-8
+ or
+ > set MAVEN_OPTS=-Dfile.encoding=UTF-8 -Xmx2048m
+ ...
+----
++
. The distributions will be available under "package/target" directory.
==== Installing an ElasticSearch server
diff --git a/manual/src/main/asciidoc/building-and-deploying.adoc b/manual/src/main/asciidoc/building-and-deploying.adoc
index 21d1fba..7148014 100644
--- a/manual/src/main/asciidoc/building-and-deploying.adoc
+++ b/manual/src/main/asciidoc/building-and-deploying.adoc
@@ -48,7 +48,20 @@
+
This will compile Apache Unomi without running the tests and takes less
time to build.
-
++
+TIP: On a non-English Windows env, the Asciidoctor Maven Plugin may fail to
+ generate manuals due to an encoding conversion issue.
+ To solve this issue, we recommend setting the *file.encoding* system property
+ to _UTF-8_ like the following examples before issuing the commands shown above.
++
+[source]
+----
+ > set MAVEN_OPTS=-Dfile.encoding=UTF-8
+ or
+ > set MAVEN_OPTS=-Dfile.encoding=UTF-8 -Xmx2048m
+ ...
+----
++
. The distributions will be available under "package/target" directory.
==== Installing an ElasticSearch server
