From f0aa5027009841701e96a6d3c16160ba6ba1a4ad Mon Sep 17 00:00:00 2001 From: mathew-fleisch Date: Mon, 1 Nov 2021 08:15:46 -0700 Subject: [PATCH 1/3] Add asdf installation instructions to docs --- site/content/index.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/site/content/index.md b/site/content/index.md index dc12a809..665fb2d9 100644 --- a/site/content/index.md +++ b/site/content/index.md @@ -42,6 +42,27 @@ The mage binary will be created in your $GOPATH/bin directory. You may also install a binary release from our [releases](https://github.com/magefile/mage/releases) page. +**Using asdf** + +The [asdf version manager](https://asdf-vm.com/) is a tool for installing release binaries from Github. With asdf installed, the [asdf plugin for mage](https://github.com/mathew-fleisch/asdf-mage) can be used to install any released version of mage. + +```shell +# Install asdf plugin for mage +asdf plugin add mage + +# Show all installable versions +asdf list-all mage + +# Install specific version +asdf install mage latest + +# Set a version globally (on your ~/.tool-versions file) +asdf global mage latest + +# Now mage commands are available +mage --version +``` + ## Example Magefile ```go From e72bbdc7fb22de3255a45996aa626f2c3aa7c691 Mon Sep 17 00:00:00 2001 From: Mathew Fleisch Date: Mon, 1 Nov 2021 08:48:26 -0700 Subject: [PATCH 2/3] Update site/content/index.md Co-authored-by: Nate Finch --- site/content/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site/content/index.md b/site/content/index.md index 85474f66..6ceb2d33 100644 --- a/site/content/index.md +++ b/site/content/index.md @@ -57,7 +57,7 @@ See [mage homebrew formula](https://formulae.brew.sh/formula/mage). See [scoop](https://scoop.sh/). -**Using asdf** +### Using asdf The [asdf version manager](https://asdf-vm.com/) is a tool for installing release binaries from Github. With asdf installed, the [asdf plugin for mage](https://github.com/mathew-fleisch/asdf-mage) can be used to install any released version of mage. From 0a2cc6635cb08c0874e403757cc17efec11c7e12 Mon Sep 17 00:00:00 2001 From: mathew-fleisch Date: Mon, 1 Nov 2021 08:49:06 -0700 Subject: [PATCH 3/3] Clean up asdf installation instructions --- site/content/index.md | 11 ----------- 1 file changed, 11 deletions(-) diff --git a/site/content/index.md b/site/content/index.md index 6ceb2d33..25bfe14a 100644 --- a/site/content/index.md +++ b/site/content/index.md @@ -62,20 +62,9 @@ See [scoop](https://scoop.sh/). The [asdf version manager](https://asdf-vm.com/) is a tool for installing release binaries from Github. With asdf installed, the [asdf plugin for mage](https://github.com/mathew-fleisch/asdf-mage) can be used to install any released version of mage. ```shell -# Install asdf plugin for mage asdf plugin add mage - -# Show all installable versions -asdf list-all mage - -# Install specific version asdf install mage latest - -# Set a version globally (on your ~/.tool-versions file) asdf global mage latest - -# Now mage commands are available -mage --version ``` ## Example Magefile