HelpNDoc 7.0 introduces a completely new script engine. It is still based on the Pascal language but some differences with previous versions are listed bellow. If upgrading from an earlier version, other modifications need to be applied: Migrating scripts and templates 

HelpNDoc v6

HelpNDoc v7

Remarks

var
  int1, int2: integer;
  str1, str2: string;

var
  int1, int2: integer;
var
  str1, str2: string;

Variables with different types must use the var keyword for each type

const
  int1, int2: integer;
  str1, str2: string;

const
  int1, int2: integer;
const
  str1, str2: string;

Constants with different types must use the var keyword for each type

SetLength(ARRAY_OR_STRING, NEW_LENGTH)

ARRAY_OR_STRING.SetLength(NEW_LENGTH)

The SetLength() method can't be used for arrays anymore

Print 'VALUE'

Print('VALUE')

The Print() method requires parenthesis

procedure proc1();
begin
  proc2();
end;
procedure proc2();
begin
end;

procedure proc2();
begin
end;
procedure proc1();
begin
  proc2();
end;

If a procedure calls another one, it must be declared before that method. Alternatively, proc2 can be declared before proc1 as a forward method: procedure proc2; forward;

HndGeneratorInfo.AssetsList: TStringList

HndGeneratorInfo.GetAssetsList(): TStringDynArray

Method return type has changed from TStringList to TStringDynArray

HndGeneratorInfo.GeneratedFiles: TStringList

HndGeneratorInfo.GetGeneratedFiles(): TStringDynArray

Method return type has changed from TStringList to TStringDynArray

HndBuildsEx.GetBuildByName(const aBuildName: string)

HndBuilds.GetBuildWithName(const aBuildName: string)

Method has moved to another object and has been renamed

Code only template files

Template files which only contains code must now encapsulate code within the <% and %> delimiters.

Frequent errors in custom templates

Here are some possible errors that you might see with custom templates after you upgrade. Refer to the table above to update custom templates and remove those errors:

  • [Error] aliases.pas.html(4, 5): Unknown name "nCurTopic"
  • [Error] context.pas.html(4, 5): Unknown name "nCurTopic"
  • [Error] keywords.pas.hhk(4, 2): Unknown name "nBlocLevel"
  • [Error] topics.pas.html(4,5): unknown name sDefaultTopicId