README

Welcome to pas2js

Pas2js is an open source Pascal to JavaScript transpiler. It parses Object Pascal and emits JavaScript.

Official site: [http://wiki.freepascal.org/pas2js](http://wiki.freepascal.org/pas2js)

Directories

• packages - source files needed to compile pas2js programs
• demo - examples
• bin - output folder for binaries, e.g. pas2js.exe
• compiler - source files to compile the compiler. This is an external submodule link.
• units - output folder of compiler ppu/o files
• utils - utilities

Building

Compiler

You need to install the Free Pascal compiler (fpc), 3.2.0 or better, 32 or 64bit. Either from their website

https://www.freepascal.org/download.html

Or via Lazarus

http://wiki.freepascal.org/Getting_Lazarus

Or on MacOS via homebrew. On Linux this can be done via your package manager as well if it has the latest version.

building pas2js

Complete checkout

The makefile expects the sources of FPC to be present under the compiler directory. You can copy/clone the FPC sources there, or make a symlink to the FPC sources.

The git repository contains a submodule link to the FPC sources. You can use this to have an automatically correct version of fpc. This is useful for the fixes and release branches, as they automatically get the tested combination of pas2js and fpc sources.

When you do a git clone, make sure you also specify the --recurse-submodules option:

git clone --recurse-submodules https://gitlab.com/freepascal.org/fpc/pas2js.git

If you didn't do this, issue the init and update commands:

git submodule update --init --recursive

This will have the same effect as when you do a --recurse-submodules.

After doing a git pull or a git switch, you must also update the submodule:

git pull
git submodule update --init --recursive

This will pull any upstream changes to your local FPC repository.

TortoiseGit

To update the submodule 'compiler' do the following: In the Git Synchronization dialog, after the "Pull", click on the "Submodule Update" button.

Under Linux/macOS

type the following command:

make all

This creates with a 64-bit fpc the executable bin/x86_64-linux/pas2js and a basic config file bin/x86_64-linux/pas2js.cfg.

Under Windows

Make sure that you use the make.exe from fpc, not the one from Delphi by setting the PATH: For example if you installed the 32-bit version of fpc in C:\YourPathOfFPC\3.2.0:

set PATH=C:\YourPathOfFPC\3.0.4\bin\i386-win32;%PATH%

If you installed the 64-bit version of fpc in C:\YourPathOfFPC\3.2.0 use

set PATH=C:\YourPathOfFPC\3.0.4\bin\x86-64-win64;%PATH%

Then compile make all

If you see "Error makefile ... Command syntax error" your "set PATH" was not correct.

When make all has succesfully finished it created with a 32-bit fpc the executable bin/i386-win32/pas2js.exe and a basic config file bin/i386-win32/pas2js.cfg.

Configuration

pas2js requires unit search paths (-Fu) in order to find its rtl units and rtl.js. Building and installing should have created a default pas2js.cfg containing those parameters.

[http://wiki.freepascal.org/pas2js.cfg](https://github.com/fpc/pas2js/blob/HEAD/[http:/wiki.freepascal.org/pas2js.cfg])