Parser improvements

Some things that must be improved in pasdoc parser (PasDoc_Parser.pas), to make it better understand the source code it's reading:

• ParseProperty: Parser must be able to understand where are property read and write specifiers names, to avoid including private specifier names in documentation (see Michalis' mail on pasdoc-main MailingList "Full declaration of properties is shown" on 2005-05-29)

• ParseFieldsVariables and ParseRecordCase: Parser must be improved to better understand record fields in records "case clauses" and to understand "records in records", to close pasdoc bug 1199354 completely.

• ParseCDFP: parser must be improved to know what are the names of procedure's parameters, to check names and order of parameters in @param tag.

See also WantedFeaturesParsingImplementation.

Things to look at:

• Anonymous reader suggested to look at JEDI CodeFormat:

  • JEDI CodeFormat has a very good parser implementation for Delphi. This parser would make it easy to include implementation comments in documentation.