Long descriptive name of the second additional file:
First section
This file is supposed to contain any additional information that you wish to include in your documentation. You can note that all rules that apply to normal pasdoc descriptions apply also here, e.g. empty line means new paragraph:
New paragraph.
3rd paragraph. URLs are automatically recognized, like this: http://pasdoc.sourceforge.net/. You have to write the @ twice (like @@) to get one @ in the output. Also normal @-tags work: This is some code.
Second section
Here you can see some hot snippet from implementation of this feature, just to test @longcode tag:
procedure TPasDoc.HandleExtraFile(const FileName: string; out ExtraDescription: TExtraDescription); begin ExtraDescription := TExtraDescription.Create; try DoMessage(2, mtInformation, 'Now parsing file %s...', [FileName]); ExtraDescription.Name := SCharsReplace( ChangeFileExt( ExtractFileName(FileName) , ''), [' '], '_'); ExtraDescription.RawDescription := FileToString(FileName); except FreeAndNil(ExtraDescription); raise; end; end;
Third section
Normal links work : MyConstant.
Blah.
Blah.
Blah.
Blah.
Blah.
Blah.
Here is a paragraph with an anchor. It looks like a normal paragraph, but you can link to it with @link(SomeAnchor).
Blah.
Blah.
Blah.
Blah.
Blah.
Blah.
Blah.
Blah.
Blah.
Sections with the same user-visible names are OK (example when this is useful is below):
Routines dealing with strings
Overview
Examples
Routines dealing with integers
Overview
Examples
Author
Created
On some rainy day