Installing SB-Assembler Version 3
Installing on Linux/Unix/MAC
Most computers running Linux, Unix and MAC have the Python interpreter language already installed.
You can simply check if this is true by typing the command python in a terminal.
If it is installed you'll see the Python version printed followed by the Python prompt >>>.
You may choose to install the SB-Assembler for the current user only (easiest), or system wide for all users. Usually it will be sufficient to install it for the current user only. Simply start by unpacking all files from the download package into a temporary directory.
For an installation for the current user only, copy the file sbasm and the entire directory sbapack into the directory ~/bin .
For the less experienced Linux users, the ~/bin directory is the directory /home/you/bin, where you is the user name you used during logon.
If the directory ~/bin doesn't exist, create it before copying the files into it.
Ubuntu will automatically add the directory ~/bin to your PATH, the next time you start a new bash shell.
If your Linux/Unix version doesn't do that, include ~/bin yourself to the PATH variable in your ~/.profile file.
Different shells have different ways to add a directory to the PATH, Google is your friend if you use another shell than bash.
System wide installation of the SB-Assembler requires you to be able to become the super user, or root.
The process is much the same as for current user only installations.
The main difference is the destination of the file sbasm and the directory sbapack.
They must be copied to the directory /usr/bin, which requires root privileges.
Make sure everyone has the right to execute the file sbasm and read access to all the files in the directory sbapack.
cd /usr/bin/sbapack sudo ./precompile.sh
Installing newer releases of the SB-Assembler requires you to overwrite exisiting files with the newer versions. And don't forget to run the precompile script if you installed your copy to the /usr/bin directory.
Final note: On most systems the pyhton interpreter can be found in the directory /usr/bin/.
However, on some systems (e.g. FreeBSD) the python interpreter is located in /usr/local/bin/.
In that case you will have to change the first line of the sbasm file so that it points to the proper directory.
The same is true for the first line of the precompile.sh script, if you need that for system wide installation.
Installing on Windows
Windows doesn't come standard with a Python interpreter.
You can simply download it from www.python.org/download/.
There you can download version 2.4 or higher for your Windows version, which is usually the first link you can click on the download page.
Now it's time to download the SB-Assembler package, if you haven't done so already.
After that you can unpack it all into a temporary directory of your choice.
You may have to change the contents of the file sbasm.bat, which you have moved to the directory of your choice. The default content is shown below:
C:\Python26\python c:\sbasm3\sbasm %1 %2 %3
Here you may have to change the path to your python directory and the path to the program sbasm. If your python interpreter is indeed located at C:\Python26, and your copy of the SB-Assembler is located in C:\sbasm3, then you don't have to change anything.
Finally you should include the path to sbasm.bat into your path. An example of how to add a directory to the path is shown below.
Installing SB-Assembler Version 2
The SB-Assembler doesn't really require an installation process. All you need to do is copy some files into the right locations. But I can give you some tips to make life as comfortable as possible while working with the SB-Assembler.
Don't worry about your projects when updating the assembler after a previous installation. Only the original files from the download package will be overwritten by a new version or the same version. Your own work will be unaffected.
Please note that I am not suggesting that you don't have to make backup copies of your work!
Changing The Path On Windows XP
Here's the procedure to add the ;..\ path to machines running Windows XP:
Right-click on "My Computer" and select "Properties" to open the System Properties window.
This will open the next screen.
Now you can add the string ;..\ at the end of the Path.