nuBASIC 2.0 - prebuilt Windows binaries (ARM64)
===============================================

This folder contains ready-to-run nuBASIC executables for a Windows-on-ARM
PC (ARM64 - e.g. Snapdragon / Copilot+ PCs). They are STATICALLY LINKED, so
there is NOTHING TO INSTALL - no Visual C++ Redistributable, no admin rights.
Just unzip anywhere and run.

  >>> For a normal Intel/AMD PC, use the x64 package instead - these ARM64
      files will not run natively on it. <<<


What's in here
--------------
  nubasic.exe        The interpreter / interactive prompt (REPL). Run .bas
                     programs from a terminal:  nubasic.exe myprogram.bas
  nubasicgdi.exe     Same interpreter but opens a graphics window (for
                     programs that draw, or use the WinRaycast engine).
  nubasicdebug.exe   Debug backend used by the VS Code extension. You don't
                     run this directly.
  NuBasicIDE.exe     The desktop IDE (editor + debugger). Just double-click it.
  SciLexer.dll       Required by NuBasicIDE.exe - keep it in the same folder.


Quick start
-----------
  Option A - the IDE:
    Double-click NuBasicIDE.exe, open or type a program, press the Run button.

  Option B - the command line:
    Open a terminal (PowerShell or cmd) in this folder and run:
        .\nubasic.exe myprogram.bas
    Or start the interactive prompt with no arguments:
        .\nubasic.exe


IMPORTANT: save .bas files as "UTF-8 without BOM"
-------------------------------------------------
If you create a .bas file in Notepad with the default "UTF-8" (which adds a
hidden BOM marker) you will get:

    Runtime Error #4 ... print procedure not defined

...on the very first line. Fix: save as UTF-8 WITHOUT BOM.
  - Notepad:  Save As -> Encoding -> "UTF-8"  (NOT "UTF-8 with BOM")
  - VS Code:  click the encoding in the bottom-right -> Save with Encoding
              -> "UTF-8" (not "UTF-8 with BOM")


Optional: VS Code extension
---------------------------
nuBASIC has a VS Code extension (syntax highlighting + F5 debugger). After
installing it, point it at the nubasic.exe in this folder via the setting:
    "nubasic.executablePath": "<full path to nubasic.exe in this folder>"
The extension finds nubasicdebug.exe next to it automatically.


Building it yourself / full details
-----------------------------------
See docs/windows-build-from-scratch.md in the nuBASIC source repository:
    https://github.com/eantcal/nubasic

License: MIT.
