diff --git a/.gitignore b/.gitignore index 519ae3a..01a163f 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,4 @@ -config.h -bar +lemonbar *.o *.swp *~ diff --git a/.travis.yml b/.travis.yml index be842ec..fb22eea 100644 --- a/.travis.yml +++ b/.travis.yml @@ -3,5 +3,6 @@ compiler: - clang - gcc before_install: - - sudo apt-get install -qq libx11-xcb-dev libxcb-randr0-dev libxcb-xinerama0-dev + - sudo apt-get update -qq + - sudo apt-get install -y libx11-xcb-dev libxcb-randr0-dev libxcb-xinerama0-dev script: make diff --git a/README.pod b/README.pod index afbed83..dc7307a 100644 --- a/README.pod +++ b/README.pod @@ -6,7 +6,7 @@ lemonbar - Featherweight lemon-scented bar =head1 SYNOPSIS -I [-h | -g IBIB<+>IB<+>I | -b | -d | -f I | -p | -u I | -B I | -F I] +I [-h | -g IBIB<+>IB<+>I | -b | -d | -f I | -p | -n I | -u I | -B I | -F I | -U I] =head1 DESCRIPTION @@ -34,29 +34,42 @@ Force docking without asking the window manager. This is needed if the window ma =item B<-f> I -Comma separated list of fonts, lemonbar supports a maximum of five fonts (the limit can be tweaked by changing the MAX_FONT_COUNT parameter in the source). +Define the font to load into one of the five slots (the number of slots is hardcoded and can be tweaked by +changing the MAX_FONT_COUNT parameter in the source code). + +=item B<-a> I + +Set number of clickable areas (default is 10) =item B<-p> Make the bar permanent, don't exit after the standard input is closed. +=item B<-n> I + +Set the WM_NAME atom value for the bar. + =item B<-u> I Sets the underline width in pixels. The default is 1. =item B<-B> I -Set the background color of the bar. I might be either in hex format (#aarrggbb) or in the symbolic name format (eg. white, indianred, darkgray). If no compositor such as compton or xcompmgr is running the alpha channel is silently ignored. +Set the background color of the bar. I must be specified in the hex format (#aarrggbb, #rrggbb, #rgb). If no compositor such as compton or xcompmgr is running the alpha channel is silently ignored. =item B<-F> I Set the foreground color of the bar. Accepts the same color formats as B<-B>. +=item B<-U> I + +Set the underline color of the bar. Accepts the same color formats as B<-B>. + =back =head1 FORMATTING -lemonbar provides a screenrc-inspired formatting syntax to allow full customization at runtime. Every formatting block is opened with B<%{> and closed by B<}> and accepts the following commands, the parser tries it's best to handle malformed input. +lemonbar provides a screenrc-inspired formatting syntax to allow full customization at runtime. Every formatting block is opened with C<%{> and closed by C<}> and accepts the following commands, the parser tries it's best to handle malformed input. Use C<%%> to get a literal percent sign (C<%>). =over @@ -86,7 +99,7 @@ Set the text foreground color. The parameter I can be I<-> or a color in =item BI -Set the font used to draw the following text. The parameter I is a 1-based index of the font list supplied to bar. Any other value (for example I<->) resets the bar to normal behaviour (matching the first font that can be used for that character). If the selected font can't be used to draw a character, lemonbar will fall back to normal behaviour for that character. +Set the font used to draw the following text. The parameter I can either be I<-> or the 1-based index of the slot which contains the desired font. If the parameter is I<-> lemonbar resets to the normal behavior (matching the first font that can be used for the character). If the selected font can't be used to draw a character, lemonbar will fall back to normal behavior for that character =item BI @@ -94,7 +107,7 @@ Set the text underline color. The parameter I can be I<-> or a color in o =item BI