Locations

You can see where pas2js searches for its cfg file and what it finds using the command line parameter -vt.

On Unix (Linux, MacOS, BSD) pas2js searches

• $HOME/.pas2js.cfg - note the dot at the beginning of .pas2js.cfg
• in the directory of the compiler binary. For example if pas2js is installed in /usr/lib/fpc/3.0.4/bin/pas2js, then it searches /usr/lib/fpc/3.0.4/bin/pas2js.cfg
• in /etc/pas2js.cfg

On Windows the compiler searches:

• %HOME%\pas2js.cfg
• in the directory of the compiler binary. For example if pas2js is installed in C:\pascal\pas2js\bin\pas2js, then it searches C:\pascal\pas2js\bin\pas2js.cfg

You can disable the search for the default config file using the parameter -n.

You can pass additional config files using the @ parameter. For example:

pas2js -n @/etc/pas2js.cfg

This will skip the default config file and parse /etc/pas2js.cfg.

Structure

• Leading spaces and tabs are skipped.
• Empty lines or lines only containing spaces are skipped
• Lines beginning with # followed by a space or tab are comment lines
• Lines beginning with #name are config directives:
  • #IFDEF define
  • #IFNDEF define
  • #IF expression - same as $if, except only defines
  • #ELSEIF
  • #ELSE
  • #ENDIF
  • #ERROR text
• Other lines are treated as single parameters. For example -FuFol der is the same as passing "-FuFol der" as command line parameter.
• Search paths (e.g. -Fu or -Fi) in config files are searched from top to bottom, while on the command line they are searched from right to left.
• For defines see Compiler directives

Macros

• $Pas2jsFullVersion - major.minor.release<extra>
• $Pas2jsVersion - major.minor.release
• $CfgDir - The directory of this config file
• $Env - environment variable, e.g. $Env(HOME)

You can see the supported macros running pas2js -h

Examples

Here is a typical pas2js.cfg file:

#
# Minimal config file for pas2js compiler
#
# -d is the same as #DEFINE
# -u is the same as #UNDEF
#
# Write always a nice logo ;)
-l

# Display Warnings, Notes and Hints
-vwnh
# If you don't want so much verbosity use
#-vw

# Allow C-operators
-Sc

#IFDEF FPC_SUBTARGET_NAMESPACED
-Fu$CfgDir/../../packages/*/*/namespaced
-Fi$CfgDir/../../packages/*/*/src
#else
-Fu$CfgDir/../../packages/*/*/src
#endif

# path to rtl.js
-Fu../../compiler/utils/pas2js/dist/

#IFDEF nodejs
-Jirtl.js
#ENDIF

# Put all generated JavaScript into one file
-Jc

# end.

Creating pas2js.cfg

When you built via make, it creates a pas2js.cfg in bin/$(TargetCPU)-$(TargetOS)/.

There is a tool to create a basic pas2js.cfg: tools/createconfig/createconfig

From the Free Pascal wiki, page "pas2js.cfg", as it stood on 2024-02-27 after a change by Mattias2, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's Licensing page. If you have concerns about this material, message the admin.