Public git gives everyone ongoing access to the latest (or near-latest) files. If you plan to contribute any changes, or want to obtain others' changes to the source code, git should make that much easier than just sending code via e-mail. No system is perfect, not even sourceforge. They have changed their configuration several times, and the instructions on this page may need updating, please let Clint Jeffery or Jafar Al-Gharaibeh know of problems with the instructions given here.
- To grab an anonymous copy of Unicon sources from git, see Unicon's git repo on www.sourceforge.net or try the following:
git clone git://git.code.sf.net/p/unicon/unicon
- To grab a (non-anonymous) copy of Unicon sources from git, use the following with your Sourceforge ID:
git clone ssh://userid@git.code.sf.net/p/unicon/unicon
- Unicon developers: code contributions are always welcome by e-mail or by git pull-requests on sourceforge.The base branch for new contributions and bug fixes should be master. Please ensure your pull request is based on this branch when you submit it. Commits should have proper comments and also must be signed off by the developer. Signed-off-by is a s certification that you have the right to submit the patch for inclusion into the project. To add a signature using git add "-s" to your git commit arguments.
git commit -s -m "comment"- To keep you repo up to date and to learn about how to use git see our blog post unicon git guide
- Building Unicon on Linux? You need the C/C++ compiler and libraries (e.g. on Ubuntu, install "build-essential" package). If you want graphics you'll need X11 (Xlib) development headers and libraries (e.g. on Ubuntu, install "libx11-dev"; on Fedora 31 its libX11-devel). You might want to install *-dev or *-devel or *-develop packages for libraries and headers that enable other optional features such as opengl, libz, libjpeg, libpng, ogg/vorbis, sdl, ftgl, and others. Current Ubuntu package names (1/2022): libjpeg-dev, libpng-dev, libxft-dev, libglu1-mesa-dev, libopenal-dev, libalut-dev, libogg-dev, libvorbis-dev, unixodbc-dev, libssl-dev, libfreetype6-dev, libftgl-dev (thanks Ben Jeffery for the originating the list). Current Fedora package names (3/2020): libjpeg-devel, libpng12-devel, libXft-devel, mesa-libGL-devel, mesa-libGLU-devel, openal-devel, freealut-devel, libogg-devel, libvorbis-devel, unixODBC-devel, openssl-devel. Unfortunately, the names of packages change over time and between distributions. If you are having trouble finding the right package, you can e-mail the unicon-group mailing list for advice. For 3D OpenGL capabilities, see also this OpenGL reference for advice on Linux (thanks Shea Newton for the pointer!).
- Using a Windows operating system? Get a git client, such as git-scm.com/download/win or TortoiseGit.
IMPORTANT NOTE: when you first install a git client on Windows make sure to set autocrlf (conver LF to windows-style line ending CRLF) to "false" if you are given the option. A better option is to set the value to "input", especially if you are planning to commit code and want to make sure no CRLF creep back into the repo. If the option is set to "true" the checkout out sources will have CRLF in them and that will break some build scripts.To avoid this issue, set the option to "false" or "input" by doing:
git config --global core.autocrlf input- Using Windows 10+, but want to use the Bash/Ubuntu for Windows, a.k.a. Windows Subsystem for Linux, or WSL? By default it is an almost-normal Ubuntu, with fewer than normal packages installed. You may need to install gcc, make, git, and optionally, almost all Ubuntu packages listed above per "Building Unicon on Linux". If you want graphics facilities:
Also, if you want the IDE help pages to work, you will want to install a web browser on the Ubuntu side of things.
- on current versions of WSL, you will probably want (at least) the fonts installed by these three packages:
sudo apt-get install xfonts-base xfonts-100dpi xfonts-75dpi- on older versions of WSL you need to install an X11 server such as Xming via regular Windows install, launch it, and set your DISPLAY environment variable in bash to DISPLAY=:0. Xming by default comes with only one font, while Unicon applications are told the system guarantees to provide four standard ones; you may want to install an optional extra Xming fonts package.