From 75a265b4d8e0afc2c531dd2b3f83bcf30e77dda7 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Fri, 27 Nov 2015 03:28:28 +0100 Subject: improved readme MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- README | 62 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 61 insertions(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index 70b88e5..c499795 100644 --- a/README +++ b/README @@ -1 +1,61 @@ -A highly extensible minimalistic dock panel configured in Python 3 +NAME + xpybar - A highly extensible minimalistic dock panel configured in Python 3 + +SYNOPSIS + xpybar - [OPTION]... [-- CONFIGURATION_OPTION...] + +DESCRIPTION + xpybar is a minimalistic dock panel with high extensibility. + It is source code is designed so that all parts of it can + be replaced by a configuration script. This is one of the + reasons xpybar is written in Python. + + xpybar itself is very small, but it comes with a large array + of extensions (installed to ). The + extensions come with associated configuration script examples + (installed to .) There are + some additional examples in . + + The configuration script must be written in Python 3, + it will be loaded as part of the xpybar's source code itself. + CONFIGURATION_OPTION will be available to the configuration + script via the variable config_file, which is a list. + +OPTIONS + -c + --configurations FILE + Select configuration script. If not used, the program + will search for a file named xpybarrc or .xpybarrc + (depending on the directory) in the usual configuration + directories. + + -h + -? + --help + Print this help information. + + -v + --version + Print program name and version. + + -C + --copying + --copyright + Print copyright information. + + -W + --warranty + Print non-warranty information. + +RATIONALE + There are a lot of panel projects, too many for me to + have tried all of them. xpybar is intended to replace + dzen2, xmobar, and eventually mate-panel, for me, with + one single panel. This makes it ease to pack data into + a much smaller space. xpybar is also designed to be + easier to extend and customise than xmobar, in a language + understood by more users. + +SEE ALSO + dmenu(1), stlarch_icons + -- cgit v1.2.3-70-g09d2