Thank you for the report. Indeed I can reproduce the problem with latest PasDoc. We don't use SourceForge bugtracker anymore, we now use GitHub issue tracker on https://github.com/pasdoc/pasdoc/issues/ . I have added an issue, with a copy of your description and a testcase, to https://github.com/pasdoc/pasdoc/issues/92 (you can registeron GitHub and "Subscribe" to that issue).
Cannot place pasdoc comment after a statement
I agree, @link(Two.a) should also work eventually :)
Since the link tag can link to fields, should it not also be able to link to fields of nested records (which are essentially fields of the parent record, but with a hierarchical name)? Only having to write the name of the field would make the documentation far easier to maintain. I'd agree the two cases you've shown in your class testcase look like bugs.
That would be an awesome feature, thanks.
I would prefer to fix it with @excludeBegin and @excludeEnd options, already planned. They cover more use-cases, and also would satisfy this one. You would be able to write e.g. { @excludeBegin } {$I myinclude.inc} { @excludeEnd } to have everything inside your include file ignored. You could also place the @excludeBegin/End inside the myinclude.inc file.
The @link should lead to @link(TRecord2.a), not @link(Two.a). In order to link to TRecord2.a but show it as Two.a, you can write @link(TRecord2.a Two.a), see https://github.com/pasdoc/pasdoc/wiki/LinkTag . That said, indeed it isn't working with the nested record as it should. I'm attaching a testcase I made, based on your code, and indeed it uncovers two situations that don't work as they should. The problem is most likely in PasDoc's TPasItem.FindNameWithinUnit method -- it's way too simple :),...
Follow nested record types
Ignore entire .inc files
Simplify exception catching, exit with non-zero status (by Michalis Kamburelis)
Testcase for @param and @raises on properties (by Michalis Kamburelis)
Mention tests upgrades (by Michalis Kamburelis)
improve build time testing
All done:) AD 2 ("shipping of the reference files in the pasdoc package") - The correct tests output is now trivially kept inside our code repository (GIT on https://github.com/pasdoc/pasdoc , auto-synchronized with SVN repository on SourceForge). In tests/testcases_output/, documented in tests/README.md, see https://github.com/pasdoc/pasdoc/tree/master/tests . It was more critical now, as SourceForge doesn't allow creating shells anymore, which was breaking our "upload_correct_tests_output.sh" script....
Keep testcases_output inside GIT repository (by Michalis Kamburelis)
ChangeLog update (by Michalis Kamburelis)
Update links to PasDoc wiki and aspell.net (by Michalis Kamburelis)
Show visibility inside records too (by Michalis Kamburelis)
Add de.utf8 language: German in UTF-8 encoding (by Michalis Kamburelis)
Fix section title (by Michalis Kamburelis)
PasDoc 0.15.0 released
PasDoc 0.15.0 released
PasDoc 0.15.0 released
"make tag" helper command (by Michalis Kamburelis)
Error with Class Operators
Closing, this was fixed long time ago. PasDoc can parse this: unit A; interface type TMyRecord = record class operator Add(p1,p2:TMyPoint):TMyPoint; end; implementation // ... end. Sorry for not notifying about it earlier!
Closing, this was fixed long time ago. PasDoc can parse this: unit A; interface type TMyRecord = record class operator Add(p1,p2:TMyPoint):TMyPoint; end; implementation end. Sorry for not notifying about it earlier!
Closing, this was fixed long time ago: unit A; interface type TMyRecord = record class operator Add(p1,p2:TMyPoint):TMyPoint; end; implementation end. Sorry for not notifying about it earlier!
Include files
Closing -- not a bug in PasDoc, we do not parse include files indeed:)
Fix Markdown more (by Michalis Kamburelis)
tests/README.md using Markdown (by Michalis Kamburelis)
Remove BrowserCommand from delphi_gui (by Michalis Kamburelis)
Parse "experimental" hint directive (by Michalis Kamburelis)
Fix <param> in Help Insight (more higher, simplify) (by Michalis Kamburelis)
Snapshots: fix dirs (by Michalis Kamburelis)
Simpler pasdoc_snapshot, it is now run by Jenkins (by Michalis Kamburelis)
Fix snapshot taking (by Michalis Kamburelis)
New /usr/local/fpclazarus/setup.sh location (by Michalis Kamburelis)
Better log of snapshots (by Michalis Kamburelis)
Setup default FPC for snapshots (by Michalis Kamburelis)
Mention in ChangeLog links to enum members (by ...
More natural option names for comment markers (...
Mention Tipue search improvements (by Michalis ...
Load Tipue JS (including tipuesearch_data.js) o...
Remove trailing whitespace (by Michalis Kambure...
Implement --html-head, --html-body-begin, --htm...
Adjust to HTML5: anchors using id=, style <hr> ...
Temp directory per-user (by Michalis Kamburelis)
Fix packing release (by Michalis Kamburelis)
Merge pull request #5 from zekiguven/master (by...
Change links michaliskambi/pasdoc -> pasdoc/pas...
Change all links, to GitHub wiki / pasdoc.sourc...
Rename docs/ to old_docs/, to not confuse. (by ...
It seems that chgrp on SF is no longer possible...
Shorten and update a bit packages/README.txt (b...
delphi xe8 package
Thank you! Committed, to source/packages/delphi/XE8/ .
Thank you very much, committed! Inside source/packages/delphi/ .
delphi xe7 package
Added <see cref> tag.
Thank you, applied!
delphi xe8 package
res file
project file
delphi xe7 package
Added <see cref> tag.
Show 'class property', fix showing 'classvar' a...
Fix FormatLongCode in case the comment is not f...
gitignore some tests temp subdirs (by Michalis ...
Merge pull request #4 from silvioprog/master (b...
Merge pull request #3 from silvioprog/master (b...
Use RemoveIndentation also for @preformatted (b...
Mention @preformatted improvement in changelog ...
Fix compilation (Spanish translation had extra ...
Updated Spanish (Spain) translation by Guillerm...
Spanish translation
Terribly sorry for taking so long to apply this. Applied now, all is OK. I also updated...
Adjust copyright to be ..-2016 (by Michalis Kam...
Me again. I've attached a DIFF file.
Spanish translation
Thank you for your corrections. I tested successfully the precompiled version. Yes,...
Word "record" not translated
I fixed translating the "record" to the correct localized string (that may start...
Git doesn't support $Date$, just remove "@cvs($...
Use trRecord, add trPacked, improve French tran...
Sorry, that wasn't the good picture.
Sorry, this wasn't the good picture.
Word "record" not translated
Support <exclude/> in Help Insight, by kosovali...
Applied, thank you! (Sorry for delay, busy week and weekend:)
Added <exclude/> tag.
Added <exclude/> tag.
Cool, patch applied, thank you!
Added <para> and <br /> tags.
Support <para> and <br /> in Help Insight, by k...
Yes, you are right.