pas2js.cfg

From Free Pascal wiki
Jump to navigationJump to search

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:

  • 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 paramater -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 macroname
    • #IFNDEF macroname
    • #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.

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:

  1. Minimal config file for pas2js compiler
  2. -d is the same as #DEFINE
  3. -u is the same as #UNDEF
  4. Write always a nice logo ;)

-l

  1. Display Warnings, Notes and Hints

-vwnh

  1. If you don't want so much verbosity use
  2. -vw

-Fu$CfgDir/../../packages/* -Fu$CfgDir/../../compiler/utils/pas2js/dist/

  1. IFDEF nodejs

-Jirtl.js

  1. ENDIF
  1. Put all generated JavaScript into one file

-Jc

  1. end.