Process line breaks in description about argh HOT 5 OPEN

Can be one of
* A
* B
* C

There are many things
this can be including A,
B and C.

This bit is prose and should
be wrapped into a paragraph.

But this is another paragraph so there
should be a new line between
them.

1. A list would work as expected.
3. Even with long
   entries like this though they
   won't be wrapped nicely.

| Tables | Should |
|------|------|
| Also be | Fine |

fn parse_comment(lines: &[&str]) -> String {
    let mut out = String::new();
    for line in lines {
        let line_starts_with_letter = line.bytes().next().map(|c| c.is_ascii_alphabetic()).unwrap_or(false);
        if line_starts_with_letter {
            if !out.is_empty() {
                if out.ends_with('\n') {
                    out.push('\n');
                } else {
                    out.push(' ');
                }
            }
        } else {
            out.push('\n');
        }
        
        out.push_str(line);
    }
    out
}

fn main() {
    let comment = "This bit is prose and should
be wrapped into a paragraph.

But this is another paragraph so there
should be a new line between
them.

1. A list would work as expected.
3. Even with long
   entries like this though they
   won't be wrapped nicely.

| Tables | Should |
|------|------|
| Also be | Fine |";

    let description = parse_comment(&comment.lines().collect::<Vec<_>>());
    
    println!("{}", description);
}

This bit is prose and should be wrapped into a paragraph.

But this is another paragraph so there should be a new line between them.

1. A list would work as expected.
3. Even with long
   entries like this though they
   won't be wrapped nicely.

| Tables | Should |
|------|------|
| Also be | Fine |

    for line in cmd.description.lines() {
        let mut words = line.split(' ').peekable();
        while let Some(first_word) = words.next() {
            indent_description(&mut current_line);
            current_line.push_str(first_word);
    
            while let Some(&word) = words.peek() {
                if (char_len(&current_line) + char_len(word) + 1) > WRAP_WIDTH {
                    new_line(&mut current_line, out);
                    break;
                } else {
                    // advance the iterator
                    let _ = words.next();
                    current_line.push(' ');
                    current_line.push_str(word);
                }
            }
        } 
        new_line(&mut current_line, out);
    }

  target            This bit is prose and should be wrapped into a paragraph.
                    
                    But this is another paragraph so there should be a new line
                    between them.
                    
                    1. A list would work as expected.
                    3. Even with long
                       entries like this though they
                       won't be wrapped nicely.
                    
                    | Tables | Should |
                    |------|------|
                    | Also be | Fine |

[patch.crates-io]
argh = { git = "https://github.com/Timmmm/argh", branch = "multiline_docs" }