All Identifiers
Name | Unit | Description |
---|---|---|
Bar | ok_cdecl_external |
|
Bar | ok_directive_as_identifier |
|
BytePos | ok_complicated_record | enumeration used in variant record |
Cdecl | ok_directive_as_identifier |
|
ConvertDouble | ok_complicated_record |
|
EBar | ok_expanding_descriptions |
|
EFoo | ok_expanding_descriptions |
|
EFoo | ok_tag_params_no_parens |
|
EXyz | ok_expanding_descriptions |
|
Foo | ok_cdecl_external |
|
Foo | ok_directive_as_identifier |
|
Foo | ok_link_class_unit_level |
|
Foo | ok_paragraph_in_single_line_comment | This is the 1st paragraph. This is the 2nd paragraph. This is the 3rd paragraph. Here paragraphs are correct. |
Foo | warning_tags_no_parameters | Some tags are not allowed to have parameters. pasdoc should print a warning when you try to give some parameters for such tags: e.g. |
Foo1 | ok_directive_as_identifier | Some other test for THTMLDocGenerator.WriteCodeWithLinks, while I'm at it: Note that link to TMyClass should be correctly made. 'register' should be displayed as a string, of course, and not linked. |
MyConst | ok_deprecated_tag |
|
MyConst | ok_nodescription_printing |
|
MyOtherProc | ok_links_2 |
|
MyProc | ok_deprecated_tag |
|
MyProc | ok_links | Link to self : MyProc, and a second one: ok_links.MyProc, link to MyProc in other unit: ok_links_2.MyProc. |
MyProc | ok_links_2 |
|
MyProc | ok_link_explicite_name | Some testing proc. Have you seen my method ? |
MyProc | ok_nodescription_printing |
|
MyVar | ok_deprecated_tag |
|
MyVariable | ok_nodescription_printing |
|
PDoubleEndianCnvRec | ok_complicated_record |
|
RecursiveTwoAt | ok_expanding_descriptions | aa aaaaa aa aaa At some point, this test caused the bug: final </code> tag was inserted in converted form (processed with ConvertString) into html output. In effect, there was an opening <code> tag but there was no closing </code> tag. |
Register | ok_directive_as_identifier |
|
SomeProc | ok_tag_params_no_parens | Note that this rule allows you to not specify () for *any* tag that has parameters. Even for @link tag: ok_tag_params_no_parens This rule doesn't create any problems for tags without parameters, like the @name tag: here it is: Check out this longcode: begin Writeln('Hello world'); end; { This works ! }
See also @html and @latex tags: I'm red And here is some code:
|
SwapDoubleBytes | ok_complicated_record |
|
TAbstractTerminationClass | warning_abstract_termination | (This abstract tag lacks the closing parenthesis. How will PasDoc handle this error? |
TBar | ok_link_class_unit_level | These are links from class' description to an identifiers inside the same class. Note that @links here first check *inside* the class, then outside (i.e. in the whole unit). That's why link to Foo below is a link to a method Foo inside this class, not to a global procedure Foo. Links inside the class: Foo, Sthg. Links outside of the class: ok_link_class_unit_level.Foo, Xyz. Note that I has to qualify Foo with unit's name and write "ok_link_class_unit_level.Foo" to get a link to procedure in the unit. Just like I would do in a Pascal code. |
TClass1 | ok_nodescription_printing |
|
TDoubleEndianCnvRec | ok_complicated_record |
|
TestConstCombined | ok_hint_directives |
|
TestConstDeprecated | ok_hint_directives |
|
TestConstLibrary | ok_hint_directives |
|
TestConstPlatform | ok_hint_directives |
|
TestFuncCombined | ok_hint_directives |
|
TestFuncDeprecated | ok_hint_directives |
|
TestFuncPlatform | ok_hint_directives |
|
TestHtmlAndLatexTags | ok_expanding_descriptions | This is some dummy html code, just to show that inside @html tag of pasdoc (note that I used single @ char in this sentence) nothing is expanded by pasdoc. No paragraphs are created by pasdoc. (This text is still in the 1st, not in the 2nd, paragraph in html output) You must explicitly write <p> to get paragraph. No tags work, e.g. @link(TestLongCode).
Note that text inside @html / @latex tags is absolutely not touched by pasdoc. Characters are not escaped (< is *not* changed to < in the html case), @tags are not expanded, @ needs not to be doubled, paragraphs (<p> in the html case) are not inserted. |
TestLineBreak | ok_line_break | 1st paragraph. 2nd paragraph. Blah blah blah. 3rd paragraph. |
TestLongCode | ok_expanding_descriptions | Note that inside @longcode below I should be able to write singe @ char to get it in the output, no need to double it (like @@). No tags are expanded inside longcode. Also note that paragraphs are not expanded inside longcode (no <p> inside <pre>...</pre> in html output). Of course html characters are still correctly escaped (< changes to < etc.). procedure Foo; begin if A < B then Bar; { @link(No, this is not really pasdoc tag) } end; procedure Bar(X: Integer); begin CompareMem(@X, @Y); end; |
TestPasMethodTags | ok_expanding_descriptions | This is a test of tags expanded by TPasMethod handlers. Note that all three tags are expanded recursively.
|
TestProcCombined | ok_hint_directives |
|
TestProcDeprecated | ok_hint_directives |
|
TestProcPlatform | ok_hint_directives |
|
TestRecursiveTag | ok_expanding_descriptions | @code and @returns (and some others) tags are recursive, you can freely put other tags inside.
|
TestVarCombined | ok_hint_directives |
|
TestVarDeprecated | ok_hint_directives |
|
TestVarLibrary | ok_hint_directives |
|
TestVarPlatform | ok_hint_directives |
|
TestWarnings | warning_not_existing_tags | pasdoc should complain (display warnings) about wrong tags : @firstwarning(blah blah), |
TMyClass | ok_deprecated_tag | Deprecated class. |
TMyClass | ok_directive_as_identifier |
|
TMyClass | ok_expanding_descriptions | These are some tags that are not allowed to have parameters: name |
TMyClass | ok_value_member_tags |
|
TMyClass | warning_value_member_tags |
This should cause 3 warnings: MyField1 has two descriptions, MyField2 has two descriptions, and NotExistsingMember does not exist. |
TMyClassAncestor | ok_expanding_descriptions |
|
TMyEnum | ok_value_member_tags |
|
TMyEnum | warning_value_member_tags |
This should cause 3 warnings: meOne has two descriptions, meTwo has two descriptions, and meNotExisting does not exist. |
TMyRecord | ok_nodescription_printing |
|
TMyRecord | ok_value_member_tags |
|
TMyRecord2 | ok_nodescription_printing | This record has a description, but still LaTeX output will not list it in it's summary list (in the "Overview" section). (i.e. before applying my patch) |
TMyRecord3 | ok_nodescription_printing |
|
TMySimpleType | ok_nodescription_printing |
|
TMyType | ok_deprecated_tag | Normal type deprecated. |
TSomeClass | ok_links |
|
TSomeClass | ok_links_2 |
|
TSomeOtherClass | ok_links_2 |
|
TTestClassDeprecated | ok_hint_directives |
|
TTestingClass | ok_link_explicite_name | I'm a testing class, oh ! And don't forget to look at my method ! |
TTestRecordDeprecated | ok_hint_directives |
|
TwoAt | ok_expanding_descriptions | Write two at chars, like this @@, to get one @ in output. E.g. @ link(TSomeClass). E.g. @link(TSomeClass). E.g. @html foobar. E.g. @link . |
Xyz | ok_cdecl_external |
|
Xyz | ok_link_class_unit_level |
|