From c31966b0c47cf539d1459d131eac6044f78269a6 Mon Sep 17 00:00:00 2001 From: Přemysl Janouch Date: Sun, 27 Sep 2015 02:08:32 +0200 Subject: Convert README to AsciiDoc --- README.adoc | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ README.rst | 60 ------------------------------------------------------------ 2 files changed, 56 insertions(+), 60 deletions(-) create mode 100644 README.adoc delete mode 100644 README.rst diff --git a/README.adoc b/README.adoc new file mode 100644 index 0000000..88dd471 --- /dev/null +++ b/README.adoc @@ -0,0 +1,56 @@ +autistdraw +========== + +'autistdraw' is a terminal drawing application with multiplayer support. + +image::http://www.image-share.com/upload/2848/201.png[screenshot] + +Building and Running +-------------------- +Build dependencies: CMake, pkg-config, liberty (included), termo (included) + +Runtime dependencies: ncursesw, libev + + $ git clone --recursive https://github.com/pjanouch/autistdraw.git + $ mkdir autistdraw/build + $ cd autistdraw/build + $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug + $ make + +Now, for standalone mode you can run: + + $ ./autistdraw + +To run as a server for other clients to connect to and draw simultaneously: + + $ ./autistdraw -s :1234 + +Finally, to connect to a running server, run: + + $ ./autistdraw -c localhost:1234 + +Usage +----- +Simply select a colour you like from the palette and draw by clicking and +dragging the mouse. Use the middle mouse button to move the canvas. + +Known Issues +------------ +VTE-based terminals, such as gnome-terminal, are terminally broken and you will +experience drawing artefacts. Those are neither a problem of this application, +nor a problem of ncurses as far as I can tell. + +To achieve the best results, please use a decent terminal such as rxvt-unicode +or xterm. These two are feature-full and *fast*. st also works great. + +Even so, try not to strain the application too much. It can and will break if +you flood the communication channel with the terminal. + +License +------- +'autistdraw' is written by Přemysl Janouch . + +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 diff --git a/README.rst b/README.rst deleted file mode 100644 index e248a71..0000000 --- a/README.rst +++ /dev/null @@ -1,60 +0,0 @@ -autistdraw -========== - -`autistdraw` is a terminal drawing application with multiplayer support. - -.. image:: http://www.image-share.com/upload/2848/201.png - -Building and Running --------------------- -| Build dependencies: CMake, pkg-config, liberty (included), termo (included) -| Runtime dependencies: ncursesw, libev - -:: - - $ git clone https://github.com/pjanouch/autistdraw.git - $ git submodule init - $ git submodule update - $ mkdir build - $ cd build - $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug - $ make - -Now, for standalone mode you can run:: - - $ ./autistdraw - -To run as a server for other clients to connect to and draw simultaneously:: - - $ ./autistdraw -s :1234 - -Finally, to connect to a running server, run:: - - $ ./autistdraw -c localhost:1234 - -Usage ------ -Simply select a colour you like from the palette and draw by clicking and -dragging the mouse. Use the middle mouse button to move the canvas. - -Known Issues ------------- -VTE-based terminals, such as gnome-terminal, are terminally broken and you will -experience drawing artefacts. Those are neither a problem of this application, -nor a problem of ncurses as far as I can tell. - -To achieve the best results, please use a decent terminal such as rxvt-unicode -or xterm. These two are feature-full and **fast**. st also works great. - -Even so, try not to strain the application too much. It can and will break if -you flood the communication channel with the terminal. - -License -------- -`autistdraw` is written by Přemysl Janouch . - -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 -- cgit v1.2.3-70-g09d2