From 0cdbe2ff5952f224dd4a2dfd9ac3702159ec8f7f Mon Sep 17 00:00:00 2001 From: Dustin Kirkland Date: Thu, 1 Nov 2012 15:13:58 +0100 Subject: [PATCH] * usr/share/man/man1/byobu.1: LP: #1059237 - document that you can copy status scripts to ~/.byobu/bin and modify them locally --- debian/changelog | 3 +++ usr/share/man/man1/byobu.1 | 3 ++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/debian/changelog b/debian/changelog index e33e0e69..815a155c 100644 --- a/debian/changelog +++ b/debian/changelog @@ -24,6 +24,9 @@ byobu (5.22) unreleased; urgency=low * usr/lib/byobu/include/constants: LP: #1068580 - test for the sed --follow-symlink option and only use it when available + * usr/share/man/man1/byobu.1: LP: #1059237 + - document that you can copy status scripts to ~/.byobu/bin and + modify them locally [ Jake Biesinger and Dustin Kirkland ] * usr/share/byobu/keybindings/common, usr/share/byobu/keybindings/f- diff --git a/usr/share/man/man1/byobu.1 b/usr/share/man/man1/byobu.1 index db543071..3c13f129 100644 --- a/usr/share/man/man1/byobu.1 +++ b/usr/share/man/man1/byobu.1 @@ -37,11 +37,12 @@ The background colors of the \fBbyobu\fP status lines can be adjusted by editing \fBcpu_temp\fP \- the cpu temperature in Celsius (default) or Fahrenheit, configure TEMP=F or TEMP=C in \fI$BYOBU_CONFIG_DIR/statusrc\fP; displayed in the lower bar toward the right in yellow text on a black background; you may override the detected cpu temperature device by setting MONITORED_TEMP=/proc/acpi/whatever in \fI$BYOBU_CONFIG_DIR/statusrc\fP -\fBcustom\fP \- user defined custom scripts; must be executable programs of any kind in \fI$BYOBU_CONFIG_DIR/bin\fP; must be named N_NAME, where N is the frequency in seconds to refresh the status indicator, and NAME is the name of the script; N should not be less than 5 seconds; the script should echo a small amount of text to standard out, standard error is discarded; the indicator will be displayed in the lower panel, in default colors, unless you manually specify the colors in your script's output; BEWARE, cpu-intensive custom scripts may impact your overall system performance and could upset your system administrator! +\fBcustom\fP \- user defined custom scripts; must be executable programs of any kind in \fI$BYOBU_CONFIG_DIR/bin\fP; must be named N_NAME, where N is the frequency in seconds to refresh the status indicator, and NAME is the name of the script; N should not be less than 5 seconds; the script should echo a small amount of text to standard out, standard error is discarded; the indicator will be displayed in the lower panel, in default colors, unless you manually specify the colors in your script's output; BEWARE, cpu-intensive custom scripts may impact your overall system performance and could upset your system administrator! In fact, you can easily copy and modify \fBany\fP status script usually found in \fI/usr/lib/byobu/*\fP to your local \fI$HOME/.byobu/\fP directory. Example: \fI$BYOBU_CONFIG_DIR/bin/1000_uname\fP #!/bin/sh printf "\\005{= bw}%s\\005{\-}" "$(uname \-r)" + \fBdate\fP \- the system date in YYYY-MM-DD formate; displayed in the lower on the far right in the default text color on the default background \fBdisk\fP \- total disk space available and total used on / directory; displayed in the lower bar on the far right in white text on a light purple background; override the default directory by specifying an alternate mount point with MONITORED_DISK=/wherever in \fI$BYOBU_CONFIG_DIR/statusrc\fP