* CI: check docs
* Don't use triple-slash doc comments
A full pass would need to be done to make the comments suitable for
generating documentation.
Co-authored-by: Dan Davison <dandavison7@gmail.com>
The binary release of delta 0.4.5 for macOS created by the "Continuous
Deployment" GitHub Actions workflow does not run on older macOS, like
10.11 (El Capitan) [1].
The Rust compiler, rustc, by default, will build macOS binaries
compatible with macOS 10.7 or newer [2], [3], but some *-sys crates invoke a
C compiler and thus will target the macOS version the C compiler is
running on [4], thus limiting the compatibility of the resulting
binary. The macOS virtual machines used on GitHub Actions run macOS
10.15.7, and since delta depends on some *-sys crates, the delta binary
built by cargo targets macOS 10.15, as can be verified by using the
following command:
$ otool -l ./target/x86_64-apple-darwin/release/delta | grep LC_BUILD_VERSION -A4
cmd LC_BUILD_VERSION
cmdsize 32
platform 1
sdk 10.15.6
minos 10.15
or, if building locally on an older macOS versions, (here 10.11):
$ otool -l ./target/debug/delta | grep LC_VERSION_MIN_MACOSX -A2
cmd LC_VERSION_MIN_MACOSX
cmdsize 16
version 10.11
To restore compatibility with older macOS version, explicitely set the environment
variable `MACOSX_DEPLOYMENT_TARGET` to the default for rustc, "10.7".
This will make the `clang` C compiler invoked by *-sys crates also
target 10.7, thus restoring the compatibility of the delta binary.
For simplicity, add this variable to the environment for all platforms,
which should not have any effect on non-macOS platforms.
[1] https://github.com/dandavison/delta/issues/462
[2] 65d053ab74/compiler/rustc_target/src/spec/apple_base.rs (L15-L17)
[3] 65d053ab74/compiler/rustc_target/src/spec/apple_base.rs (L53-L61)
[4] https://users.rust-lang.org/t/compile-rust-binary-for-older-versions-of-mac-osx/38695/5
* Refactor: pass handle to writer
* Add test of list_syntax_themes
* Add test of show_syntax_themes
* Refactor: pass writer handle
* Add test of show_config
* Exclude main function from coverage calculations
* DEBUGGING
* Refactor: only use stdin if non-empty
Motivation: in the CI test build, atty::is(stdin) seems to be
returning false.
* add audit and CI on ubuntu
* revert Contents changes in README
Signed-off-by: MarcoIeni <11428655+MarcoIeni@users.noreply.github.com>
* README: restore new line
Signed-off-by: MarcoIeni <11428655+MarcoIeni@users.noreply.github.com>