====== Installation and Usage ======
===== Prerequisites =====
* XC=BASIC is a console application and therefore you need to understand at least the very basics of using the console of your choice, e. g. executing commands, changing directories, copying files, etc.
* XC=BASIC depends on [[https://dasm-assembler.github.io/|dasm]]. Download //dasm// from their website and make sure it is invokable from any directory. You can do this by either installing it into a directory that's already in the PATH environment variable or by adding the directory to PATH.
Make sure you have the latest version of //dasm//. Users reported that XC=BASIC code did not compile with older versions.
===== Installation =====
- Go to the releases page: [[https://github.com/neilsf/XC-BASIC3/releases]].
- Under the latest version, find the Assets drop-down and download the zip file for your architecture (Windows, Linux or MacOS)
- Extract the zip file somewhere on your machine.
- The executable will be in the //bin/// directory.
- Don't move the executable out of its directory. If you want to launch it from somewhere else, use [[https://en.wikipedia.org/wiki/Symbolic_link|symbolic links]].
===== Usage =====
If you installed everything, you should be able to run the command:
''xcbasic3 --help''
The output contains all useful information on how to use the program. The most common usage is:
''xcbasic3 path/to/source.bas path/to/output.prg''
That's it. Continue to the next page to learn about the language.
<- start|Previous page ^ installation_and_usage|Installation and Usage ^ syntax|Next page ->