e8bc19f79c
Maintainers of win32 DLLs can opt to provide libraries with 'decorated' function names (Google "stdcall name decoration"). To pull a function pointer out of one of these DLLs, you have to pass a decorated name to getProcAddress. This is painful for the authors of NIM DLL wrappers - they have to pass manually-decorated strings to "importc", but only on win32. This commit adds auto-decoration to nimGetProcAddress. This function will probe the DLL for the undecorated name, and if that fails, it will automatically add decoration and try again. That way, the author of the wrapper doesn't have to deal with it. |
||
|---|---|---|
| bin | ||
| build | ||
| compiler | ||
| config | ||
| doc | ||
| examples | ||
| icons | ||
| lib | ||
| tests | ||
| tinyc | ||
| tools | ||
| web | ||
| .gitignore | ||
| .travis.yml | ||
| appveyor.yml | ||
| bootstrap.sh | ||
| compiler.nimble | ||
| contributing.rst | ||
| contributors.txt | ||
| copying.txt | ||
| docstyle.rst | ||
| install.txt | ||
| install_nimble.nims | ||
| koch.nim | ||
| koch.nim.cfg | ||
| readme.md | ||
| readme.txt | ||
| start.bat | ||
| todo.txt | ||
Nim Compiler
This repo contains the Nim compiler, Nim's stdlib, tools and documentation.
Compiling
Compiling the Nim compiler is quite straightforward. Because the Nim compiler itself is written in the Nim programming language the C source of an older version of the compiler are needed to bootstrap the latest version. The C sources are available in a separate repo here.
The compiler currently supports the following platform and architecture combinations:
- Windows (Windows XP or greater) - x86 and x86_64
- Linux (most, if not all, distributions) - x86, x86_64, ppc64 and armv6l
- Mac OS X 10.04 or higher - x86, x86_64 and ppc64
In reality a lot more are supported, however they are not tested regularly.
To build from source you will need:
- gcc 3.x or later recommended. Other alternatives which may work are: clang, Visual C++, Intel's C++ compiler
- git or wget
If you are on a fairly modern *nix system, the following steps should work:
$ git clone git://github.com/nim-lang/Nim.git
$ cd Nim
$ git clone --depth 1 git://github.com/nim-lang/csources
$ cd csources && sh build.sh
$ cd ..
$ bin/nim c koch
$ ./koch boot -d:release
koch install [dir] may then be used to install Nim, but lots of things
don't work then so don't do that. Add it to your PATH instead. More koch
related options are documented in doc/koch.txt.
The above steps can be performed on Windows in a similar fashion, the
build.bat and build64.bat (for x86_64 systems) are provided to be used
instead of build.sh.
Nimble
Nimble is Nim's package manager. For the
source based installations where you added Nim's bin directory to your PATH
the easiest way of installing Nimble is via:
$ nim e install_nimble.nims
Getting help
A forum is available if you have any questions, and you can also get help in the IRC channel on Freenode in #nim. If you ask questions on StackOverflow use the nim tag.
License
The compiler and the standard library are licensed under the MIT license, except for some modules where the documentation suggests otherwise. This means that you can use any license for your own programs developed with Nim, allowing you to create commercial applications.
Read copying.txt for more details.
Copyright (c) 2006-2015 Andreas Rumpf. All rights reserved.
Build Status
| Linux | Windows | Mac | |
|---|---|---|---|
| x86 | |||
| x86_64 | |||
| arm |