Uploaded image for project: 'Qt Creator'
  1. Qt Creator
  2. QTCREATORBUG-31067

Rewrap Pragraph in doxygen comment does not respect indenting scheme

    XMLWordPrintable

Details

    • Bug
    • Resolution: Unresolved
    • P3: Somewhat important
    • Qt Creator 9.0.0-beta1
    • Qt Creator 14.0.0-beta1
    • C/C++/Obj-C++ Support
    • None
    • Linux

    Description

      When rewrapping a paragraph in a C comment used to describe a function in doxygen style the indenting is broken.

      If you start with:

      Bar.cpp
      /**
        * @brief function is a function that calculates some result from the parameter d, but does not return the result
        *
        * @param d is the parameter that is used in calculation.
        */
      void function(double d);
      

      and you place your cursor in the line of "brief" and press CTRL+e,r you end up in:

      Bar.cpp
      /**
        *@brief function is a function that calculates some result from the parameter
        *d, but does not return the result
        *
        * @param d is the parameter that is used in calculation.
        */
      void function(double d); 

      That is not nice.

      You would expect

      Bar.cpp
      /**
        * @brief function is a function that calculates some result from the parameter
        * d, but does not return the result
        *
        * @param d is the parameter that is used in calculation.
        */
      void function(double d); 

      respecting the indenting.

      I would even like to see

      /**
        * @brief function is a function that calculates some result from the parameter
        *        d, but does not return the result
        *
        * @param d is the parameter that is used in calculation.
        */
      void function(double d); 

      Hint: If you select the whole interior part of the comment ( leaving out the line with /** and the line */ ) and press CTRL+e,r only the last line in rewrapped. Is this by intention?

      Attachments

        Issue Links

          No reviews matched the request. Check your Options in the drop-down menu of this sections header.

          Activity

            People

              kandeler Christian Kandeler
              moellney Michael Möllney
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

                Created:
                Updated:

                Gerrit Reviews

                  There are no open Gerrit changes