Convert README to AsciiDoc

This commit is contained in:
Přemysl Eric Janouch 2015-09-27 01:58:45 +02:00
parent ddf99cfc2b
commit 06bff9cb8f

View File

@ -1,7 +1,8 @@
json-rpc-shell json-rpc-shell
============== ==============
:compact-option:
`json-rpc-shell' is a simple shell for running JSON-RPC 2.0 queries. 'json-rpc-shell' is a simple shell for running JSON-RPC 2.0 queries.
This software has been created as a replacement for the following shell, which This software has been created as a replacement for the following shell, which
is written in Java: http://software.dzhuvinov.com/json-rpc-2.0-shell.html is written in Java: http://software.dzhuvinov.com/json-rpc-2.0-shell.html
@ -14,7 +15,7 @@ Supported transports
- WebSocket over TLS - WebSocket over TLS
WebSockets WebSockets
---------- ~~~~~~~~~~
The WebSocket transport is rather experimental. As the JSON-RPC 2.0 spec The WebSocket transport is rather experimental. As the JSON-RPC 2.0 spec
doesn't say almost anything about the underlying transports, I'll shortly doesn't say almost anything about the underlying transports, I'll shortly
describe the way it's implemented: every request is sent as a single text describe the way it's implemented: every request is sent as a single text
@ -27,7 +28,7 @@ the higher-level protocol (the "Sec-Ws-Protocol" HTTP field).
Building and Running Building and Running
-------------------- --------------------
Build dependencies: CMake, pkg-config, help2man, Build dependencies: CMake, pkg-config, help2man,
liberty (included), http-parser (included) liberty (included), http-parser (included) +
Runtime dependencies: libev, Jansson, cURL, readline, openssl Runtime dependencies: libev, Jansson, cURL, readline, openssl
$ git clone --recursive https://github.com/pjanouch/json-rpc-shell.git $ git clone --recursive https://github.com/pjanouch/json-rpc-shell.git
@ -37,16 +38,18 @@ Runtime dependencies: libev, Jansson, cURL, readline, openssl
$ make $ make
To install the application, you can do either the usual: To install the application, you can do either the usual:
# make install # make install
Or you can try telling CMake to make a package for you. For Debian it is: Or you can try telling CMake to make a package for you. For Debian it is:
$ cpack -G DEB $ cpack -G DEB
# dpkg -i json-rpc-shell-*.deb # dpkg -i json-rpc-shell-*.deb
Note that for versions of CMake before 2.8.9, you need to prefix cpack with Note that for versions of CMake before 2.8.9, you need to prefix `cpack` with
`fakeroot' or file ownership will end up wrong. `fakeroot` or file ownership will end up wrong.
Run the program with `--help' to obtain usage information. Run the program with `--help` to obtain usage information.
Contributing and Support Contributing and Support
------------------------ ------------------------
@ -56,7 +59,7 @@ the developer, feel free to join me at irc://anathema.irc.so, channel #anathema.
License License
------- -------
`json-rpc-shell' is written by Přemysl Janouch <p.janouch@gmail.com>. 'json-rpc-shell' 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 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 is included within the package, or, at your option, you may relicense the work