Skip to content

Commit fb0a283

Browse files
authored
fixed the URLs for the dependencies in the build doc, fixes #57469 (#57482)
julia markdown parser does not support reference style links which was causing the dependency urls to not be rendered correctly in the build docs html. See issue #57469.
1 parent 3c02af9 commit fb0a283

File tree

1 file changed

+33
-69
lines changed

1 file changed

+33
-69
lines changed

doc/src/devdocs/build/build.md

Lines changed: 33 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -161,20 +161,20 @@ Notes for various architectures:
161161

162162
Building Julia requires that the following software be installed:
163163

164-
- **[GNU make]** — building dependencies.
165-
- **[gcc & g++][gcc]** (>= 7.1) or **[Clang][clang]** (>= 5.0, >= 9.3 for Apple Clang) — compiling and linking C, C++.
166-
- **[libatomic][gcc]** — provided by **[gcc]** and needed to support atomic operations.
167-
- **[python]** (>=2.7) — needed to build LLVM.
168-
- **[gfortran]** — compiling and linking Fortran libraries.
169-
- **[perl]** — preprocessing of header files of libraries.
170-
- **[wget]**, **[curl]**, or **[fetch]** (FreeBSD) — to automatically download external libraries.
171-
- **[m4]** — needed to build GMP.
172-
- **[awk]** — helper tool for Makefiles.
173-
- **[patch]** — for modifying source code.
174-
- **[cmake]** (>= 3.4.3) — needed to build `libgit2`.
175-
- **[pkg-config]** — needed to build `libgit2` correctly, especially for proxy support.
176-
- **[powershell]** (>= 3.0) — necessary only on Windows.
177-
- **[which]** — needed for checking build dependencies.
164+
- **[GNU make](https://www.gnu.org/software/make)** — building dependencies.
165+
- **[gcc & g++](https://gcc.gnu.org)** (>= 7.1) or **[Clang][clang]** (>= 5.0, >= 9.3 for Apple Clang) — compiling and linking C, C++.
166+
- **[libatomic](https://gcc.gnu.org)** — provided by **[gcc]** and needed to support atomic operations.
167+
- **[python](https://www.python.org/)** (>=2.7) — needed to build LLVM.
168+
- **[gfortran](https://gcc.gnu.org/fortran/)** — compiling and linking Fortran libraries.
169+
- **[perl](https://www.perl.org)** — preprocessing of header files of libraries.
170+
- **[wget](https://www.gnu.org/software/wget)**, **[curl](https://curl.se)**, or **[fetch](https://www.freebsd.org/cgi/man.cgi?fetch(1))** (FreeBSD) — to automatically download external libraries.
171+
- **[m4](https://www.gnu.org/software/m4)** — needed to build GMP.
172+
- **[awk](https://www.gnu.org/software/gawk)** — helper tool for Makefiles.
173+
- **[patch](https://www.gnu.org/software/patch)** — for modifying source code.
174+
- **[cmake](https://www.cmake.org)** (>= 3.4.3) — needed to build `libgit2`.
175+
- **[pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/)** — needed to build `libgit2` correctly, especially for proxy support.
176+
- **[powershell](https://docs.microsoft.com/en-us/powershell/scripting/wmf/overview)** (>= 3.0) — necessary only on Windows.
177+
- **[which](https://carlowood.github.io/which/)** — needed for checking build dependencies.
178178

179179
On Debian-based distributions (e.g. Ubuntu), you can easily install them with `apt-get`:
180180
```
@@ -187,61 +187,25 @@ repository) and then compiled from source the first time you run
187187
`make`. The specific version numbers of these libraries that Julia
188188
uses are listed in [`deps/$(libname).version`](https://github.com/JuliaLang/julia/blob/master/deps/):
189189

190-
- **[LLVM]** (15.0 + [patches](https://github.com/JuliaLang/llvm-project/tree/julia-release/15.x)) — compiler infrastructure (see [note below](#llvm)).
191-
- **[FemtoLisp]** — packaged with Julia source, and used to implement the compiler front-end.
192-
- **[libuv]** (custom fork) — portable, high-performance event-based I/O library.
193-
- **[OpenLibm]** — portable libm library containing elementary math functions.
194-
- **[DSFMT]** — fast Mersenne Twister pseudorandom number generator library.
195-
- **[OpenBLAS]** — fast, open, and maintained [basic linear algebra subprograms (BLAS)]
196-
- **[LAPACK]** — library of linear algebra routines for solving systems of simultaneous linear equations, least-squares solutions of linear systems of equations, eigenvalue problems, and singular value problems.
197-
- **[MKL]** (optional) – OpenBLAS and LAPACK may be replaced by Intel's MKL library.
198-
- **[SuiteSparse]** — library of linear algebra routines for sparse matrices.
199-
- **[PCRE]** — Perl-compatible regular expressions library.
200-
- **[GMP]** — GNU multiple precision arithmetic library, needed for `BigInt` support.
201-
- **[MPFR]** — GNU multiple precision floating point library, needed for arbitrary precision floating point (`BigFloat`) support.
202-
- **[libgit2]** — Git linkable library, used by Julia's package manager.
203-
- **[curl]** — libcurl provides download and proxy support.
204-
- **[libssh2]** — library for SSH transport, used by libgit2 for packages with SSH remotes.
205-
- **[OpenSSL]** — library used for cryptography and transport layer security, used by libgit2 and libssh2.
206-
- **[utf8proc]** — a library for processing UTF-8 encoded Unicode strings.
207-
- **[LLVM libunwind]** — LLVM's fork of [libunwind], a library that determines the call-chain of a program.
208-
- **[ITTAPI]** — Intel's Instrumentation and Tracing Technology and Just-In-Time API.
209-
210-
[GNU make]: https://www.gnu.org/software/make
211-
[patch]: https://www.gnu.org/software/patch
212-
[wget]: https://www.gnu.org/software/wget
213-
[m4]: https://www.gnu.org/software/m4
214-
[awk]: https://www.gnu.org/software/gawk
215-
[gcc]: https://gcc.gnu.org
216-
[clang]: https://clang.llvm.org
217-
[python]: https://www.python.org/
218-
[gfortran]: https://gcc.gnu.org/fortran/
219-
[curl]: https://curl.haxx.se
220-
[fetch]: https://www.freebsd.org/cgi/man.cgi?fetch(1)
221-
[perl]: https://www.perl.org
222-
[cmake]: https://www.cmake.org
223-
[OpenLibm]: https://github.com/JuliaLang/openlibm
224-
[DSFMT]: https://github.com/MersenneTwister-Lab/dSFMT
225-
[OpenBLAS]: https://github.com/xianyi/OpenBLAS
226-
[LAPACK]: https://www.netlib.org/lapack
227-
[MKL]: https://software.intel.com/en-us/articles/intel-mkl
228-
[SuiteSparse]: https://people.engr.tamu.edu/davis/suitesparse.html
229-
[PCRE]: https://www.pcre.org
230-
[LLVM]: https://www.llvm.org
231-
[LLVM libunwind]: https://github.com/llvm/llvm-project/tree/main/libunwind
232-
[FemtoLisp]: https://github.com/JeffBezanson/femtolisp
233-
[GMP]: https://gmplib.org
234-
[MPFR]: https://www.mpfr.org
235-
[libuv]: https://github.com/JuliaLang/libuv
236-
[libgit2]: https://libgit2.org/
237-
[utf8proc]: https://julialang.org/utf8proc/
238-
[libunwind]: https://www.nongnu.org/libunwind
239-
[libssh2]: https://www.libssh2.org
240-
[OpenSSL]: https://www.openssl.org/
241-
[pkg-config]: https://www.freedesktop.org/wiki/Software/pkg-config/
242-
[powershell]: https://docs.microsoft.com/en-us/powershell/scripting/wmf/overview
243-
[which]: https://carlowood.github.io/which/
244-
[ITTAPI]: https://github.com/intel/ittapi
190+
- **[LLVM](https://www.llvm.org)** (15.0 + [patches](https://github.com/JuliaLang/llvm-project/tree/julia-release/15.x)) — compiler infrastructure (see [note below](#llvm)).
191+
- **[FemtoLisp](https://github.com/JeffBezanson/femtolisp)** — packaged with Julia source, and used to implement the compiler front-end.
192+
- **[libuv](https://github.com/JuliaLang/libuv)** (custom fork) — portable, high-performance event-based I/O library.
193+
- **[OpenLibm](https://github.com/JuliaLang/openlibm)** — portable libm library containing elementary math functions.
194+
- **[DSFMT](https://github.com/MersenneTwister-Lab/dSFMT)** — fast Mersenne Twister pseudorandom number generator library.
195+
- **[OpenBLAS](https://github.com/xianyi/OpenBLAS)** — fast, open, and maintained [basic linear algebra subprograms (BLAS)]
196+
- **[LAPACK](https://www.netlib.org/lapack)** — library of linear algebra routines for solving systems of simultaneous linear equations, least-squares solutions of linear systems of equations, eigenvalue problems, and singular value problems.
197+
- **[MKL](https://software.intel.com/en-us/articles/intel-mkl)** (optional) – OpenBLAS and LAPACK may be replaced by Intel's MKL library.
198+
- **[SuiteSparse](https://people.engr.tamu.edu/davis/suitesparse.html)** — library of linear algebra routines for sparse matrices.
199+
- **[PCRE](https://www.pcre.org)** — Perl-compatible regular expressions library.
200+
- **[GMP](https://gmplib.org)** — GNU multiple precision arithmetic library, needed for `BigInt` support.
201+
- **[MPFR](https://www.mpfr.org)** — GNU multiple precision floating point library, needed for arbitrary precision floating point (`BigFloat`) support.
202+
- **[libgit2](https://libgit2.org/)** — Git linkable library, used by Julia's package manager.
203+
- **[curl](https://curl.se)** — libcurl provides download and proxy support.
204+
- **[libssh2](https://www.libssh2.org)** — library for SSH transport, used by libgit2 for packages with SSH remotes.
205+
- **[OpenSSL](https://www.openssl.org/)** — library used for cryptography and transport layer security, used by libgit2 and libssh2.
206+
- **[utf8proc](https://julialang.org/utf8proc/)** — a library for processing UTF-8 encoded Unicode strings.
207+
- **[LLVM libunwind](https://www.nongnu.org/libunwind)** — LLVM's fork of [libunwind], a library that determines the call-chain of a program.
208+
- **[ITTAPI](https://github.com/intel/ittapi)** — Intel's Instrumentation and Tracing Technology and Just-In-Time API.
245209

246210
## Build dependencies
247211

0 commit comments

Comments
 (0)