PBXB64 V15 - Installation and Quick Start
==========================================

Target: Windows 10 or Windows 11, x64


1. INSTALLATION
---------------

1. Extract the complete V15 ZIP archive to a writable directory, for example:

       C:\PBXB64\

2. Keep PBXB64.exe, the help files, Includes, c17_headers, and Examples together.

3. Before using a downloaded distribution, verify the Authenticode signature:

       Right-click PBXB64.exe
       Select Properties
       Open Digital Signatures
       Confirm that the signature is valid and the signer is Theo Gottwald

   Do not use a downloaded compiler if its expected signature is missing or
   invalid.

4. Optionally add the extracted directory to PATH.

No installer, registry changes, or separate compiler toolchain are required.


2. FIRST PB/BASIC PROGRAM
-------------------------

Create hello.pb:

    FUNCTION PBMAIN() AS LONG
        PRINT "Hello from PBXB64 V15!"
        PBMAIN = 0
    END FUNCTION

Compile and run:

    PBXB64 hello.pb -o hello.exe
    hello.exe


3. COMPILE SUPPLIED EXAMPLES
----------------------------

Examples are grouped by frontend:

    PBXB64 Examples\basic\01_getting_started\hello.bas -o basic_hello.exe
    PBXB64 Examples\b64\01_answer.b64 -o b64_answer.exe
    PBXB64 -std=c17 Examples\c\01_getting_started\hello.c -o c_hello.exe

See Examples\README.md for the available language and topic groups.


4. COMMON OPTIONS
-----------------

    PBXB64 [options] <input files>

    -o <file>                 Set output file
    -c                        Compile only and produce an object file
    -S                        Stop after code generation
    -fsyntax-only             Check syntax without generating code
    -E                        Preprocess C or PB/BASIC input
    -I <path>                 Add an include path
    -DNAME[=VALUE]            Define a preprocessor symbol
    -UNAME                    Undefine a preprocessor symbol
    -std=<mode>               Select C89, C99, C11, C17/C18, or GNU mode
    -O0, -O1, -O2, -O3       Select optimization level
    --entry <symbol>          Set the program entry symbol
    --version                 Display the compiler version
    --help                    Display all command-line options


5. HELP
-------

Open PBXB64_Help_EN.chm for English documentation or PBXB64_Help_DE.chm for
German documentation. Editor_Help.chm documents PBX-Editor.


6. SUPPORT
----------

E-mail: info@it-berater.org
Web:    https://smart-ai-robot.com

Copyright (c) 2026 Theo Gottwald.
