1bup-newliner(1)                                                bup-newliner(1)
2
3
4

NAME

6       bup-newliner - make sure progress messages don't overlap with output
7

SYNOPSIS

9       <any command> 2>&1 | bup newliner
10

DESCRIPTION

12       bup newliner is run automatically by bup.  You shouldn't need it unless
13       you're using it in some other program.
14
15       Progress messages emitted by bup (and some other tools) are of the form
16       “Message  ###  content\r”, that is, a status message containing a vari‐
17       able-length number, followed by a carriage return character and no new‐
18       line.   If  these  messages  are printed more than once, they overwrite
19       each other, so what the user sees is a single line  with  a  continual‐
20       ly-updating number.
21
22       This  works  fine  until  some  other message is printed.  For example,
23       progress messages are usually printed to stderr, but other program mes‐
24       sages  might  be printed to stdout.  If those messages are shorter than
25       the progress message line, the screen will be left with  weird  looking
26       artifacts as the two messages get mixed together.
27
28       bup newliner  prints  extra  space characters at the right time to make
29       sure that doesn't happen.
30
31       If you're running a program that has problems with these artifacts, you
32       can  usually  fix  them by piping its stdout and its stderr through bup
33       newliner.
34

BUP

36       Part of the bup(1) suite.
37

AUTHORS

39       Avery Pennarun <apenwarr@gmail.com>.
40
41
42
43Bup 0.29.2                        2018-10-20                   bup-newliner(1)