aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
diff options
context:
space:
mode:
authorEgor Tensin <Egor.Tensin@gmail.com>2020-11-28 03:16:05 +0300
committerEgor Tensin <Egor.Tensin@gmail.com>2020-11-28 03:16:05 +0300
commitf86ccb21e7a2ba792c837fb9a2b267a9d6335531 (patch)
tree038741ddd9d81cc2f2938a8dcf80b9f869445e0f /README.md
parentaction.yml: add "branding" (diff)
downloadsetup-cygwin-1.tar.gz
setup-cygwin-1.zip
add READMEv1
Diffstat (limited to 'README.md')
-rw-r--r--README.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8ce98b2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+Set up Cygwin
+=============
+
+[![Test](https://github.com/egor-tensin/setup-cygwin/workflows/Test/badge.svg)](https://github.com/egor-tensin/setup-cygwin/actions?query=workflow%3ATest)
+
+This is a GitHub action that sets up Cygwin in your workflow run.
+
+1. Installs Cygwin.
+2. Installs any additional packages specified.
+
+Use it in your workflow like this:
+
+ - name: Set up Cygwin
+ uses: egor-tensin/setup-cygwin@v1
+ with:
+ platform: x64
+ packages: cmake python3
+
+`x64` is the default value for the `platform` parameter and can be omitted.
+Use `x86` if you want to install the 32-bit Cygwin.
+
+Specify any additional packages to be installed as a space-separated list in
+the `packages` parameter.
+
+Set the installation directory using the `install-dir` parameter (C:\tools\cygwin
+is the default).
+
+API
+---
+
+| Input | Value | Default | Description
+| ----------- | ------- | ------- | -----------
+| platform | x64 | Yes | Install the 64-bit version.
+| | *Other* | No | Install the 32-bit version.
+| install-dir | *Empty* | Yes | Install to C:\tools\cygwin.
+| | *Other* | No | Install to the specified directory.
+| packages | *Empty* | Yes | Don't install any additional packages.
+| | *Other* | No | Space-separated package names.
+
+The paths to the Cygwin binaries are added to the PATH variable.
+
+License
+-------
+
+Distributed under the MIT License.
+See [LICENSE.txt] for details.
+
+[LICENSE.txt]: LICENSE.txt