8.8.2 The ptop conguration le

Creating and distributing a conguration le for ptop is not necesarry, unless you want to modify the standard behaviour of ptop. The conguration le is never preloaded, so if you want to use it you should always specify it with a -c ptop.cfg parameter.

The structure of a ptop conguration le is a simple buildingblock repeated several (20-30) times, for each pascal keyword known to the ptop program. (see the default conguration le or ptopu.pp source to nd out which keywords are known)

The basic building block of the conguration le consists out of one or two lines, describing how ptop should react on a certain keyword. First a line without square brackets with the following format:

keyword=option1,option2,option3,...

If one of the options is "dindonkey" (see further below), a second line (with square brackets) is needed like this:

[keyword]=otherkeyword1,otherkeyword2,otherkeyword3,...

As you can see the block contains two types of identiers, keywords(keyword and otherkeyword1..3 in above example) and options, (option1..3 above).

Keywords are the built-in valid Pascal structure-identiers like BEGIN, END, CASE, IF, THEN, ELSE, IMPLEMENTATION. The default conguration le lists most of these.

Besides the real Pascal keywords, some other codewords are used for operators and comment expressions. table (8.1)

The Options codewords dene actions to be taken when the keyword before the equal sign is found, table (8.2)

The option "dindonkey" requires some extra parameters, which are set by a second line for that option (the one with the square brackets), which is therefore is only needed if the options contain "dinkdonkey" (contraction of de-indent on assiociated keyword).

"dinkdonkey" deindents if any of the keywords specied by the extra options of the square-bracket line is found.

Example: The lines

mean the following:

• The keyword this block is about is else because it's on the LEFT side of both equal signs.
• The option crbefore signals not to allow other code (so just spaces) before the ELSE keyword on the same line.
• The option dindonkey de-indents if the parser nds any of the keywords in the square brackets line (if,then,else)
• The option inbytab means indent by a tab.
• The option upper uppercase the keyword (else or Else becomes ELSE)

Try to play with the congle step by step until you nd the eect you desire. The congurability and possibilities of ptop are quite large. E.g. I like all keywords uppercased instead of capitalized, so I replaced all capital keywords in the default le by upper.

ptop is still development software, so it is wise to visually check the generated source and try to compile it, to see if ptop hasn't made any errors.