Thank you so much!

This should have been fixed in e1ea5a0 now :) Can you try, please?

from javadoc-to-markdown.

I just tested this, the result is:

Documentation

public void method1(int i)

• Parameters: i — single line description

public void method2(int i)

• Parameters: i — line1

  line2

I'm not certain that is exactly what should be expected. I believe it should result in:

Documentation

public void method1(int i)

• Parameters: i — single line description

public void method2(int i)

• Parameters: i — line1 line2

Or something similar.

from javadoc-to-markdown.

@elifoster Thanks, that looks good! I understand that you might prefer another way of formatting the output, but your test proved that our fix to @sfrenkiel's original problem works correctly.

Personally, I prefer

line1

line2

to

line1 line2

for multi-line descriptions where the first version preserves the formatting from the source. You seem to disagree here, however. Do you have some example where your formatting makes more sense? Thank you!

from javadoc-to-markdown.

If the description happens to span multiple lines due to length, that is how it would be formatted in te source. Likewise with method descriptions and class descriptions which j2md already handles this way. That line break should be added for <br>s and line gaps.

For example

/**
 * @param a This method parameter is slightly complicated, and
 *         as such it spans multiple lines.
 */

would be expected to be a single line in the resulting markdown.

from javadoc-to-markdown.

You're right, thanks!

What about the following way of formatting the output?

Becomes single-line description in Markdown:

/**
 * @param a This method parameter is slightly complicated, and
 *          as such it spans multiple lines.
 */

Becomes multi-line description in Markdown:

/**
 * @param a This method parameter is slightly complicated, and
 *
 *          as such it spans multiple lines.
 */

/**
 * @param a This method parameter is slightly complicated, and
 *          <br>
 *          as such it spans multiple lines.
 */

/**
 * @param a This method parameter is slightly complicated, and
 *          <p>
 *          as such it spans multiple lines.
 */

from javadoc-to-markdown.

Yes that would be more consistent.

from javadoc-to-markdown.