aboutsummaryrefslogtreecommitdiff
path: root/README.adoc
diff options
context:
space:
mode:
authorPřemysl Janouch <p.janouch@gmail.com>2015-09-27 01:48:07 +0200
committerPřemysl Janouch <p.janouch@gmail.com>2015-09-27 01:48:07 +0200
commit7696d0fa923b54856c2cdc8da6e2daffab174089 (patch)
tree52641e1d1fd1e99950bb6d05c8489ed614acca68 /README.adoc
parentf7b5641ee2a20a4d1473db47e7ad29b021d57217 (diff)
downloadrazer-bw-te-ctl-7696d0fa923b54856c2cdc8da6e2daffab174089.tar.gz
razer-bw-te-ctl-7696d0fa923b54856c2cdc8da6e2daffab174089.tar.xz
razer-bw-te-ctl-7696d0fa923b54856c2cdc8da6e2daffab174089.zip
Convert README to AsciiDoc
Diffstat (limited to 'README.adoc')
-rw-r--r--README.adoc49
1 files changed, 49 insertions, 0 deletions
diff --git a/README.adoc b/README.adoc
new file mode 100644
index 0000000..ee18b70
--- /dev/null
+++ b/README.adoc
@@ -0,0 +1,49 @@
+razer-bw-te-ctl
+===============
+
+This program makes it possible to change the configuration of your Razer
+BlackWidow Tournament Edition keybooard from within Linux, *BSD or any other
+POSIX-compatible system supported by libusb.
+
+Make sure to let the Windows Razer Synapse tool upgrade the firmware to the
+newest version before running the program. There might be some issues otherwise
+due to protocol changes, although I don't really deem it very probable.
+
+Run `razer-bw-te-ctl --help` or `man razer-bw-te-ctl` for usage information.
+
+Installation
+------------
+Build dependencies: cmake >= 2.8.5, help2man +
+Runtime dependencies: libusb >= 1.0
+
+ $ git clone git://github.com/pjanouch/razer-bw-te-ctl.git
+ $ mkdir razer-bw-te-ctl/build
+ $ cd razer-bw-te-ctl/build
+ $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr
+ # make install
+
+Note that there's no `make uninstall`.
+
+For Debian-based distros, you can do the following instead of the last step:
+
+ $ cpack -G DEB
+ # dpkg -i razer-bw-te-ctl-*.deb
+
+Note that for versions of CMake before 2.8.9, you need to prefix `cpack` with
+`fakeroot` or file ownership will end up wrong.
+
+Contributing and Support
+------------------------
+Use this project's GitHub to report any bugs, request features, or submit pull
+requests. If you want to discuss this project, or maybe just hang out with
+the developer, feel free to join me at irc://anathema.irc.so, channel #anathema.
+
+License
+-------
+'razer-bw-te-ctl' is written by Přemysl Janouch <p.janouch@gmail.com>.
+
+You may use the software under the terms of the ISC license, the text of which
+is included within the package, or, at your option, you may relicense the work
+under the MIT or the Modified BSD License, as listed at the following site:
+
+http://www.gnu.org/licenses/license-list.html