From 231d3152cc01cc242f5f5eba708992c8fba26479 Mon Sep 17 00:00:00 2001 From: Victor Häggqvist Date: Tue, 2 Feb 2016 20:18:49 +0100 Subject: rst readme and man page --- docs/_build/man/goboom.1 | 155 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 155 insertions(+) create mode 100644 docs/_build/man/goboom.1 (limited to 'docs/_build/man') diff --git a/docs/_build/man/goboom.1 b/docs/_build/man/goboom.1 new file mode 100644 index 0000000..649a010 --- /dev/null +++ b/docs/_build/man/goboom.1 @@ -0,0 +1,155 @@ +.\" Man page generated from reStructuredText. +. +.TH "GOBOOM" "1" "February 02, 2016" "0.1" "goboom" +.SH NAME +goboom \- a dmenu wrapper +. +.nr rst2man-indent-level 0 +. +.de1 rstReportMargin +\\$1 \\n[an-margin] +level \\n[rst2man-indent-level] +level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] +- +\\n[rst2man-indent0] +\\n[rst2man-indent1] +\\n[rst2man-indent2] +.. +.de1 INDENT +.\" .rstReportMargin pre: +. RS \\$1 +. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] +. nr rst2man-indent-level +1 +.\" .rstReportMargin post: +.. +.de UNINDENT +. RE +.\" indent \\n[an-margin] +.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] +.nr rst2man-indent-level -1 +.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] +.in \\n[rst2man-indent\\n[rst2man-indent-level]]u +.. +.SH SYNOPSIS +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +goboom [option] + +goobom_run +.ft P +.fi +.UNINDENT +.UNINDENT +.SH DESCRIPTION +.sp +goboom is wrapper around the dmenu. +goboom is the successor and rewrite of xboomx in Go. +.sp +goboom sorts commands to launch according to their launch frequency. +In other words \- if you launch Chromium and KeePassX all the time \- they will appear in the list of commands first. +.SS Build +.sp +goboom is built using Go 1.5 vendoring and godeps. +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +export GO15VENDOREXPERIMENT=1 +godep get github.com/victorhaggqvist/goboom +go build goboom.go +.ft P +.fi +.UNINDENT +.UNINDENT +.SS Install +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +sudo cp goboom /usr/bin +sudo cp goboom_run /usr/bin +mkdir \-p ~/.goboom +cp config.ini.default ~/.goboom/config.ini +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +Set your keybinding to \fIgoboom_run\fP\&. +.SH OPTIONS +.INDENT 0.0 +.TP +.B \-\-gc +Run garbage collection of the DB +.TP +.B \-\-launcher +Output launcher command +.TP +.B \-\-post +Update ranking DB +.TP +.B \-\-pre +Generate dmenu in +.TP +.B \-\-stats +View DB stats +.UNINDENT +.SH MIGRATION FROM XBOOMX +.sp +goboom will look for a config file in \fI~/.goboom\fP\&. +You will need to will need to convert you old config file to ini\-format and name it \fIconfig.ini\fP, see the bundled default ini\-file for guidence. +.sp +goboom uses a csv\-file instead sqlite as datastore. +You will need to export your xboomx db as so. +At this point there is not a provided tool to do so, but you can easely export it with something like \fI\%sqlitebrowser\fP <\fBhttp://sqlitebrowser.org/\fP>\&. +.sp +The contents of your exported database should look along the lines of this: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +name,count +chroimum,13 +keepassx,17 +gimp,4 +.ft P +.fi +.UNINDENT +.UNINDENT +.SH LICENSE +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +goboom \- a dmenu wrapper +Copyright (C) 2016 Victor Häggqvist + +This program is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation, either version 3 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program. If not, see . +.ft P +.fi +.UNINDENT +.UNINDENT +.SH AUTHOR +Victor Häggqvist +.SH COPYRIGHT +2016, Victor Häggqvist +.\" Generated by docutils manpage writer. +. -- cgit v1.2.3