Thrift
  1. Thrift
  2. THRIFT-681

The HTML generator does not handle JavaDoc style comments very well

    Details

    • Type: Improvement Improvement
    • Status: Closed
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 0.2
    • Fix Version/s: 0.9
    • Component/s: Compiler (General)
    • Labels:
      None

      Description

      If you create comments using the standard JavaDoc conventions of @param and @exception, the output that gets generated isn't the cleanest. It would be better if the list of parameters and exceptions were placed in a table with the appropriate headers rather than just outputting the @param and @exception tags into the HTML output.

      1. thrift-682-v2.patch
        1 kB
        Bryan Duxbury
      2. thrift-681-inline-parameter-doc-generation.png
        24 kB
        Kevin Burnett
      3. thrift-681-inline-parameter-doc-generation.patch
        24 kB
        Kevin Burnett
      4. t_html_generator_JavaDoc.v2.patch
        8 kB
        Adrian Muraru
      5. t_html_generator_JavaDoc.patch
        7 kB
        John Bartak
      6. screenshot-1.jpg
        84 kB
        John Bartak
      7. Screenshot.png
        30 kB
        Adrian Muraru

        Activity

          People

          • Assignee:
            Kevin Burnett
            Reporter:
            John Bartak
          • Votes:
            2 Vote for this issue
            Watchers:
            5 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development