diff options
| author | Finn Behrens <me@kloenk.dev> | 2024-06-01 16:06:26 +0200 |
|---|---|---|
| committer | Finn Behrens <me@kloenk.dev> | 2024-06-22 14:20:27 +0200 |
| commit | da4e46dd1fc04067b5ba4bc16dd68134fa7efad2 (patch) | |
| tree | de928e67208328cac91b1afb8ce368918f0b8266 /doc | |
| parent | 21865ccce0a5bf6edcb98a09b57b3f076ee9ba9f (diff) | |
libmain: add progress bar with multiple status lines
Add the log-formats `multiline` and `multiline-with-logs` which offer
multiple current active building status lines.
Change-Id: Idd8afe62f8591b5d8b70e258c5cefa09be4cab03
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/manual/change-authors.yml | 4 | ||||
| -rw-r--r-- | doc/manual/rl-next/multiline-log-format.md | 14 | ||||
| -rw-r--r-- | doc/manual/src/command-ref/opt-common.md | 10 |
3 files changed, 28 insertions, 0 deletions
diff --git a/doc/manual/change-authors.yml b/doc/manual/change-authors.yml index c56f588ca..5a7b8117e 100644 --- a/doc/manual/change-authors.yml +++ b/doc/manual/change-authors.yml @@ -60,6 +60,10 @@ jade: forgejo: jade github: lf- +kloenk: + forgejo: kloenk + github: kloenk + lovesegfault: github: lovesegfault diff --git a/doc/manual/rl-next/multiline-log-format.md b/doc/manual/rl-next/multiline-log-format.md new file mode 100644 index 000000000..62bb9f1e7 --- /dev/null +++ b/doc/manual/rl-next/multiline-log-format.md @@ -0,0 +1,14 @@ +--- +synopsis: Add log formats `multiline` and `multiline-with-logs` +cls: [1369] +credits: [kloenk] +category: Improvements +--- + +Added two new log formats (`multiline` and `multiline-with-logs`) that display +current activities below each other for better visibility. + +These formats attempt to use the maximum available lines +(defaulting to 25 if unable to determine) and print up to that many lines. +The status bar is displayed as the first line, with each subsequent +activity on its own line. diff --git a/doc/manual/src/command-ref/opt-common.md b/doc/manual/src/command-ref/opt-common.md index cd289b7ea..7740da953 100644 --- a/doc/manual/src/command-ref/opt-common.md +++ b/doc/manual/src/command-ref/opt-common.md @@ -78,6 +78,16 @@ Most commands in Lix accept the following command-line options: Display the raw logs, with the progress bar at the bottom. + - `multiline` + + Display a progress bar during the builds and in the lines below that one line per activity. + + + - `multiline-with-logs` + + Displayes the raw logs, with a progress bar and activities each in a new line at the bottom. + + - <span id="opt-no-build-output">[`--no-build-output`](#opt-no-build-output)</span> / `-Q` By default, output written by builders to standard output and standard error is echoed to the Lix command's standard error. |