Soft wrapping for comments

[little-dude]

It seems that rusfmt wants comment lines to fit into 80 characters. To enforce that, it currently does hard wrapping whereas for comments, soft wrapping looks just nicer.

Example:

//! Terminal formatting library.
//!
//! This crate provides the `Terminal` trait, which abstracts over an [ANSI
//! Terminal][ansi] to provide color printing, among other things. There are two implementations,
//! the `TerminfoTerminal`, which uses control characters from a
//! [terminfo][ti] database, and `WinConsole`, which uses the [Win32 Console
//! API][win].
//!
//! # Examples

Becomes:

//! Terminal formatting library.
//!
//! This crate provides the `Terminal` trait, which abstracts over an [ANSI
//! Terminal][ansi] to provide color printing, among other things. There are
//! two implementations,
//! the `TerminfoTerminal`, which uses control characters from a
//! [terminfo][ti] database, and `WinConsole`, which uses the [Win32 Console
//! API][win].
//!
//! # Examples

Instead of:

//! Terminal formatting library.
//!
//! This crate provides the `Terminal` trait, which abstracts over an [ANSI
//! Terminal][ansi] to provide color printing, among other things. There are two
//! implementations, the `TerminfoTerminal`, which uses control characters from
//! a [terminfo][ti] database, and `WinConsole`, which uses the [Win32 Console
//! API][win].
//!
//! # Examples

[ustulation]

bump - running into this too. Is this going to land anytime soon or is it not a priority for long time ?

[nrc]

The plan is that we'll probably turn off formatting of comments altogether. I expect that to happen soon-ish. At the moment I'm concentrating on the formatting RFC process to try and establish default styles rather than Rustfmt, so development is likely to be slow, sorry.

[gnzlbg]

This is still a pain. I want formatting of comments, but for example with max_width = 80 this:

/// Compare the lowest `f32` of both inputs for greater than or equal. The
/// lowest 32 bits of the result will be `0xffffffff` if `a.extract(0)` is
/// greater than or equal `b.extract(0)`, or `0` otherwise. The upper 96 bits of
/// the result are the upper 96 bits of `a`.

gets formatted into:

/// Compare the lowest `f32` of both inputs for greater than or equal. The
/// lowest 32 bits of the result will be `0xffffffff` if `a.extract(0)` is
/// greater than or equal `b.extract(0)`, or `0` otherwise. The upper 96 bits 
/// of
/// the result are the upper 96 bits of `a`.

IMO rustfmt needs to be able to reformat comments, doing soft-wrapping, and handling long URLs so that they can still be displayed by rustdoc.