Warning
You're browsing the old v2.x documentation. This version is no longer maintained. Click here to go the v3.x documentation.
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
usage [2019/09/02 08:06] – [Usage in GUI] neils | usage [2020/02/20 09:52] – [Step 1: install DASM] neils | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Usage ====== | ====== Usage ====== | ||
- | ===== Usage in GUI ===== | + | //Note: the bellow guide applies to versions 2.3 or later. If you're looking for the older usage guide, please read the [[https:// |
- | The recommended application to edit and compile **XC=BASIC** programs is [[https:// | + | ===== Installation ===== |
- | {{ :z5suv1.png?direct |}} | + | Before getting started, have a look at this figure to understand how **XC=BASIC** source files are compiled to C64 executable programs. There are two steps involved. First, the **xcbasic64** compiler compiles the .bas source file to an intermediate assembly source. Then **DASM** is kicked in and it assembles the intermediate source file to program file. |
- | ===== Command line usage ===== | + | {{ :: |
- | Since version | + | ==== Step 1: install |
- | Usage in Windows: | + | * Go to [[https:// |
+ | * Extract the package to a location that you'll remember | ||
+ | * On Linux, you have to add the executable permission: '' | ||
+ | * Recommended: | ||
- | xcb.bat source.bas target.prg | + | ==== Step 2: install xcbasic64 ==== |
- | + | ||
- | Usage in Linux: | + | |
- | ./xcb source.bas target.prg | + | * Go to [[https:// |
- | + | * Extract the package to a location that you'll remember | |
- | Usage in macOS: | + | * Recommended: add the executable to the PATH environment variable (see above). |
- | ./xcbmac source.bas target.prg | + | ===== Usage ===== |
- | + | ||
- | That's all you have to use in most of the cases. However, you can still use the binaries in the '' | + | |
- | The command line usage of the binarry is: | + | You can now invoke xcbasic64 from the command line as follows: |
- | xcbasic64 source.bas | + | |
- | + | ||
- | You can omit the output redirection if you just want to see the result on the screen. | + | |
- | The target then can be compiled using DASM: | + | The following command line options |
- | dasm target.asm | ||
- | |||
- | Or using a singe line command: | ||
- | xcbasic64 source.bas > target.asm && dasm target.asm | ||
+ | | '' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||
+ | |'' | ||