Merge branch 'master' into feat/macros-sizeof-alignof

Author: straight-shoota

docs/man/crystal/README.md

@@ -142,7 +142,7 @@ Hello Crystal!
 
 * `--cross-compile`: Generate a .o file, and print the command to generate an executable to stdout.
 * `-D FLAG, --define FLAG`: Define a compile-time flag.
-* `-o <output_file>`: Define the name of the binary executable.
+* `-o <path>`, `--output <path>`: Path to the output file. If a directory, the filename is derived from the first source file (default: current directory).
 * `-O LEVEL`: Define optimization level: 0 (default), 1, 2, 3. See [Optimizations](#optimizations) for details.
 * `--release`: Compile in release mode. Equivalent to `-O3 --single-module`.
 * `--link-flags FLAGS`: Additional flags to pass to the linker.
@@ -472,6 +472,7 @@ The following environment variables are used by the Crystal compiler if set in t
 
 * `CRYSTAL_CACHE_DIR`: Defines path where Crystal caches partial compilation results for faster subsequent builds. This path is also used to temporarily store executables when Crystal programs are run with [`crystal run`](#crystal-run) rather than [`crystal build`](#crystal-build).
   Default value is the first directory that either exists or can be created of `${XDG_CACHE_HOME}/crystal` (if `XDG_CACHE_HOME` is defined), `${HOME}/.cache/crystal`, `${HOME}/.crystal`, `./.crystal`. If `CRYSTAL_CACHE_DIR` is set but points to a path that is not writeable, the default values are used instead.
+* `CRYSTAL_EXEC_PATH`: Determines the path where *crystal* looks for external sub-commands.
 * `CRYSTAL_PATH`: Defines paths where Crystal searches for required files.
 * `CRYSTAL_VERSION` is only available as output of [`crystal env`](#crystal-env). The compiler neither sets nor reads it.
 * `CRYSTAL_LIBRARY_PATH`: The compiler uses the paths in this variable as a first lookup destination for static and dynamic libraries that are to be linked. For example, if static libraries are put in `build/libs`, setting the environment variable accordingly will tell the compiler to look for libraries there.

docs/man/required_libraries.md

@@ -85,7 +85,7 @@ Both `OpenSSL` and `LibreSSL` are supported and the bindings automatically detec
 | [LibXML2][libxml2] | XML parser developed for the Gnome project. Implements the [`XML`](https://crystal-lang.org/api/XML.html) module. | [MIT](https://gitlab.gnome.org/GNOME/libxml2/-/blob/master/Copyright) |
 | [LibYAML][libyaml] | YAML parser and emitter library. Implements the [`YAML`](https://crystal-lang.org/api/YAML.html) module. | [MIT](https://github.com/yaml/libyaml/blob/master/License) |
 | [zlib][zlib] | Lossless data compression library. Implements the [`Compress`](https://crystal-lang.org/api/Compress.html) module. May be disabled with the `-Dwithout_zlib` compile-time flag. | [zlib](http://zlib.net/zlib_license.html) |
-| [LLVM][libllvm] | Target-independent code generator and optimizer. Implements the [`LLVM`](https://crystal-lang.org/api/LLVM.html) API. <br>**Supported versions:** LLVM 8-19 (aarch64 requires LLVM 13+) | [Apache v2 with LLVM exceptions](https://llvm.org/docs/DeveloperPolicy.html#new-llvm-project-license-framework) |
+| [LLVM][libllvm] | Target-independent code generator and optimizer. Implements the [`LLVM`](https://crystal-lang.org/api/LLVM.html) API. <br>**Supported versions:** LLVM 8-20 (aarch64 requires LLVM 13+) | [Apache v2 with LLVM exceptions](https://llvm.org/docs/DeveloperPolicy.html#new-llvm-project-license-framework) |
 
 ## Compiler dependencies