зеркало из https://github.com/github/ruby.git
[DOC] building_ruby: Refine links
Get rid of using ambiguous demonstratives as link anchors, for the accessibility's sake.
This commit is contained in:
Родитель
5980f14e88
Коммит
457c6b4789
|
@ -27,7 +27,7 @@
|
||||||
* gmp (if you with to accelerate Bignum operations)
|
* gmp (if you with to accelerate Bignum operations)
|
||||||
* libexecinfo (FreeBSD)
|
* libexecinfo (FreeBSD)
|
||||||
* rustc - 1.58.0 or later, if you wish to build
|
* rustc - 1.58.0 or later, if you wish to build
|
||||||
[YJIT](https://docs.ruby-lang.org/en/master/RubyVM/YJIT.html).
|
[YJIT](rdoc-ref:RubyVM::YJIT).
|
||||||
|
|
||||||
If you installed the libraries needed for extensions (openssl, readline,
|
If you installed the libraries needed for extensions (openssl, readline,
|
||||||
libyaml, zlib) into other than the OS default place, typically using
|
libyaml, zlib) into other than the OS default place, typically using
|
||||||
|
@ -49,8 +49,7 @@
|
||||||
|
|
||||||
1. Build from the tarball:
|
1. Build from the tarball:
|
||||||
|
|
||||||
Download the latest tarball from
|
Download the latest tarball from [Download Ruby] page and extract
|
||||||
[ruby-lang.org](https://www.ruby-lang.org/en/downloads/) and extract
|
|
||||||
it. Example for Ruby 3.0.2:
|
it. Example for Ruby 3.0.2:
|
||||||
|
|
||||||
``` shell
|
``` shell
|
||||||
|
@ -115,6 +114,8 @@
|
||||||
generation with different permissions, you can use `make SUDO=sudo
|
generation with different permissions, you can use `make SUDO=sudo
|
||||||
install`.
|
install`.
|
||||||
|
|
||||||
|
[Download Ruby]: https://www.ruby-lang.org/en/downloads/
|
||||||
|
|
||||||
### Unexplainable Build Errors
|
### Unexplainable Build Errors
|
||||||
|
|
||||||
If you are having unexplainable build errors, after saving all your work, try
|
If you are having unexplainable build errors, after saving all your work, try
|
||||||
|
@ -125,7 +126,8 @@ cause build failures.
|
||||||
|
|
||||||
## Building on Windows
|
## Building on Windows
|
||||||
|
|
||||||
The documentation for building on Windows can be found [here](../windows.md).
|
The documentation for building on Windows can be found in [the separated
|
||||||
|
file](../windows.md).
|
||||||
|
|
||||||
## More details
|
## More details
|
||||||
|
|
||||||
|
@ -226,26 +228,28 @@ Please note, however, the following caveats!
|
||||||
|
|
||||||
* ASAN will not work properly on any currently released version of Ruby; the
|
* ASAN will not work properly on any currently released version of Ruby; the
|
||||||
necessary support is currently only present on Ruby's master branch (and the
|
necessary support is currently only present on Ruby's master branch (and the
|
||||||
whole test suite passes only as of commit
|
whole test suite passes only as of commit [Revision 9d0a5148]).
|
||||||
[9d0a5148ae062a0481a4a18fbeb9cfd01dc10428](https://bugs.ruby-lang.org/projects/ruby-master/repository/git/revisions/9d0a5148ae062a0481a4a18fbeb9cfd01dc10428))
|
* Due to [Bug #20243], Clang generates code for threadlocal variables which
|
||||||
* Due to [this bug](https://bugs.ruby-lang.org/issues/20243), Clang generates
|
doesn't work with M:N threading. Thus, it's necessary to disable M:N
|
||||||
code for threadlocal variables which doesn't work with M:N threading. Thus,
|
threading support at build time for now (with the `-DUSE_MN_THREADS=0`
|
||||||
it's necessary to disable M:N threading support at build time for now (with
|
configure argument).
|
||||||
the `-DUSE_MN_THREADS=0` configure argument).
|
* ASAN will only work when using Clang version 18 or later - it requires
|
||||||
* ASAN will only work when using Clang version 18 or later - it requires [this
|
[llvm/llvm-project#75290] related to multithreaded `fork`.
|
||||||
bugfix](https://github.com/llvm/llvm-project/pull/75290) related to
|
|
||||||
multithreaded `fork`.
|
|
||||||
* ASAN has only been tested so far with Clang on Linux. It may or may not work
|
* ASAN has only been tested so far with Clang on Linux. It may or may not work
|
||||||
with other compilers or on other platforms - please file an issue on
|
with other compilers or on other platforms - please file an issue on
|
||||||
[https://bugs.ruby-lang.org](https://bugs.ruby-lang.org) if you run into
|
[Ruby Issue Tracking System] if you run into problems with such configurations
|
||||||
problems with such configurations (or, to report that they actually work
|
(or, to report that they actually work properly!)
|
||||||
properly!)
|
|
||||||
* In particular, although I have not yet tried it, I have reason to believe
|
* In particular, although I have not yet tried it, I have reason to believe
|
||||||
ASAN will _not_ work properly on macOS yet - the fix for the multithreaded
|
ASAN will _not_ work properly on macOS yet - the fix for the multithreaded
|
||||||
fork issue was actually reverted for macOS (see
|
fork issue was actually reverted for macOS (see [llvm/llvm-project#75659]).
|
||||||
[here](https://github.com/llvm/llvm-project/commit/2a03854e4ce9bb1bcd79a211063bc63c4657f92c)). Please
|
Please open an issue on [Ruby Issue Tracking System] if this is a problem for
|
||||||
open an issue on [https://bugs.ruby-lang.org](https://bugs.ruby-lang.org) if
|
you.
|
||||||
this is a problem for you.
|
|
||||||
|
[Revision 9d0a5148]: https://bugs.ruby-lang.org/projects/ruby-master/repository/git/revisions/9d0a5148ae062a0481a4a18fbeb9cfd01dc10428
|
||||||
|
[Bug #20243]: https://bugs.ruby-lang.org/issues/20243
|
||||||
|
[llvm/llvm-project#75290]: https://github.com/llvm/llvm-project/pull/75290
|
||||||
|
[llvm/llvm-project#75659]: https://github.com/llvm/llvm-project/pull/75659#issuecomment-1861584777
|
||||||
|
[Ruby Issue Tracking System]: https://bugs.ruby-lang.org
|
||||||
|
|
||||||
## How to measure coverage of C and Ruby code
|
## How to measure coverage of C and Ruby code
|
||||||
|
|
||||||
|
|
Загрузка…
Ссылка в новой задаче