From f8c13b0571b4d2fe2183c2c9894fd4991cf6a96a Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Fri, 27 Nov 2015 05:31:51 +0100 Subject: add makefile MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- doc/man/xpybar.1 | 83 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 doc/man/xpybar.1 (limited to 'doc') diff --git a/doc/man/xpybar.1 b/doc/man/xpybar.1 new file mode 100644 index 0000000..a82a17f --- /dev/null +++ b/doc/man/xpybar.1 @@ -0,0 +1,83 @@ +.TH XPYBAR 1 XPYBAR +.SH NAME +xpybar - A highly extensible minimalistic dock panel configured in Python 3 +.SH SYNOPSIS +.BR xpybar +.IR "" [ OPTION ]... +[\-\- +.IR CONFIGURATION_OPTION ...] +.SH DESCRIPTION +.BR 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 +.BR xpybar +is written in Python. +.PP +.BR 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 . +.PP +The configuration script must be written in Python 3, +it will be loaded as part of the +.BR xpybar 's +source code itself. +.IR CONFIGURATION_OPTION +will be available to the configuration script via the +variable \fBconfig_file\fP, which is a list. +.SH OPTIONS +.TP +.BR \-c ,\ \-\-configurations \ \fIFILE\fP +Select configuration script. If not used, the program +will search for a file named \fIxpybarrc\fP or \fI.xpybarrc\fP +(depending on the directory) in the usual configuration +directories. +.TP +.BR \-h ,\ \-? ,\ \-\-help +Print this help information. +.TP +.BR \-v ,\ \-\-version +Print program name and version. +.TP +.BR \-C ,\ \-\-copying ,\ \-\-copyright +Print copyright information. +.TP +.BR \-W ,\ \-\-warranty +Print non-warranty information. +.SH RATIONALE +There are a lot of panel projects, too many for me to +have tried all of them. +.BR xpybar +is intended to replace +.BR dzen2 , +.BR xmobar , +and eventually +.BR mate-panel , +for me, with one single panel. This makes it ease to +pack data into a much smaller space. +.BR xpybar +is also designed to be easier to extend and customise than +.BR xmobar , +in a language understood by more users. +.SH "SEE ALSO" +.BR dmenu (1), +.BR stlarch_icons +.SH AUTHORS +Principal author, Mattias Andrée. See the COPYING file for the full +list of authors. +.SH LICENSE +Copyright \(co 2013, 2015 Mattias Andrée +.br +License GPLv3+: GNU GPL version 3 or later , and +License AGPLv3+: GNU AGPL version 3 or later . +.br +This is free software: you are free to change and redistribute it. +.br +There is NO WARRANTY, to the extent permitted by law. +.SH BUGS +Please report bugs to https://github.com/maandree/xpybar/issues or to +maandree@member.fsf.org -- cgit v1.2.3-70-g09d2