diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 28 |
1 files changed, 21 insertions, 7 deletions
@@ -1,6 +1,5 @@ -[](http://ghdl.readthedocs.io/en/latest/?badge=latest) [](https://gitter.im/ghdl1/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) - -[](https://travis-ci.org/tgingold/ghdl) [](https://ci.appveyor.com/project/tgingold/ghdl)  [](https://github.com/tgingold/ghdl/releases) +[](http://ghdl.readthedocs.io/en/latest/?badge=latest) [](https://gitter.im/ghdl1/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://github.com/tgingold/ghdl/blob/master/COPYING.md) [](https://github.com/tgingold/ghdl/blob/master/COPYING.md) +[](https://travis-ci.org/tgingold/ghdl) [](https://ci.appveyor.com/project/tgingold/ghdl)  [](https://github.com/tgingold/ghdl/releases) # GHDL @@ -22,19 +21,34 @@ Supported third party projects: [VUnit](https://vunit.github.io), [OSVVM](http:/ GHDL is free software: -- [](https://github.com/tgingold/ghdl/blob/master/COPYING.md) -- Doc is available on [ghdl.readthedocs.org](https://ghdl.readthedocs.org/en/latest/index.html). +- [](https://github.com/tgingold/ghdl/blob/master/COPYING.md) +- [](https://github.com/tgingold/ghdl/blob/master/COPYING.md) available at [](https://ghdl.readthedocs.org) - Some of the runtime libraries, are under different terms; see the individual source files for details. ## Getting GHDL ### Pre-built releases -You can download pre-built releases for different platforms, backends and library versions from [GitHub releases](https://github.com/1138-4EB/ghdl/releases). +Periodically (not regularly), several binary distributions are made available through the [releases](https://github.com/tgingold/ghdl/releases) tab. If you can't find the one matching the platform and versions you need, you can build it yourself! + +### Docker containers + +If you don't want to install the dependencies in your own filesystem, [Docker](https://www.docker.com/) containers can be used. You can have the latest version compiled and automatically placed in your current path with: + +``` +wget "https://raw.githubusercontent.com/tgingold/ghdl/master/dist/linux/docker-buildtest.sh" +chmod +x docker-buildtest.sh +./docker-buildtest.sh -i "ghdl/ghdl-tools:fedora-llvm-cmp" -b "mcode" -f "ghdl-mcode.tgz" -g +``` + +See '[Docker](http://ghdl.readthedocs.io/en/latest/getting/Docker.html)' for a list of available images and compiler options. You will also find images with GHDL installed already, so that you can directly start using it without caring about the platform! + +*If you are new to docker, keep in mind that it's not significantly different from the traditional way. Exactly the same commands are executed, but it's done in a box similar to a virtual machine.* +>>>>>>> README.md, index, WhatIsVHDL, WhatIsGHDL ready for review. ### Building GHDL -You need the GNU Ada compiler, GNAT GPL, 2014 (or later) for x86 (32 or 64 bits). GNAT GPL can be downloaded anonymously from [libre.adacore.com](http://libre.adacore.com/tools/gnat-gpl-edition/). Then, untar and run the *doinstall* script. +In order to follow the traditional way to `configure` and `make`, you need the GNU Ada compiler, GNAT GPL, 2014 (or later) for x86 (32 or 64 bits). GNAT GPL can be downloaded anonymously from [libre.adacore.com](http://libre.adacore.com/tools/gnat-gpl-edition/). Then, untar and run the *doinstall* script. *Depending on the OS and distribution you are using, you will also need to install some toolchain dependencies, such as `zlib`. See '[Building](http://ghdl.readthedocs.io/en/latest/building/index.html)' for specific package names.* |