contents

pim_test Parser test program

'pim_test' parses the given source file and lists the derivation tree on stdout. The source file must be conform with the language parameter. It uses the image files of the parser and scanner tables, [Language.lim] and [Language.pim].

In case you specify a start symbol the parsing process starts from this nonterminal, provided it is defined in [Language.sty]. By default the parser takes the first start nonterminal.

Arguments

Name	Type	Semantic
Language	name	language name
FileName	path	path of source file to scan

Options

An option will be specified as follows: -<Name>=<Value>
A flag is toggled that way: -<Name>
The default value will be applied when the option wasn't specified.

Name	Type	Default value	Semantic
charset	string	""	source file character set ( UTF-8, UCS4, ... )
skipset	string	""	( ascii ) characters to be skipped
lookahead	flag	false	enable n character lookahead
binmode	flag	false	scan source file in binary mode ( not with charset-option )
wprint	flag	false	unicode / UTF-8 output ( on non-default character set )
prepar	string	""	standard preprocessing: yes or list index~value , ...
premac	string	""	standard preprocessing: pre-defined macro , ...
prefun	string	""	user-defined preprocessing: Function@Library ( not with prepar-option )
Start	string	""	start symbol
xaron	flag	false	create a derivation tree ( lisp like representation )
early	flag	false	use early reduction
shiftfun	string	""	user-defined token conversion: Function@Library ( see [ptm_gen] )
reducefun	string	""	user-defined nonterminal conversion: Function@Library ( see [ptm_gen] )
tree	flag	true	create a derivation tree

The options 'prepar' and 'premac' are only useful with styx-like preprocessing.

If your language uses the same preprocessing directives as specified in [styx.sty], but differnt macro token identifiers and keywords, the option 'prepar' can be used to enable preprocessing and specify the differences as a comma separated list:

0~name of identifier token
1~name of macro definition token
2~name of argument separator token
3~name of include token
4~name of conditional token
5~name of undefine token
6~#macro keyword
7~#end keyword
8~#ifdef keyword
9~#ifndef keyword
10~#else keyword
11~#include keyword
12~#undefine keyword
13~environment variable or path list as search path for include files
14~include file character set ( default: charset-option )

The option 'premac' supports pre-defined macros in connection with styx-like preprocessing.

Dynamic library support is a prerequisite for the user-defined callback handler.

Environment

An environment variable will be specified as follows: -<Name>=<Value>
The default value will be applied when no environment variable was specified.

Name	Type	Default value	Semantic
BINSTYX	path	PATH	search environment for [Language.pim] and [Language.lim]