[wit-parser] Don't trim leading/trailing whitespace from lines in doc comments

[mjoerussell]

Trimming whitespace in doc comment lines could break custom formatting when reading and/or copying docs from .wit files.

For example, using jco to generate Typescript definitions, we want to copy the documentation directly from .wit to .d.ts. However, a doc comment like this will be altered after parsing:

/// Some documentation:
///     - With indentation

/**
 * Some documentation
 * - With indentation
 */

[alexcrichton]

Could you try rebasing on main and re-BLESS-ing tests to remove some of these changes?

[alexcrichton]

Thanks for this! One thing I might recommend is to flesh out this trimming of whitespace more than what's already there. You're right that the current implementation is buggy but ideally this wouldn't pick up the whitespace from the comment itself (e.g. the leading space). The way I know I've dealt with this in the past with rustdoc is to collect the documentation block, calculating the longest longest amount of whitespace shared amongst all lines, and then drop that. That would, for example, drop the leading space here.

[mjoerussell]

The way I know I've dealt with this in the past with rustdoc is to collect the documentation block, calculating the longest longest amount of whitespace shared amongst all lines, and then drop that. That would, for example, drop the leading space here.

Sounds good, I wasn't sure if this was an issue for the project in the first place or what behavior would be a good replacement so I wanted to keep the changes minimal to start.

[alexcrichton]

Sounds good, and yeah no worries! I think some git mishaps may have happened during the rebase though?

[mjoerussell]

I think some git mishaps may have happened during the rebase though?

Yeah sorry about that, I think I rebased and pushed using --force-with-lease by mistake. Should be fixed now.