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 --- Makefile | 16 ++++++++++- README | 2 +- doc/man/xpybar.1 | 83 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 99 insertions(+), 2 deletions(-) create mode 100644 doc/man/xpybar.1 diff --git a/Makefile b/Makefile index 6038511..b985c80 100644 --- a/Makefile +++ b/Makefile @@ -5,6 +5,8 @@ EXAMPLE = /share BINDIR = $(PREFIX)$(BIN) DATADIR = $(PREFIX)$(DATA) EXAMPLEDIR = $(PREFIX)$(EXAMPLE) +MANDIR = $(DATADIR)/man +MAN1DIR = $(MANDIR)/man1 LICENSEDIR = $(DATADIR)/licenses PY3_SHEBANG = "/usr/bin/env python3" @@ -73,7 +75,10 @@ obj/%.o: src/%.c .PHONY: install -install: install-base +install: install-base install-doc + +.PHONY: install-all +install-all: install-base install-man .PHONY: install-base install-base: install-command install-license install-all-examples install-plugins @@ -112,6 +117,14 @@ install-plugins: $(foreach F,$(PLUGINS),src/plugins/$(F).py) install -dm755 -- "$(DESTDIR)$(EXAMPLEDIR)/$(PKGNAME)/plugins" install -m644 $^ -- "$(DESTDIR)$(EXAMPLEDIR)/$(PKGNAME)/plugins" +.PHONY: install-doc +install-doc: install-man + +.PHONY: install-man +install-man: doc/man/xpybar.1 + install -dm755 -- "$(DESTDIR)$(MAN1DIR)" + install -m644 $< -- "$(DESTDIR)$(MAN1DIR)/$(COMMAND).1" + .PHONY: uninstall @@ -132,6 +145,7 @@ uninstall: -rm -- $(foreach F,$(PLUGINS),"$(DESTDIR)$(DATADIR)/$(PKGNAME)/plugins/$(F)") -rmdir -- "$(DESTDIR)$(DATADIR)/$(PKGNAME)/plugins" -rmdir -- "$(DESTDIR)$(DATADIR)/$(PKGNAME)" + -rm -- "$(DESTDIR)$(MAN1DIR)/$(COMMAND).1" diff --git a/README b/README index c499795..8576e1a 100644 --- a/README +++ b/README @@ -2,7 +2,7 @@ NAME xpybar - A highly extensible minimalistic dock panel configured in Python 3 SYNOPSIS - xpybar - [OPTION]... [-- CONFIGURATION_OPTION...] + xpybar [OPTION]... [-- CONFIGURATION_OPTION...] DESCRIPTION xpybar is a minimalistic dock panel with high extensibility. 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