Change:
/// ``` #[stable(feature = "rust1", since = "1.0.0")] pub fn with_capacity(cap: usize, inner: W) -> LineWriter<W> { <del> LineWriter { inner: BufWriter::with_capacity(cap, inner) } </del> <ins> LineWriter { inner: BufWriter::with_capacity(cap, inner), need_flush: false, } </ins> } /// Gets a reference to the underlying writer.

Discussion:
Try piping this program's stdout to . After the first 10 lines, will exit. The pipe is now broken, so the next write should fail, and we should get Instead, the Rust program keeps running indefinitely. GDB says is "received" (but I guess ignored) by the process every time it tries to write. Feels like a race condition: if you remove the or just change it to be short, panics as expected. tested on Linux,
I believe what's happening here is in because the underlying primitive is buffered (e.g. ) but then when is next called we and return that the bytes were written. If you let the program run long enough the buffer fills up and the error gets propagated through a call to I believe. Seems kinda weird to me to ignore that error, we should probably do something like this instead: That is, propagate an error in flush if we wrote the entire line.
Well... maybe not. So apparently this behavior changed in to fix cc thoughts?
Interesting. The new code doesn't satisfy the "write-xor-error guarantee" either, though. It does up to three operations on the underlying , so of course the first can succeed and others can then fail. For example, could write successfully all the way through, then fail trying to write the rest. Maybe the guarantee should be weakened to a reasonable-effort sort of thing. It's important in some systems-y cases where the user knows the type of the writer (e.g. a raw being used as a transaction log). It doesn't seem valuable more generally, and I'd expect third-party impls of to break it more often than not.
This also interacts with the which indicates That's probably just an erroneous clause targeted at, for example, file descriptors. With buffered readers and writers (like a line writer) I think we fundamentally just can't uphold that guarantee. Nominating for discussion as I think we'll want to reword that documentation.
In some cases, 's caller is counting on the fact that an error means no bytes were written. For example, if an operation returns , the caller needs to know where to pick up writing again. An abstract interface can't reasonably guarantee that any specific downstream source has received and acknowledged the data.

On Unix, even if you do a system call and it succeeds, the kernel might still be buffering the data, so you don't know if it's made it to disk or not. You have to do an to find out whether it really made it. But an abstract interface can and should be expected to let its user keep track of where it needs to continue its work, in the case of an intermittent error condition like .
That clause is actually pretty important. Otherwise, you can't be sure of the state of a writer after it returns an error. For example, the following could would write "abc" twice if interrupted: When I wrote that patch, I was thinking that the next write after a failed flush would error out but obviously didn't think it though. So, a simple fix would be to record that a flush didn't happen and try to flush before writing anything else (i.e., on the next call to write). Unfortunately, this does mean that writing a newline wouldn't guarantee a flush but I don't think there's much we can do about that at this point. I believe a error was discussed in the past but was rejected as it would make larger. Alternatively, as we haven't actually written anything to the underlying file yet, could just "undo" the write (either by reaching into or re-implementing ).
yeah it's definitely true that it's useful to have this guarantee, and it may just not be possible to relax the guarantee. yeah on second though retrying the flush on the next sounds like it'd be a good idea (at least for now). I think that we'll need to update no matter what b/c the successfully written bytes are papered over with an error I think if the second write fails, right?
My point is to flush before doing anything else if the previous flush-on-newline failed. Only then do we write iff that flush succeeds. If the flush fails, return an error without writing anything (no papering over written bytes). However, the previously written bytes will not have been flushed so the documentation needs to be updated to say that we try to flush on newline but that flush may fail silently in some cases (and that the user should call to be absolutely sure).
yeah that sounds good to me!
Since and are friends, I think it's possible to do this so that the first error is not ignored.

Yeah that also seems reasonable to me, we could have reach into internals if necessary.
Right, is just an implementation detail of , so if BW is not giving LW the information it needs, unless there's some more fundamental reason LW can't be implemented as specified, LW's implementation should just change.
Oh, it turns out my hunch was wrong. inherently needs to do and then on the underlying writer. If the succeeds, we have to ignore errors from .
I've opened a PR as