Skip to content

Commit 4f55bb3

Browse files
committed
Incorporate @rouson 's suggestions from PR #521
1 parent 0f988ad commit 4f55bb3

File tree

1 file changed

+15
-1
lines changed

1 file changed

+15
-1
lines changed

FAQ.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,9 @@ compiler. Alternatively the "Developer/quick-start instructions"
6767
installation using CMake directly, without calling [`install.sh`]. The
6868
compilers are specified using the `FC`, `CC` and `CXX` environment
6969
variables, and all prerequisites (GFortran, CMake, and a suitable MPI
70-
implementation) are assumed to be already installed on the system.
70+
implementation) are assumed to be already installed on the system. If
71+
you pass one compiler-specification argument (e.g., `-f`), it is best
72+
to pass all three (e.g., `-f`, `-c`, and `-C`) to ensure consistency.
7173

7274
## 4. How can I uninstall OpenCoarrays? ##
7375

@@ -104,6 +106,18 @@ such as the `-s` flag to show the underlying command, or the `-np <N>`
104106
flag to specify the number of images in the `cafrun` script and before
105107
any files such as Fortran source files or Coarray Fortran executables.
106108

109+
## 7. When `install.sh` builds the GCC compilers, it takes forever (hours). How can I speed up the build? ##
110+
111+
To increase the odds of success, `install.sh` defaults to a GCC
112+
bootstrap build, which builds a minimal compiler to build the ultimate
113+
compiler (not every version of GCC can build every other version of
114+
GCC). For a much faster build process that has a somewhat higher
115+
chance of failing, pass the `--disable-bootstrap` or `-z` argument and
116+
use more threads by passing, for example, `--num-threads -4` or `-j 4`
117+
to use four threads. In combination, these two recommendations can
118+
decrease the GCC build time from several hours to 15 or fewer minutes.
119+
120+
107121
[`install.sh`]: https://github.com/sourceryinstitute/OpenCoarrays/blob/master/install.sh
108122
[`INSTALL']: https://github.com/sourceryinstitute/OpenCoarrays/blob/master/INSTALL
109123
[new issue]: https://github.com/sourceryinstitute/OpenCoarrays/issues/new

0 commit comments

Comments
 (0)