From b0f56622384bbc3f2f5d455348bb0672eefcd0a3 Mon Sep 17 00:00:00 2001 From: Egor Tensin Date: Sun, 10 Jan 2021 17:28:19 +0300 Subject: add README.md --- README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..4260dbc --- /dev/null +++ b/README.md @@ -0,0 +1,45 @@ +Set up Clang +============ + +[![Test](https://github.com/egor-tensin/setup-clang/workflows/Test/badge.svg)](https://github.com/egor-tensin/setup-gcc/actions?query=workflow%3ATest) + +This is a GitHub action that sets up Clang & LLVM in your workflow run. + +Use it in your workflow like this: + + - name: Set up Clang + uses: egor-tensin/setup-clang@v1 + with: + platform: x64 + +* `x64` is the default value for the `platform` parameter and can be omitted. +Use `x86` if you want to build 32-bit binaries. +* Set the `cygwin` parameter to `1` to set up Clang inside an existing Cygwin +installation (you can set up Cygwin itself using my action [setup-cygwin]). +* `cc` and `c++` executables are set up, pointing to the `clang` and `clang++` +executables. +Disable this by setting the `cc` parameter to `0`. + +[setup-cygwin]: https://github.com/egor-tensin/setup-cygwin + +API +--- + +| Input | Value | Default | Description +| --------- | ------- | ------- | ----------- +| platform | x64 | Yes | Install the x86_64 toolchain. +| | *Other* | No | Install the i686 toolchain. +| cygwin | *Other* | Yes | Install native binaries. +| | 1 | No | Install Cygwin packages. +| cc | 1 | Yes | Set up `cc`/`c++` executables. +| | *Other* | No | Don't set up `cc`/`c++`. +| hardlinks | *Other* | Yes | Cygwin: don't convert any symlinks. +| | 1 | No | Cygwin: convert symlinks in /usr/bin to hardlinks. + +License +------- + +Distributed under the MIT License. +See [LICENSE.txt] for details. + +[LICENSE.txt]: LICENSE.txt -- cgit v1.2.3