This is an automated email from the ASF dual-hosted git repository.
jkevan pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/unomi.git
The following commit(s) were added to refs/heads/master by this push:
new 41d5bf625 [UNOMI-592] - a tip for building on non-English Windows env
(#435)
41d5bf625 is described below
commit 41d5bf6254d3d2b6dd44162e093d5fabb7d14e29
Author: Woonsan Ko <[email protected]>
AuthorDate: Wed Jun 22 08:05:25 2022 +0900
[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
---
.../src/archives/1.5/asciidoc/building-and-deploying.adoc | 15 ++++++++++++++-
.../src/archives/1.6/asciidoc/building-and-deploying.adoc | 15 ++++++++++++++-
manual/src/main/asciidoc/building-and-deploying.adoc | 15 ++++++++++++++-
3 files changed, 42 insertions(+), 3 deletions(-)
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 19d9a8d6d..807fa9515 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 and run all of the tests in
the
+
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 21d1fba91..714801452 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 and run all of the tests in
the
+
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 21d1fba91..714801452 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 and run all of the tests in
the
+
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
