Update readme, add it to distribution.

This commit is contained in:
Qball Cow 2014-03-18 08:40:23 +01:00
parent 6505962498
commit 7ec4bc8d4e
2 changed files with 38 additions and 8 deletions

View File

@ -37,9 +37,16 @@ rofi_SOURCES=\
man1_MANS=\ man1_MANS=\
doc/rofi.1 doc/rofi.1
##
# Readme.md
##
markdown_FILES=\
README.md
## ##
# Extra DIST # Extra DIST
## ##
EXTRA_DIST=\ EXTRA_DIST=\
$(man1_MANS) $(man1_MANS)\
$(markdown_FILES)

View File

@ -4,11 +4,14 @@ A popup window switcher roughly based on [superswitcher](http://code.google.com/
This version is based on the version from [Sean This version is based on the version from [Sean
Pringle](http://github.com/seanpringle/simpleswitcher). All credit for this great tool should go to him. Pringle](http://github.com/seanpringle/simpleswitcher). All credit for this great tool should go to him.
Some of the features of rofi are:
* Switcher centered on screen (or monitor for multi-head). * Switcher centered on screen (or monitor for multi-head).
* Vertical list with two columns: * Vertical list with two columns:
1. Window class. 1. Desktop number (optional, not shown in i3 mode)
2. Window title. 2. Window class.
3. Window title.
* Controls like dmenu: * Controls like dmenu:
* Type to filter windows. * Type to filter windows.
@ -22,9 +25,15 @@ Pringle](http://github.com/seanpringle/simpleswitcher). All credit for this grea
* Arrows to highlight selections. * Arrows to highlight selections.
* Return to select. * Return to select.
* Shift-Return to run in terminal. * Shift-Return to run in terminal.
* Favorites list.
* Quickly ssh into remote machines
* Parses ~/.ssh/config to find hosts.
* Runs in background or once-off. * Runs in background or once-off.
* Drop in dmenu replacement.
If compiled with I3 support, it should autodetect if I3 window manager is running. If compiled with I3 support, it should autodetect if I3 window manager is running.
Usage Usage
@ -42,16 +51,30 @@ Type '?' (enter) to switch from Window list mode to Run mode and back.
Compilation Compilation
----------- -----------
If compiling from GIT, first run to generate the needed build files:
autoreconf --install autoreconf --install
./configure
To build rofi, run the following steps:
mkdir build/
cd build/
../configure
make make
make install make install
Type `make I3=` to disable compiling with i3 support. The build system will autodetect the i3 header file during compilation. If it fails, make sure you
If during compilation it complains about not finding i3/ipc.h either disable i3 support have i3/ipc.h installed. Check config.log for more information.
or install the headers.
Type `make PREFIX=<path> install` to install in a different prefix. Dependencies
------------
Rofi requires the following tools and libraries to be installed:
* libx11
* libxinerama
* libxdg-basedir
* libxft
Archlinux Archlinux
--------- ---------