This is an automated email from the ASF dual-hosted git repository.
ronny pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/couchdb-glazier.git
The following commit(s) were added to refs/heads/main by this push:
new 1b6d703 Update installation instructions (#20)
1b6d703 is described below
commit 1b6d703c5c7c5307975233c2434eaf19b7373071
Author: PÁLI Gábor János <[email protected]>
AuthorDate: Thu Jan 19 14:09:14 2023 +0100
Update installation instructions (#20)
- Unify spelling of SpiderMonkey.
- Take a note about the missing SSL certificates that would be
required for the SpiderMonkey build due to Rust.
- Note that questions on `mach bootstrap` might be different.
- Mention the concerns on clobbering.
- Suggest the reader to verify the presence of the SpiderMonkey
static library as probably the most important asset to have.
- Start a list of currently known build problems.
- Minor markdown nits.
Co-authored-by: Gabor Pali <[email protected]>
---
README.md | 33 +++++++++++++++++++++++++++------
1 file changed, 27 insertions(+), 6 deletions(-)
diff --git a/README.md b/README.md
index a4e3a51..542e951 100644
--- a/README.md
+++ b/README.md
@@ -63,7 +63,7 @@ At this point, you should have the following installed:
This section is not currently automated, due to the need for Mozilla's
separate build
environment. It should be possible to automate (PRs welcome!). At time of
writing, we
-use the `esr91` branch of spidermonkey.
+use the `esr91` branch of SpiderMonkey.
From the same PowerShell prompt, enter the following:
@@ -81,21 +81,33 @@ cd gecko-dev
git checkout esr91
```
-Please answer the following question of `./mach boostrap`. You need this only
for the first run.
-It downloads a complete build toolchain for Spidermonkey. You should run
`./mach bootstrap` from
-the master branch and switch afterwards to your explicit ESR branch!
+Please answer the following questions of `./mach boostrap`. Note that some of
them may not show
+up. You need this only for the first run. It downloads a complete build
toolchain for
+SpiderMonkey. You should run `./mach bootstrap` from the `master` branch and
switch afterwards
+to your explicit ESR branch!
* Would you like to create this directory? (Yn): Y
* Would you like to run a few configuration steps to ensure Git is optimally
configured? (Yn): Y
* Will you be submitting commits to Mozilla? (Yn): n
-* Would you like to enable build system telemetry? (Yn):n
+* Would you like to enable build system telemetry? (Yn): n
+
+On completely fresh Windows installs, it may happen that the necessary SSL
certificates
+are not yet stored on the system. This can cause that some of the files cannot
be
+downloaded over HTTPS. Open the URL https://static.rust-lang.org/ on Internet
Explorer
+and install the missing certificate to resolve this.
+
+The build process may complain about clobbering (perhaps due to switching off
from `master`).
+In this case, create the `CLOBBER` file to silence the related warnings.
+
+Now you should be set to launch the build.
```bash
export MOZCONFIG=/c/relax/couchdb-glazier/moz/sm-opt
./mach build
exit
```
-Now you should have built Spidermonkey.
+
+Once finished, you should have built SpiderMonkey.
Back in PowerShell, copy the binaries to where our build process expects them:
```powershell
@@ -104,6 +116,15 @@ copy C:\relax\gecko-dev\sm-obj-opt\dist\bin\*.dll
C:\relax\vcpkg\installed\x64-w
copy C:\relax\gecko-dev\sm-obj-opt\dist\include\*
C:\relax\vcpkg\installed\x64-windows\include -Recurse -ErrorAction
SilentlyContinue
```
+Be sure to verify if all the components are built properly, especially the
static library,
+i.e. `mozjs-91.lib`, otherwise CouchDB will fail to build. In case anything is
missing,
+check the logs for errors and try searching for them on the [Mozilla Bug
Tracker](https://bugzilla.mozilla.org/home).
+
+Currently known problems:
+
+- [lld-link: error: duplicate symbol:
HeapAlloc](https://bugzilla.mozilla.org/show_bug.cgi?id=1802675)
+- [JS shell build with --disable-jemalloc hits linker error with 2
DllMain](https://bugzilla.mozilla.org/show_bug.cgi?id=1751561)
+
# Building CouchDB itself
You're finally ready. You should snapshot your VM at this point!
