OraOpenSource / plsql-md-doc

Converts PL/SQL JavaDoc documentation to markdown
MIT License
51 stars 16 forks source link

@var/constant/type tag problem #61

Closed ArtjomsBrovkins closed 7 years ago

ArtjomsBrovkins commented 7 years ago

There is a problem with @var/constant/type tags. They are working only in one scenario - if they are grouped together by tag name.

For example:

  /**
   * @type g_table_type       A test table type
   * @type g_table_type2       A test table type
   */

will work, but this won't work as expected:

  /**
   * @type g_table_type       A test table type
   */
   type g_table_type is table of pls_integer index by varchar2(30);
   /**
   * @type g_table_type2       A test table type
   */
   type g_table_type2 is table of pls_integer index by varchar2(30);

Same situation is with variables and constants. Variables and constants are not so critical, but type definitions may be quite large, so logically, header comment should be above the type it refers to.

ArtjomsBrovkins commented 7 years ago

Fixed in merge request #60